关于 preparar-sprint0
Preparar Sprint 0 是一项规划技能,将项目初始化整理为范围明确、可验证的任务,供开发者和测试人员共同使用。它生成 `SPRINT0.md` 后即停止,不创建或实现应用代码。
主要功能
- 01按范围分类 ADR
- 02定义路径所有权
- 03编写可验证的完成标准
- 04规划开发与测试任务
- 05记录待确认问题
适用场景
- 01界定项目初始骨架的范围
- 02协调测试人员与开发者的职责
- 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 所属的故事。
工作流
-
阅读 Tech Design 和所有 ADR。
-
将每个 ADR 分类为以下三类之一,并用一行说明理由:
- 横向 — 项目要运行就需要它(技术栈、结构、API 风格、ORM、通用状态管理)。适用于 Sprint 0。
- 故事级 — 用于实现某项具体功能。不适用于 Sprint 0;注明它属于哪些 HU。
- 混合 / 待讨论 — 部分属于横向内容,部分属于故事级内容。说明当前适用的部分,并标记以供人工确认。 指引问题:“项目要运行是否需要它,还是它只用于某项具体功能?”
-
根据项目的实际技术栈(而非假设的技术栈)定义路径归属图:
- TESTER — 按所选测试框架的约定存放测试的路径(以及测试夹具或测试数据)。
- DEV — 应用代码、配置、迁移文件和依赖清单。
- 仅限 LEAD / 人工处理 — harness 文件:
AGENTS.md、CLAUDE.md、skills 和 Agent 配置目录、SPRINT0.md、契约。 如果某个路径无法明确归属,则将其标记为待人工确认的问题。
-
编写骨架的 Definition of Done。每一点都必须可验证,并说明如何验证(测试或命令)。至少包括:
- 应用可在本地启动;
- 如果横向 ADR 中包含主要依赖项(例如数据库),应用可以连接这些依赖项;
- 存在健康检查点(例如某个路由或 health 命令),并注明确切名称;
- 测试 runner 已安装、配置且可以运行;
- 遵循横向 ADR;
- 业务逻辑为零。 在 DoD 中写明准确名称(路由、命令):这是 TESTER 和 DEV 无需直接沟通即可协作所需的最低限度契约。
-
使用
assets/sprint0-template.md编写计划:DEV 创建什么、TESTER 创建什么,以及不创建什么(所有属于故事级 ADR 的内容)。 -
将
SPRINT0.md保存到项目根目录,并将路径归属图添加到AGENTS.md(如果CLAUDE.md也存在,则一并添加),放在## 路径归属小节中。 -
**停止。**向人工呈现:ADR 分类、路径图、DoD、计划,以及未解决问题列表。**不得调用任何人,也不得创建应用文件。**如果人工要求修改,则调整
SPRINT0.md并再次呈现。
限制
- 不实现任何故事级 ADR,即使看起来很简单也不行。
- 不选择 ADR 未确定的技术栈:如果缺少决策,则列为问题。
- 无法验证的 DoD 项目不得纳入 DoD。
- 不发布任何内容(不得 push 到 main,也不得部署)。
评论
支持 Markdown