| name | page-codegen |
| description | Page-Codegen 分阶段执行技能,支持 step/auto 两种模式,遵循“原始模板只读、仅修改 AI 副本”。 |
page-codegen 技能说明
目标
将页面胶水代码补全流程拆分为 7 个阶段,按阶段执行与验收,确保质量和可追溯性。
执行模式
1) step 模式(手动分步)
- 用户显式指定阶段:
init / research / api-design / ui-design / integration / validate / deliver
- 仅执行指定阶段,不自动推进下一阶段
2) auto 模式(自动串行)
- 从
init 开始按顺序执行到 deliver
- 每个阶段完成后自动进入下一阶段
- 任一阶段失败时停止自动流程,先在当前阶段修正并复检
最小执行单元
- 最小执行单元为阶段级
- 不允许将阶段拆到更细粒度后“跳阶段交付”
- 阶段未通过不得进入下一阶段
阶段顺序
init:初始化与 AI 副本准备
research:需求与代码研究
api-design:接口与数据逻辑设计
ui-design:UI 组件与交互设计
integration:代码整合与阶段验收
validate:质量校验与评审闭环
deliver:交付说明与收尾
核心约束(最高优先级)
- 原始模板只读:原始静态模板文件禁止修改
- 仅改 AI 副本:所有实现必须落在
.ai.tsx(及必要依赖文件)
- 不生成
final_code.md
- 不落盘
review/*.md 或任何评审报告文件
- 评审必须走项目自研 reviewer/subagent,禁止使用 superpowers reviewer
- 阶段失败必须在当前阶段修正并复检,通过后再继续
阶段完成通用标准
- 本阶段目标已完成
- 涉及代码变更的阶段必须通过项目自研 reviewer/subagent 检查(最终强制门禁在
validate)
- 未引入“禁用工件”(
final_code.md、review/*.md)
- 原始模板保持未修改
文件结构
SKILL.md:总编排与约束
step-init.md
step-research.md
step-api-design.md
step-ui-design.md
step-integration.md
step-validate.md
step-deliver.md