mcpField
A
agile-story

agile-story

github.com/djalmajr开发4126 次安装5 周前更新
代码仓库

关于 agile-story

将范围明确的小型工作整理为可执行计划的规划技能，适用于准备开展实现的团队或开发者。它会梳理文件、可验证任务、测试和验证步骤，并要求先确认计划再开始实现。

主要功能

  1. 01生成可直接实施的计划
  2. 02列出精确文件路径与操作
  3. 03制定可验证的任务清单
  4. 04包含测试优先规划
  5. 05指定验证步骤
  6. 06要求确认后再实施

适用场景

  1. 01规划小型代码变更
  2. 02将 Epic 故事细化为执行任务
  3. 03梳理受影响文件与验收检查
  4. 04准备测试和验证命令

安装

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

$npx skills add https://github.com/djalmajr/skills --skill agile-story

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

附带文件templates/story.md

详细介绍

Story

使用此技能创建清晰、可立即实施的执行计划。

通过斜杠命令接收的初始上下文：$ARGUMENTS

如果 $ARGUMENTS 有内容（例如 Story 引用、描述、议题），请以此作为起点。 如果为空，请询问需要规划什么。

语言

使用用户的语言编写文档。语法和所需的变音符号或特定文字字符均须正确。如果无法确定用户使用的语言，请在生成内容前询问。模板为英文——请翻译标题和内容，使其符合用户的语言。

项目根目录

此技能会在项目根目录（执行工作的代码仓库）下的相对路径中写入文档，而不是 Agent 当前的工作目录。

  • 如果从项目内部调用，请使用此技能中所示的相对路径。
  • 如果从其他目录调用（例如，位于相邻的代码仓库，或项目位于其他位置），请在每个文档路径前加上 <project-root>/。
  • 如果项目根目录不明确，请在写入前通过宿主的提问工具向用户确认。

提问

遵循项目范围内 CLAUDE.md / AGENTS.md 中的约定（“Skill Prompting Conventions”）。对于以下决策点，请使用宿主的结构化提问工具——AskUserQuestion（Claude Code）、ask_user_question（Codex）或 question（OpenCode）。

决策点采用结构化提问的原因建议选项
实施模式决定后续流程仅规划（完成文档后停止）· 先规划后实施（在本次会话中继续）
测试策略（添加配套测试时）影响文件布局sibling · sibling_dir · tests_root

自由文本提问（不使用结构化提问工具）：

  • Story 名称
  • 任务描述
  • 技术栈选择（尚未在 Epic 阶段确定时）

无暂停模式：如果用户明确禁用了技能执行过程中的澄清提问，请将每个结构化提问转为“待解决问题”（或同等部分）中的条目，并继续执行，不要阻塞流程。

目标

  • 创建清晰且难度适中的执行计划
  • 梳理受影响的文件
  • 定义可验证的任务
  • 产出可立即实施的文档

适用场景

  • 小规模且局部的工作——涉及少量文件、风险低、单次交付
  • 需要为 Epic 中的 Story 制定可执行的计划
  • Epic 中已有详细的 Story，需要将任务映射到文件
  • 问题已经明确，只需规划需要修改的内容

不适用场景

  • 需要拆解的大规模工作——使用 /agile-epic
  • 问题尚不明确——使用 /agile-intake
  • 存在多个相互依赖的交付——使用 /agile-epic
  • 需要制定战略方向——使用 /agile-roadmap

流程

1. 了解需要完成的工作

如果输入来自 Epic Story 文件，请阅读 Story 并提取：

  • 目标
  • 受影响的文件
  • 验收标准
  • 涉及的原型路由／页面
  • 涉及的业务规则 ID／文件

如果是独立任务，请询问用户，并查看代码以了解上下文。

2. 制定计划

