89 lines
3.9 KiB
Markdown
89 lines
3.9 KiB
Markdown
# Task Plan: 沉淀 cc-web 主题创作 Skill
|
||
|
||
## Goal
|
||
|
||
在 `.codex/skills/create-cc-web-theme/` 创建可复用的项目级 Skill，沉淀暗金荒野主题的设计方法、切图流程、实现边界、失败教训与视觉验收标准，供后续其他主题直接复用。
|
||
|
||
## Current Phase
|
||
|
||
Complete
|
||
|
||
## Phases
|
||
|
||
### Phase 1: 梳理现有主题实现与反馈教训
|
||
|
||
- [x] 审阅主题任务资料、切图脚本、关键 CSS/JS 与回归测试
|
||
- [x] 提炼反复返工的根因和有效修正方法
|
||
- [x] 将发现写入 findings.md
|
||
- **Status:** complete
|
||
|
||
### Phase 2: 设计可复用 Skill 结构和触发边界
|
||
|
||
- [x] 明确触发语句与适用范围
|
||
- [x] 区分核心工作流、详细参考和确定性脚本
|
||
- [x] 完成计划独立审查
|
||
- **Status:** complete
|
||
|
||
### Phase 3: 初始化项目级本地 Skill
|
||
|
||
- [x] 使用 skill-creator 初始化脚本创建目录
|
||
- [x] 生成符合规范的 agents/openai.yaml
|
||
- [x] 确认模板占位内容待 Phase 4 全量替换
|
||
- **Status:** complete
|
||
|
||
### Phase 4: 编写核心工作流与经验参考
|
||
|
||
- [x] 编写 SKILL.md 核心执行流程
|
||
- [x] 编写经验教训、资产切分和视觉验收参考
|
||
- [x] 保持资源单层引用与内容不重复
|
||
- **Status:** complete
|
||
|
||
### Phase 5: 验证 Skill 规范并进行前向测试
|
||
|
||
- [x] 运行 quick_validate.py
|
||
- [x] 检查文件引用、触发描述和脚本可执行性
|
||
- [x] 使用隔离子代理执行只读前向测试并吸收反馈
|
||
- **Status:** complete
|
||
|
||
### Phase 6: 汇总交付并清理任务清单
|
||
|
||
- [x] 完成最终差异检查
|
||
- [x] 更新 planning-with-files 记录
|
||
- [x] 清理临时 TODO CSV 并交付路径与用法
|
||
- **Status:** complete
|
||
|
||
## Key Questions
|
||
|
||
1. 哪些经验属于所有主题都适用的强约束，哪些只属于暗金荒野案例？
|
||
2. 哪些步骤值得固化为脚本，哪些应保留为可判断的工作流？
|
||
3. 如何确保未来主题不会覆盖现有主题、误删参考素材或只凭回归测试代替视觉验收？
|
||
|
||
## Decisions Made
|
||
|
||
| Decision | Rationale |
|
||
|----------|-----------|
|
||
| Skill 放在 `.codex/skills/create-cc-web-theme/` | 用户明确指定项目级 `.codex/skills`，可随仓库复用 |
|
||
| 使用 `create-cc-web-theme` 作为名称 | 符合小写连字符和动词优先的命名规范，触发意图清晰 |
|
||
| 使用 SKILL.md + references，按需要再增加 scripts | 保持核心上下文精简，把案例细节按需加载 |
|
||
| 不复制或移动现有主题素材 | 用户要求保留概念图、素材板和切片，Skill 只引用其方法与位置约定 |
|
||
| 计划审查已通过 | 计划覆盖目标路径、触发边界、references、openai.yaml、验证和只读前向测试 |
|
||
| SKILL.md 只保留 7 阶段核心流程 | 保证触发后能立即执行，又不把案例细节全部加载进上下文 |
|
||
| references 拆为 architecture、asset-workflow、lessons-learned、acceptance-checklist | 四类信息使用时机不同，保持一层引用和渐进披露 |
|
||
| 不创建 assets 或通用切片脚本 | Skill 复用现有主题源资产；各主题的切片算法需按素材板专门编写并保留 |
|
||
|
||
## Errors Encountered
|
||
|
||
| Error | Attempt | Resolution |
|
||
|-------|---------|------------|
|
||
| 验证记录补丁合并多个文件且依赖非稳定上下文 | 2 | 恢复逐文件最小补丁并改用稳定表头/固定文本锚点 |
|
||
| 初始误判为 `.agents/skills` | 1 | 用户纠正后改用 `.codex/skills`；错误目录尚未创建 |
|
||
| planning 状态补丁的 JavaScript 模板字符串被反引号截断 | 1 | 改用字符串拼接并移除嵌套反引号后重试 |
|
||
| Phase 4 状态补丁再次误用含反引号的模板字符串 | 2 | 停止使用模板字符串，改用字符串数组构造 |
|
||
| 合并状态补丁依赖了变化中的精确时间戳上下文 | 3 | 拆成逐文件、小上下文补丁后成功同步 |
|
||
|
||
## Notes
|
||
|
||
- 不修改当前 Wasteland/Gilded 主题视觉实现。
|
||
- 不删除任何概念图、素材板、切片或提取脚本。
|
||
- Skill 内容必须能泛化到未来不同美术方向的主题。
|