SuperAPI AI 工具集

story-implement

通用与其它

查看项目

更新于 10-15 23:42

技能介绍

用途:依据 docs/product/user-stories/ 下的用户故事 US-XXX 与任务 TK-XXX 规格,在代码中实现已定义好的工作。它只做实现,不重写或重构任务,仅允许与用户商定的少量修正;节奏为一次一项任务并等待确认。

主要能力与规则:不修改产品文档(US 的 README.md、TK-XXX、ADR、technical-docs),仅可更新该 US 目录下的 progress.md;发现文档歧义、矛盾或业务规则不完整时立即停止并通知用户。UI 相关任务需在 ui-specialist 代理下执行;设计参考为 Figma 链接或文件时,须在实现前及过程中调用 figma-implement-design。仅当任务涉及 UI 时才委托,否则直接实现。

必要用法:实现前需确认 US 父级、范围、工作单元、干净的 git 工作区与 US 分支;分支不存在时用 git checkout -b 从约定基线创建。只处理元数据状态为 Ready 的任务,Draft 或 progress.md 中标记 Skipped 的默认不可执行。需先读取 US 的 README.md 与范围内的 TK,必要时查阅 docs/product/work-units.md,列出可实现与排除清单(排除项附状态),等待用户确认后再写代码。每项任务完成后运行 lint、typecheck 或 build 验证,不执行单元或 E2E 测试;更新 progress.md 后询问是否继续下一项,未经确认不启动下一项。若只给 TK 编号,须先问清所属 US,否则不实现。

适用场景与限制:适合在已有规格的仓库中逐项落地用户故事。限制包括:不产生产品文档、不在 main 或其他 US 分支实现(除非明确指示)、不默认执行 Draft 任务、不在任务循环中跑测试,除非用户接受收尾阶段的测试。测试可在范围内任务完成后按 README 与 TK 的验收标准实施;用户拒绝时记入 progress.md。缺失信息:具体技术栈、依赖安装命令与价格未提供。