cc-web/.planning/cc-web-theme-creation-skill/task_plan.md

Task Plan: 沉淀 cc-web 主题创作 Skill

Goal

在 .codex/skills/create-cc-web-theme/ 创建可复用的项目级 Skill，沉淀暗金荒野主题的设计方法、切图流程、实现边界、失败教训与视觉验收标准，供后续其他主题直接复用。

Current Phase

Complete

Phases

Phase 1: 梳理现有主题实现与反馈教训

• 审阅主题任务资料、切图脚本、关键 CSS/JS 与回归测试
• 提炼反复返工的根因和有效修正方法
• 将发现写入 findings.md
• Status: complete

Phase 2: 设计可复用 Skill 结构和触发边界

• 明确触发语句与适用范围
• 区分核心工作流、详细参考和确定性脚本
• 完成计划独立审查
• Status: complete

Phase 3: 初始化项目级本地 Skill

• 使用 skill-creator 初始化脚本创建目录
• 生成符合规范的 agents/openai.yaml
• 确认模板占位内容待 Phase 4 全量替换
• Status: complete

Phase 4: 编写核心工作流与经验参考

• 编写 SKILL.md 核心执行流程
• 编写经验教训、资产切分和视觉验收参考
• 保持资源单层引用与内容不重复
• Status: complete

Phase 5: 验证 Skill 规范并进行前向测试

• 运行 quick_validate.py
• 检查文件引用、触发描述和脚本可执行性
• 使用隔离子代理执行只读前向测试并吸收反馈
• Status: complete

Phase 6: 汇总交付并清理任务清单

• 完成最终差异检查
• 更新 planning-with-files 记录
• 清理临时 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 内容必须能泛化到未来不同美术方向的主题。