mcpField
U
user-story-implementer

user-story-implementer

github.com/eho开发170 次安装10 周前更新
代码仓库

关于 user-story-implementer

user-story-implementer 是面向编码 Agent 的 GitHub Issue 实现技能，负责从确认工作归属到实现、验证和交接。它要求逐条提供验收标准证据，并避免重复分支或越权审查、合并。

主要功能

  1. 01检查 Issue、依赖与现有工作
  2. 02实现满足验收标准的改动
  3. 03记录逐项验收证据
  4. 04运行验证并自查差异
  5. 05按模板创建 PR 并交接

适用场景

  1. 01接手一个 GitHub Issue 的实现
  2. 02恢复已有分支或 PR 上的工作
  3. 03验证并准备实现成果供审查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/eho/agent-skills --skill user-story-implementer

安装后在 Claude Code 中输入/user-story-implementer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
create_pr.sh
prepare_story_branch.sh
tests/
create_pr_test.sh
prepare_story_branch_test.sh

详细介绍

用户故事实现者

负责实现一个 GitHub Issue。除非独立的仓库政策和用户指示明确授权，否则不要充当独立审核者，也不要合并自己的工作。

明确工作范围

  1. 阅读仓库说明、完整 Issue、验收标准、依赖项、评论和关联的设计背景。
  2. 确认依赖项已交付，而不仅仅是已关闭。
  3. 检查受指派人、阻塞状态和正在进行的关联工作。未经明确授权，不要接手其他负责人的 Issue。
  4. 搜索关联的 PR、本地和远程分支，以及工作树归属，查找此 Issue 是否已有工作。继续使用明确无误的现有分支或 PR；切勿创建重复项。
  5. 检查工作树并保留无关更改。切换分支会干扰正在进行的工作时，请使用隔离的工作树。
  6. 如果多个 Issue、分支或 PR 都可能代表同一项交付，请停止并报告歧义。

实现

  1. 检查相关代码、测试、契约和文档。
  2. 实现满足完整 Issue 要求的最小连贯更改。
  3. 对每项验收标准，记录直接证据，例如代码路径、针对性测试、手动观察或文档更改。
  4. 添加有意义的正常路径测试，以及相关的失败或边界情况测试。
  5. 针对更改涉及的风险运行针对性验证，并运行仓库政策要求的任何更全面检查。
  6. 如果有可用工具，请在适当的运行环境中体验有意义的用户可见行为；仅有自动化测试不足以证明视觉或交互验收标准已满足。
  7. 自行审查差异，检查是否存在回归、安全、权限、数据安全、迁移、兼容性、并发、诊断和文档方面的问题。

如果产品决策、凭据、外部服务或尚未完成的依赖项阻碍正确实现，请在 Issue 中记录确切的阻碍并停止。

验收门槛

创建新 PR 或将任何 PR 交由审核前，请重新阅读 Issue，并在一张简洁的表格中逐项说明每项验收标准：

标准实现证据验证

证据必须指出具体的代码、测试、观察结果或文档更改。如果缺少任何必需的行、差异与之矛盾，或尚未验证，请继续实现或报告阻碍；不要将 PR 标记为可供审核。将完整表格放入 ### Acceptance Criteria Evidence。 对于修订工作，请处理完整的审核意见集，并在请求新一轮审核前重新完成此验收门槛。

分支和拉取请求

对于新工作，选择一个范围明确的分支，例如 story/<story-id-lowercase> 或 issue/<issue-number>。解析并使用 scripts/prepare_story_branch.sh，以获取默认分支、验证依赖项是否已合并，并安全地准备分支或隔离的工作树。对于现有分支，请使用 --resume。

  • 仅暂存预期文件。

  • 遵循仓库的提交规范。

  • 创建 PR 前先推送分支。

  • 编写包含 ### Summary、### Acceptance Criteria Evidence、### Verification 和 ### Not Verified 的 PR 正文。

  • 解析并调用 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:
- Result: Created | Resumed | Revised | Blocked
- Acceptance-criteria evidence:
- Verification:
- Blocking findings addressed:
- Blocker:

不要声称已独立批准、合并、关闭 Issue 或确认功能已就绪。

评论

支持 Markdown