SuperAPI AI 工具集

user-story-implementer

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

用途:为单个 GitHub Issue 承担实现工作,不充当独立评审者,也不自行合并,除非仓库策略与用户明确授权。

主要能力:读取仓库说明、完整 Issue、验收标准、依赖、评论与关联设计上下文;确认依赖已交付而非仅关闭;检查负责人、阻塞状态与关联工作,避免接管他人 Issue;搜索关联 PR、本地与远程分支及 worktree,复用已有分支或 PR,不重复创建;在隔离 worktree 中工作以保留无关改动;遇到多个 Issue、分支或 PR 指向同一交付时停止并报告歧义。

实现方式:检查相关代码、测试、契约与文档,做满足完整 Issue 的最小一致改动;为每条验收标准记录直接证据(代码路径、聚焦测试、人工观察或文档变更);补充正常路径与相关失败/边界覆盖;运行聚焦验证及仓库策略要求的更广门禁;在可用时于合适运行时验证用户可见行为;自查 diff 的回归、安全、权限、数据安全、迁移、兼容性、并发、诊断与文档。若产品决策、凭据、外部服务或未完成依赖阻碍正确实现,在 Issue 记录确切阻塞并停止。

验收门禁:创建新 PR 或提交评审前,重读 Issue 并以表格逐条列出标准、实现证据与验证;证据须指明具体代码、测试、观察或文档变更。任一行缺失、与 diff 矛盾或未验证时,继续实现或报告阻塞,不得将 PR 视为可评审。表格放入 ### Acceptance Criteria Evidence。修订工作需处理完整评审意见集并重跑门禁。

分支与 PR:新工作选用聚焦分支如 story/<story-id-lowercase> 或 issue/<issue-number>;使用 scripts/prepare_story_branch.sh 获取默认分支、验证依赖合并并安全准备分支或隔离 worktree,已有分支用 --resume。仅暂存预期文件,遵循提交约定,推送后再创建 PR。PR 正文包含 ### Summary、### Acceptance Criteria Evidence、### Verification、### Not Verified。调用 scripts/create_pr.sh:bash /absolute/path/to/scripts/create_pr.sh
"<issue-number>" "<pr-title>" "<body-file>"
"<story-id-or-none>" "<design-path-or-none>"。修订工作推送到同一开放 PR;若先前交付已合并且 Issue 被合理重开,创建新的聚焦 PR 关联并关闭同一规范 Issue,不重写已合并历史。

交接:列出 Issue、PR、Head SHA、结果(Created | Resumed | Revised | Blocked)、验收标准证据、验证、已处理的阻塞发现与阻塞项。不得声称独立批准、合并、关闭 Issue 或功能就绪。

限制:资料未提供具体安装方式、收费与平台信息;脚本路径需按仓库实际位置解析。