القائمة
在当前会话里按已写好的实现计划顺序执行任务时使用
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
在已有规格或多步骤任务需求、且在动代码之前使用。若上游 ddev-pc-test 已产出测试用例，自动走 TDD 流程：先实现测试 demo 代码（红灯），再实现被测代码（绿灯），测试覆盖不到的部分直接开发。
文档审查技能。将文档审查任务派发给独立子代理，重点审查文档基于代码改动的合理性、说明正确性、前后一致性、错漏和逻辑谬误，以及 AI 实现过程中产生的决策记录（implementation-notes.md）。当用户需要审查技术文档、spec文档、设计文档、计划文档、API文档、README 或任何与代码改动相关的文档时使用。
代码修改场景下，spec 文档确认后，需要继续以图优先方式梳理结构体定义、数据流和流程时使用
在代码修改前需要编写 spec 文档且应优先用图表达边界、入口、流程和改动关系时使用（仅限代码改动场景，非项目级架构文档初始化）
在代码实现完成后、准备结束任务或进入发布前使用，用来核对代码实现是否与 spec 文档以及 detail 文档一致，并通过代码质量审查、清理、编码规范和注释审查后给出最终验收结论
当需要基于仓库代码推导刷写参数，并复用统一流程完成固件探测、分包或刷写时使用。
| name | ddev-exec |
| description | 在当前会话里按已写好的实现计划顺序执行任务时使用 |
读取计划，先做批判性检查，再按顺序执行所有任务，并在完成后进入默认收尾。执行时不只看计划本身，还要把计划引用的 architecture / detail / flow / dataflow 文档一并作为实现依据。
开始时声明： “我正在使用 ddev-exec skill 来执行这个计划。”
update_plan 跟踪并开始所有任务在主会话中逐个串行执行，不派发子代理：
in_progresscompleted，然后进入下一个任务如果计划里已经要求在步骤中提交、审查或补文档，就照计划执行，不要省略。
如果计划步骤与引用文档冲突，以已确认的 architecture / detail / flow / dataflow 文档为准，并立即回到计划审查，必要时先修计划再继续执行。
不要在任务刚做完时就提前宣称”计划完成”；默认要把最终完成结论留给收尾门禁。
ddev-code-review 做阶段性复核当所有任务完成并通过计划要求的验证后，进入默认收尾顺序：
verification-before-completion 补齐最终结论所需的验证证据ddev-code-reviewddev-gate 做第一轮一致性验收，并拉独立审查 agent 核对 architecture、detail、data flow、flow、exec plan 与代码是否完全一致ddev-gate 返回 blocked，主 agent 必须先修改，再重新进入 ddev-gateddev-gate 返回 need-info，主 agent 必须先补齐缺失输入、范围或验证证据，再重新进入 ddev-gateddev-gate 给出一致性 pass 后，才进入 ddev-clean 清理阶段ddev-clean 的 regression-tests-first、最小 diff、最小作用域规则执行，不得借 cleanup 扩大为重构或改设计pass，进入最终收尾ddev-gate 做完整一致性重审ddev-gate 也返回 pass，才能宣称“计划已经完成”遇到下面情况要立刻停，先澄清再继续：
不要硬猜，也不要在关键歧义下继续往前推。
以下情况要回到“读取并审查计划”这一步重新判断：
永远不要：
ddev-gate 一致性 pass 之前提前进入 cleanupddev-gatemain / master 上开始实现执行过程中必须维护三份持久化文件，确保上下文穿越和断点恢复。
| 文件 | 用途 | 何时创建 |
|---|---|---|
task_plan.md | 任务追踪：从 exec plan 提取 Task N 生成 checkbox 列表 + Errors 表 | 第一步完成后自动创建 |
progress.md | 执行日志：每任务完成后记录产出和验证结果 | 首次写入时创建 |
implementation-notes.md | 实现笔记：每任务完成后按 4 维度记录 AI 推理过程 | 首次任务完成后自动创建 |
findings/ | 上游设计决策（由 ddev-spec/detail/doc-review 写入，本阶段只读） | 已存在 |
审查计划通过后，从 exec plan 文档中提取所有 Task N，生成 task_plan.md。格式：
# 任务执行追踪
> 来源计划：docs/plans/26-06-20_xxx/exec_plans/feature-name.md
> 创建时间：2026-06-20
> 目标：<一句话目标>
## Current Task
- **Task**: Task 1 — 错误码枚举定义
- **Status**: in_progress
## Tasks
- [ ] Task 1 — 错误码枚举定义
- [ ] Task 2 — 上下文结构体
- [ ] Task 3 — 状态机实现
- [ ] Task 4 — API 接口暴露
- [ ] Task 5 — 单元测试
## Errors Encountered
| Error | Attempt | Task | Resolution |
|-------|---------|------|------------|
每个任务开始时：
task_plan.md 确认目标和当前任务每个任务完成后：
task_plan.md 中该任务的 checkbox 为 [x]Current Task 为下一个任务implementation-notes.md，按 4 维度记录本任务的推理过程progress.md，格式：### Task N — <任务名> ✅
- 新建/修改的文件列表
- 验证命令和结果
- 如有错误，简要说明
错误发生时：
task_plan.md 的 Errors Encountered 表每个任务完成后，必须在 implementation-notes.md 中追加本轮实现过程中出现的推理记录。格式：
# Implementation Notes
> 来源计划：docs/plans/YY-MM-DD_xxx/exec_plans/feature-name.md
> 创建时间：2026-07-08
## Design Decisions
> spec/detail 文档未覆盖、AI 在实现过程中自行做出的设计选择
### Task N — <任务名>
- **决策**：<做了什么选择>
- **触发原因**：<spec 中哪个点没说清楚，导致必须自己做判断>
- **影响范围**：<哪些文件/接口受此决策影响>
## Deviations
> 故意偏离 spec/detail/plan 的实现，及偏离理由
### Task N — <任务名>
- **偏离点**：<文档要求 A，实际实现为 B>
- **理由**：<为什么偏离>
- **影响范围**：<哪些文件/接口受影响>
## Tradeoffs
> 考虑过但最终放弃的替代方案，及放弃原因
### Task N — <任务名>
- **替代方案**：<描述考虑过的方案>
- **放弃原因**：<为什么不选>
- **当前方案**：<实际采用的方案简述>
## Open Questions
> 拿不准、需要用户集中定夺的问题（攒着，不零散打断）
### Task N — <任务名>
- **问题**：<描述不确定点>
- **当前处理**：<临时用了什么方式>
- **建议**：<你认为应该怎么处理>
四个维度中，Design Decisions 和 Deviations 为强制维度——每个任务完成后必须至少检查这两类。Tradeoffs 和 Open Questions 为按需维度——有则必写，无则标注"无"。不得跳过整个文件。
Open Questions 中的问题在 ddev-gate 验收阶段会作为未决项被检查，因此在进入默认收尾前必须全部回答完毕。
进入默认收尾前，验证 task_plan.md 中所有 Tasks 均已 [x]，且 implementation-notes.md 中 Open Questions 已全部回答完毕。未全部完成的不进入第四步。
会话中断后重新开始时：
python scripts/session-catchup.py 获取 5-Question Reboot Test 摘要task_plan.md 定位当前任务和未完成的任务progress.md 了解已完成任务的产出和验证结果implementation-notes.md 了解已完成任务中的设计决策、偏离和未决问题状态追踪文件：
task_plan.md — 每任务开始前确认目标，每任务完成后更新 checkboxprogress.md — 每任务完成后记录产出和验证结果implementation-notes.md — 每任务完成后按 4 维度记录推理过程Required workflow skills: