AgentSkillsCN

devbooks-implementation-plan

devbooks-implementation-plan：从设计文档推导编码计划（tasks.md），输出可跟踪的主线计划/临时计划/断点区，并绑定验收锚点。当用户说“写编码计划/Implementation Plan/tasks.md/任务拆解/并行拆分/里程碑/验收锚点”等时，应运用此技能。

SKILL.md
--- frontmatter
name: devbooks-implementation-plan
description: devbooks-implementation-plan：从设计文档推导编码计划（tasks.md），输出可跟踪的主线计划/临时计划/断点区，并绑定验收锚点。用户说"写编码计划/Implementation Plan/tasks.md/任务拆解/并行拆分/里程碑/验收锚点"等时使用。
recommended_experts: ["System Architect", "Product Manager"]
allowed-tools:
  - Glob
  - Grep
  - Read
  - Write
  - Edit

DevBooks：编码计划（Implementation Plan）

渐进披露

基础层（必读）

目标：明确本 Skill 的核心产出与使用范围。 输入：用户目标、现有文档、变更包上下文或项目路径。 输出：可执行产物、下一步指引或记录路径。 边界：不替代其他角色职责，不触碰 tests/。 证据：引用产出物路径或执行记录。

进阶层（可选）

适用：需要细化策略、边界或风险提示时补充。

扩展层（可选）

适用：需要与外部系统或可选工具协同时补充。

推荐 MCP 能力类型

  • •代码检索（code-search）
  • •引用追踪（reference-tracking）
  • •影响分析（impact-analysis）

工作流位置感知（Workflow Position Awareness）

核心原则：Implementation Plan 在 Design Doc 之后执行，为 Test Owner 和 Coder 提供任务清单。

我在整体工作流中的位置

code
proposal → design → [Implementation Plan] → test-owner(阶段1) → coder → ...
                            ↓
                    tasks.md（任务清单）

Implementation Plan 的职责

允许禁止
从 design.md 推导任务❌ 参考 tests/（避免实现偏见）
绑定验收锚点 (AC-xxx)❌ 写实现代码
拆分并行任务❌ 执行任务

产出：tasks.md 结构

markdown
## 主线计划区
- [ ] MP1.1 任务描述 (AC-001)
- [ ] MP1.2 任务描述 (AC-002)

## 临时计划区
（紧急任务）

## 断点区
（中断续做信息）

前置：配置发现（协议无关）

  • •<truth-root>：当前真理目录根
  • •<change-root>：变更包目录根

执行前必须按以下顺序查找配置（找到后停止）：

  1. •.devbooks/config.yaml（如存在）→ 解析并使用其中的映射
  2. •dev-playbooks/project.md（如存在）→ Dev-Playbooks 协议，使用默认映射
  3. •project.md（如存在）→ template 协议，使用默认映射
  4. •若仍无法确定 → 停止并询问用户

关键约束：

  • •如果配置中指定了 agents_doc（规则文档），必须先阅读该文档再执行任何操作
  • •禁止猜测目录根
  • •禁止跳过规则文档阅读

产物落点

  • •编码计划：<change-root>/<change-id>/tasks.md

执行方式

  1. •先阅读并遵守：~/.claude/skills/_shared/references/AI行为规范.md（可验证性 + 结构质量守门）。
  2. •严格按完整提示词输出：references/编码计划提示词.md（只从设计推导，不参考 tests/）。

上下文感知

本 Skill 在执行前自动检测上下文，选择合适的运行模式。

检测规则参考：skills/_shared/上下文检测模板.md

检测流程

  1. •检测 design.md 是否存在（计划的输入）
  2. •检测 tasks.md 是否已存在
  3. •若存在，检测进度（完成/进行中/待开始）

本 Skill 支持的模式

模式触发条件行为
新建计划tasks.md 不存在从 design.md 推导完整计划
更新计划tasks.md 存在，design.md 有更新同步计划与设计变更
添加临时任务发现计划外紧急任务添加到临时计划区

Planner 约束

  • •只读 design.md 和 specs/
  • •不得参考 tests/（避免实现偏见）
  • •不得写实现代码

检测输出示例

code
检测结果：
- design.md：存在，AC 数量 14 个
- tasks.md：不存在
- 运行模式：新建计划

下一步推荐

参考：skills/_shared/工作流下一步.md

完成 implementation-plan 后，必须的下一步是：

条件下一个 Skill原因
始终devbooks-test-ownerTest Owner 必须先产出 Red 基线

关键：

  • •Test Owner 必须在单独的会话/实例中工作
  • •绝不在 implementation-plan 后直接推荐 devbooks-coder
  • •工作流顺序是：
code
implementation-plan → test-owner (会话A) → coder (会话B)

输出模板

完成 implementation-plan 后，输出：

markdown
## 推荐的下一步

**下一步：`devbooks-test-owner`**（必须在单独的会话中）

原因：实现计划已完成。下一步是让 Test Owner 创建验证测试并产出 Red 基线。Test Owner 和 Coder 必须在不同会话中工作以确保角色隔离。

### 如何调用（在新会话中）

运行 devbooks-test-owner skill 处理变更 <change-id>

code

**重要**：Test Owner 产出 Red 基线后，在另一个单独的会话中启动 Coder：

运行 devbooks-coder skill 处理变更 <change-id>

code