mcpField
P
preparar-sprint0

preparar-sprint0

github.com/adminoryslabs开发041 次安装今天更新
代码仓库

关于 preparar-sprint0

Preparar Sprint 0 是一项规划技能,将项目初始化整理为范围明确、可验证的任务,供开发者和测试人员共同使用。它生成 `SPRINT0.md` 后即停止,不创建或实现应用代码。

主要功能

  1. 01按范围分类 ADR
  2. 02定义路径所有权
  3. 03编写可验证的完成标准
  4. 04规划开发与测试任务
  5. 05记录待确认问题

适用场景

  1. 01界定项目初始骨架的范围
  2. 02协调测试人员与开发者的职责
  3. 03区分基础决策与功能开发

安装

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

$npx skills add https://github.com/adminoryslabs/armory --skill preparar-sprint0

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

附带文件assets/sprint0-template.md

详细介绍

准备 Sprint 0

目标

将“初始化项目”转化为一个范围明确且可验证的工作单元:一个可端到端运行的最小骨架,不包含业务逻辑。最终产物是一份文档 SPRINT0.md,TESTER 和 DEV 均会阅读。

**此 skill 不会构建任何内容。**它只负责准备、提出方案,然后停止。

输入

  • TECH-DESIGN.md 和 adrs/ — 必需。如果缺少其中任何一项,立即停止并索取。
  • 项目的 AGENTS.md 和/或 CLAUDE.md — 如果存在,则阅读并在之后更新(步骤 5)。
  • HUs — 不阅读以进行构建。仅用于确定每个故事 ADR 所属的故事。

工作流

  1. 阅读 Tech Design 和所有 ADR。

  2. 将每个 ADR 分类为以下三类之一,并用一行说明理由:

    • 横向 — 项目要运行就需要它(技术栈、结构、API 风格、ORM、通用状态管理)。适用于 Sprint 0。
    • 故事级 — 用于实现某项具体功能。不适用于 Sprint 0;注明它属于哪些 HU。
    • 混合 / 待讨论 — 部分属于横向内容,部分属于故事级内容。说明当前适用的部分,并标记以供人工确认。 指引问题:“项目要运行是否需要它,还是它只用于某项具体功能?”
  3. 根据项目的实际技术栈(而非假设的技术栈)定义路径归属图:

    • TESTER — 按所选测试框架的约定存放测试的路径(以及测试夹具或测试数据)。
    • DEV — 应用代码、配置、迁移文件和依赖清单。
    • 仅限 LEAD / 人工处理 — harness 文件:AGENTS.md、CLAUDE.md、skills 和 Agent 配置目录、SPRINT0.md、契约。 如果某个路径无法明确归属,则将其标记为待人工确认的问题。
  4. 编写骨架的 Definition of Done。每一点都必须可验证,并说明如何验证(测试或命令)。至少包括:

    • 应用可在本地启动;
    • 如果横向 ADR 中包含主要依赖项(例如数据库),应用可以连接这些依赖项;
    • 存在健康检查点(例如某个路由或 health 命令),并注明确切名称;
    • 测试 runner 已安装、配置且可以运行;
    • 遵循横向 ADR;
    • 业务逻辑为零。 在 DoD 中写明准确名称(路由、命令):这是 TESTER 和 DEV 无需直接沟通即可协作所需的最低限度契约。
  5. 使用 assets/sprint0-template.md 编写计划:DEV 创建什么、TESTER 创建什么,以及不创建什么(所有属于故事级 ADR 的内容)。

  6. 将 SPRINT0.md 保存到项目根目录,并将路径归属图添加到 AGENTS.md(如果 CLAUDE.md 也存在,则一并添加),放在 ## 路径归属 小节中。

  7. **停止。**向人工呈现:ADR 分类、路径图、DoD、计划,以及未解决问题列表。**不得调用任何人,也不得创建应用文件。**如果人工要求修改,则调整 SPRINT0.md 并再次呈现。

限制

  • 不实现任何故事级 ADR,即使看起来很简单也不行。
  • 不选择 ADR 未确定的技术栈:如果缺少决策,则列为问题。
  • 无法验证的 DoD 项目不得纳入 DoD。
  • 不发布任何内容(不得 push 到 main,也不得部署)。

评论

支持 Markdown