填写以下必需部分：

  • **上下文：**问题、目标、约束
  • **可追溯性：**原型路由／页面、业务规则 ID／文件、源文档
  • **文件：**确切路径及操作（读取／修改／创建）
  • **详情：**现状、目标状态、范围、方案
  • **测试优先计划：**要验证的行为、首个失败测试、测试级别，以及应避免的低价值测试
  • **任务：**可验证的检查清单
  • **验证：**命令和验证项
3. 呈现计划并等待确认

使用 harness 的计划模式工具呈现计划（例如 Claude Code 中的 ExitPlanMode）。等待用户明确确认后再开始实施。

实施模式（在此步骤决定）：

  • 先规划后实施（同一会话）： 呈现计划并获得确认，然后按检查清单开始编写代码。默认用于用户要求编写“故事”，并期待后续进行代码更改的情况。
  • 仅规划： 计划产物保存后即停止。默认用于故事属于规划循环的情况（例如，在执行前拆分史诗，或将此技能用作示例练习）。

如果工作流程存在歧义，请通过 harness 的提问工具询问用户，决定采用哪种模式（参见 ## Prompting）。

史诗与故事的边界

如果故事文件已由 /agile-epic 创建，此技能会补充执行细节，不会重写史诗阶段的内容：

  • 史诗阶段会在 Tasks 中提供纵向阶段的大纲。
  • 故事阶段会补充每项任务的 Done when: 验收标准、Test-first plan，以及具体的验证命令。
  • 如果需要确定 2 项或更多实施选项，故事阶段也可以在 Approach 中添加 Story-time decisions 表格。
保存位置
  • 如果属于某项计划：planning/<initiative>/epics/NN-<epic>/NN-story-name.md
    • 如果史诗阶段已创建故事文件，请直接在原处添加或更新 Tasks 和 Verification 部分。
  • 如果是独立事项：.agents/plans/<name>.md（适用于没有关联史诗的事项）

任务计划是执行产物。它们通过 Origin 字段引用所属的故事或史诗。属于某项计划时，故事文件已包含上下文，任务计划只需补充执行细节。

交叉引用

如果计划来自某个史诗，请在顶部添加：

**Origin:** `planning/<initiative>/epics/NN-<epic>/00-overview.md`
后续步骤

计划获得确认后：

  • 先规划后实施： 按检查清单进行实施；结束时，建议使用 /agile-status（收尾模式）完成交付。
  • 仅规划： 计划产物完成后即停止；待实际实施时，建议再次调用此技能（或使用 /agile-status 收尾）。
参考模板

使用此技能中的 templates/story.md 作为基础。

必需章节

每份计划都必须包含：

  1. Context（问题、目标、约束、参考资料）
  2. Traceability（原型路由/屏幕、业务规则 ID/文件、源文档）
  3. Files（准确路径、操作、原因）
  4. Detail（现状、目标状态、范围、方案、风险）
  5. Test-first plan（行为、首个失败测试、首选测试级别，以及适用时的前端价值检查）
  6. Tasks（可验证的检查清单）
  7. Verification（lint、类型检查、测试、手动验证、验收）
规则
  • 每份计划都必须在实施前呈现（ExitPlanMode）。
  • 只有获得用户明确确认后才能实施。
  • 对需要史诗的大型工作（包含多个故事），不要创建任务计划。
  • 文件必须提供准确路径。
  • 如果故事涉及领域行为、权限、同步、冲突处理、AI 审批或审计/版本管理，请引用业务规则 ID。
  • 前端计划应在变更面向用户时引用原型路由/屏幕。
  • 任务必须可验证，不得含糊。
  • 完成后，根据实际进度将 [ ] 更新为 [x]。
与流程的关系
flowchart LR
    A["/agile-intake"] --> B["/agile-epic"]
    B --> C["/agile-story"]
    C --> D[execution]
    D --> E["/agile-status"]
    E --> F["/agile-retro"]

此技能是执行前的最后一步。对于更大型的问题，请使用 /agile-epic。要完成交付，请使用 /agile-status（收尾模式）。

评论

支持 Markdown