Story Readiness

---
name: story-readiness
description: "验证 Story 是否就绪可开发。检查必要字段、依赖、验收标准、技术注册表链接是否齐备，输出就绪清单与阻塞项。"
license: MIT
metadata:
  model: haiku
  argument-hint: "[故事路径]"
  user-invocable: true
  allowed-tools:
    - Read
    - Glob
    - Grep
    - Write
  platforms:
    claude-code: {enabled: true}
    cursor: {enabled: true}
    codex: {enabled: true}
    windsurf: {enabled: true, trigger: /story-readiness}
    trae: {enabled: true}
    hermes: {enabled: true, platforms: [macos, linux, windows]}
    workbuddy: {enabled: true}
---

# story-readiness —— Story 就绪验证技能

## 技能目的

在 Story 进入开发阶段前执行"准入检查"，确保其具备开工所需的全部信息与依赖，
避免因 Story 描述不完整导致开发中途返工。本技能为轻量级前置闸门，不修改 Story 内容，
仅输出就绪度评估与阻塞项清单。

## 参数说明

- `[故事路径]`：待验证的 Story Markdown 文件路径，例如 `docs/stories/PAY-301.md`。
  若仅给出 ID，则在 `docs/stories/` 下模糊匹配。

## 分阶段工作流

### 阶段 1：定位 Story

- **输入**：用户提供的 `[故事路径]` 或 Story ID。
- **处理**：使用 Read 读取目标文件；路径不存在则用 Glob 在 `docs/stories/` 下匹配。
- **输出**：确认 Story 绝对路径，并解析 frontmatter。

### 阶段 2：字段完整性检查

- **输入**：Story 文件内容。
- **处理**：核对以下必填字段是否齐备：
  - ID、标题、Epic 归属
  - 用户故事描述（作为…我希望…以便…）
  - 验收标准（至少 1 条可验证）
  - 优先级与估算
  - 关联技术需求（TR 注册表链接）
- **输出**：字段缺失清单，标注每个缺失字段的影响。

### 阶段 3：依赖与关联检查

- **输入**：Story 中引用的 TR、ADR、依赖 Story。
- **处理**：使用 Grep 在 `docs/registry/`、`docs/adr/`、`docs/stories/` 中确认引用是否存在、是否已闭环。
- **输出**：依赖状态表：已就绪 / 待解决 / 缺失。

### 阶段 4：就绪度评估

- **输入**：阶段 2 与阶段 3 的结果。
- **处理**：综合判定就绪状态：`ready` / `blocked` / `needs-rework`。
- **输出**：就绪度结论与阻塞项优先级排序。

### 阶段 5：输出就绪报告

- **输入**：阶段 4 的结论。
- **处理**：使用 Write 将就绪报告写入 `docs/stories/_readiness/READY-<StoryID>.md`。
- **输出**：报告路径与一句话结论。

## 协作协议引用

- 本技能为只读评估，不修改 Story 本体。
- 写入就绪报告前必须询问用户："我可以将就绪报告写入 [路径] 吗？"
- 不得自主将 Story 状态改为 `ready`，需由用户确认。

## 推荐下一步

- 就绪通过后运行 `/dev-story [故事路径]` 进入实现。
- 若存在阻塞项，请先回到 Story 作者补全字段或解决依赖。
- 若需评估 Sprint 整体就绪度，可批量对本 Sprint 内所有 Story 执行本技能。