cs-build-feature

根据 CodeSpring 计划构建功能

引导式交互构建。不要直接开始编写代码——先引导用户完成准备工作，再以可控的方式构建。此技能既会读取计划，也会在构建阶段编辑代码库，因此请谨慎操作。

使用：codespring 技能参考文档（task-workflow.md、prd-management.md、pitfalls.md、codespring-docs.md），以及同级技能 cs-build-create-prd 和 cs-build-create-tasks。

0. 先连接

运行 codespring auth status + codespring status（LOCAL 项目；打印出来）。

1. 访谈——我们要构建什么？

询问用户想构建什么功能。然后读取 CodeSpring 中已有的信息，并用3 条简明要点复述："这是我对我们要构建内容的理解——请确认或更正。" 使用通俗易懂的语言。

2. 准备情况检查——上下文是否充足？

针对目标功能，确认：

• 存在一份工作原理说明，且内容充分。
• 存在Frontend 和 Backend PRD（codespring prds / codespring prd <id>）。
• Backend PRD 实际涵盖共享系统（路由、数据模型、身份验证/RLS、作业/定时任务、存储、支付/额度、环境变量）和依赖关系图。

如果缺少上下文：

• 提议通过 cs-build-create-prd 立即生成 PRD，或
• 告诉用户在 CodeSpring Web 应用中完成，并参照 references/codespring-docs.md 引导他们操作（打开项目 → 功能的 PRD bridge → 添加并生成 Frontend/Backend PRD）。然后说："完成后回来告诉我，"并重新检查。

3. 任务检查——是否有构建计划？

检查 Kanban 中此功能是否有编号任务（codespring tasks --feature <id>）。如果没有，先运行 cs-build-create-tasks。然后引导用户查看看板：在 CodeSpring 中，点击右上角的 Map / Kanban 切换按钮 → 点击 Kanban 查看任务（参见 references/codespring-docs.md）。

4. 构建模式——先询问，不要自行假设

向用户询问两件事：

1. 你想怎么构建？
   • 一次一个任务（控制力更强，每个任务之间都可以审查），或
   • 持续运行一段时间（自主构建一批任务）。
2. 如果选择自主构建：需要多少个并行子 Agent？（1–5 个；最多 5 个）。然后确认每个 Agent 将负责哪些任务。

5. 选择任务并安排顺序

按编号列出该功能的 todo 任务。建议优先处理能最快形成可测试切片的一组任务（先做基础工作/后端，再做依赖它们的 UI）。询问用户现在要处理哪些任务。

6. 防破坏风险防护（重要）

询问："你担心这会破坏哪些现有功能吗？" 如果有：

• 添加明确的 Kanban 检查任务（通过 cs-build-create-tasks 编号），验证构建完成后这些功能仍然正常运行；并且
• 在任务简报中告知每个子 Agent：未经提示，不得修改这些功能所依赖的共享系统（参照 Backend PRD 依赖关系图）。

7. 构建

• 将每个任务移至进行中（codespring task start <id>），实现任务，然后运行 codespring task done <id>。
• 并行构建时，最多启动 N 个子 Agent（上限为 5 个）。为每个 Agent 提供独立完整的任务简报：任务编号 + 描述、复用关系图、"不得触碰"清单，以及防破坏风险防护要求。将可独立并行的任务分配给不同 Agent；有依赖关系的任务按顺序执行。
• 按任务编号汇报进度，方便用户查看看板更新。

8. 收尾

总结已构建的内容、已完成的任务以及剩余工作。建议运行应用/测试，验证可测试切片。功能最终定稿后，建议运行 cs-build-resync-codebase，让 CodeSpring 反映实际构建结果。

如何判断效果良好

• 编写任何代码之前，用户已确认对功能的 3 条要点理解。
• 缺少的 PRD/任务已在构建前补齐（通过应用内操作或同级技能完成）。
• 构建按用户选择的控制方式执行（逐步进行或最多使用 5 个 Agent），优先处理基础工作，并设置明确的防护措施，避免破坏现有功能。