with one click
generic-pdc-harness
审议式通用 PDC 循环技能,以 Plan-Do-Check 渐进式规划驱动任意任务逐步推进。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Menu
审议式通用 PDC 循环技能,以 Plan-Do-Check 渐进式规划驱动任意任务逐步推进。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | generic-pdc-harness |
| description | 审议式通用 PDC 循环技能,以 Plan-Do-Check 渐进式规划驱动任意任务逐步推进。 |
Planner ↔ Plan Reviewer (审议)
Doer ↔ Do Reviewer (审议)
Checker ↔ Check Reviewer (审议)
主Agent:加载本SKILL的Agent,仅负责调度子Agent执行各步骤,不参与任何环节的执行。
输入:完整任务描述 → 输出:任务产出(形式不限)。每个环节最多 12 轮审议式审查。
子agent指令(启动时让agent自行阅读):
| 参数 | 必填 | 说明 |
|---|---|---|
workdir | 是 | 工作目录绝对路径,命名:pdc/{YYYYMMDDHHMM}_{简要描述}/,{YYYYMMDDHHMM} 由 date +%Y%m%d%H%M 生成 |
task | 是 | 完整任务描述,初始化时写入 {workdir}/task.md |
max_rounds | 否 | 最大 PDC 轮次,默认 30 |
| 文件 | 维护者 |
|---|---|
{workdir}/task.md | 主Agent,初始化时写入 |
{workdir}/plan.md | Planner |
{workdir}/task_v{N}.md | Planner |
{workdir}/plan_review_v{N}_r{R}.md | Plan Reviewer |
{workdir}/do_v{N}.md | Doer |
{workdir}/do_review_v{N}_r{R}.md | Do Reviewer |
{workdir}/check_v{N}.md | Checker |
{workdir}/check_review_v{N}_r{R}.md | Check Reviewer |
workdir 中的其他文件均为产出,由 Doer 创建和修改,所有 agent 可读。
运行 date +%Y%m%d%H%M 得到 {YYYYMMDDHHMM}。
workdir 应位于工作区的 pdc/ 目录下,命名格式为 pdc/{YYYYMMDDHHMM}_{简要描述}/。
步骤 A-B、C-D、E-F 均遵循相同规则:
{TOKEN_WRITTEN}:{路径}APPROVED 或 REJECTEDAPPROVED → 进入下一环节REJECTED 且 R < 12 → R++,回到生产者修订REJECTED 且 R ≥ 12 → 主Agent 执行 git add -A && git commit -m "v{N} blocked" → N++,若 N > max_rounds 进入步骤 3,否则回到步骤 A(Planner 在步骤 A 中识别审议超限并自行写入 BLOCKED 记录到 plan.md)| 环节 | 生产者返回 Token | 审查员返回 Token |
|---|---|---|
| Plan(步骤 A-B) | TASK_ASSIGNED:{路径} 或 ALL_DONE:{路径}:{已完成任务数} | APPROVED:{路径} / REJECTED:{路径} |
| Do(步骤 C-D) | DO_DONE:{路径} | APPROVED:{路径} / REJECTED:{路径} |
| Check(步骤 E-F) | CHECK_PASSED:{路径} / CHECK_FAILED:{路径} | APPROVED:{路径} / REJECTED:{路径} |
创建 {workdir}/,将 {task} 写入 {workdir}/task.md。N = 1。以 workdir 路径最后一段为分支名,执行 git checkout -b {branch}。
步骤 A — Planner → 步骤 B — Plan Reviewer
PR = 1。按审议循环规则执行。
Planner prompt(subagent_type: "general"):
请先阅读 {this_skill_dir}/planner.md 获取指令,然后:
任务描述:{workdir}/task.md
计划文件:{workdir}/plan.md
任务输出:{workdir}/task_v{N}.md
工作目录:{workdir}
{PR > 1 时追加:审查文件:{workdir}/plan_review_v{N}_r{PR-1}.md 审议修订时覆写原产出文件,禁止创建新版本号文件}
{N > 1 时追加:上一轮产出(部分文件可能因上一轮审议超限而不存在,不存在则跳过):{workdir}/do_v{N-1}.md, {workdir}/check_v{N-1}.md}
{审议超限时追加:上一轮{超限环节}审议达到 12 轮上限,请在 plan.md 中记录 BLOCKED 并尝试绕过}
返回 TASK_ASSIGNED:{路径} 继续,或 ALL_DONE:{路径}:{已完成任务数} → 主Agent 执行 git add -A && git commit -m "all done" 后跳到步骤 3。
Plan Reviewer prompt:
请先阅读 {this_skill_dir}/plan_reviewer.md 获取指令,然后:
任务描述:{workdir}/task.md
计划文件:{workdir}/plan.md
任务文件:{workdir}/task_v{N}.md
审查输出:{workdir}/plan_review_v{N}_r{PR}.md
工作目录:{workdir}
{N > 1 时追加:上一轮产出(部分文件可能因上一轮审议超限而不存在,不存在则跳过):{workdir}/do_v{N-1}.md, {workdir}/check_v{N-1}.md}
步骤 C — Doer → 步骤 D — Do Reviewer
DR = 1。按审议循环规则执行。
Doer prompt(subagent_type: "general"):
请先阅读 {this_skill_dir}/doer.md 获取指令,然后:
任务描述:{workdir}/task.md
任务文件:{workdir}/task_v{N}.md
执行报告输出:{workdir}/do_v{N}.md
工作目录:{workdir}
注意:不要创建、修改或删除除当前轮次执行报告(do_v{N}.md)以外的状态文件(task.md、plan.md、task_v*.md、*_review_*.md、do_v*.md、check_v*.md),这些是 PDC 流程的协调文件,不是产出物。当前轮次执行报告是你的合法产出,不在禁止范围内。
{DR > 1 时追加:审查文件:{workdir}/do_review_v{N}_r{DR-1}.md 审议修订时覆写原产出文件,禁止创建新版本号文件}
Do Reviewer prompt:
请先阅读 {this_skill_dir}/do_reviewer.md 获取指令,然后:
任务描述:{workdir}/task.md
任务文件:{workdir}/task_v{N}.md
执行报告:{workdir}/do_v{N}.md
审查输出:{workdir}/do_review_v{N}_r{DR}.md
工作目录:{workdir}
步骤 E — Checker → 步骤 F — Check Reviewer
CR = 1。按审议循环规则执行。
Checker prompt(subagent_type: "general"):
请先阅读 {this_skill_dir}/checker.md 获取指令,然后:
任务描述:{workdir}/task.md
任务文件:{workdir}/task_v{N}.md
执行报告:{workdir}/do_v{N}.md
检查报告输出:{workdir}/check_v{N}.md
工作目录:{workdir}
{CR > 1 时追加:审查文件:{workdir}/check_review_v{N}_r{CR-1}.md 审议修订时覆写原产出文件,禁止创建新版本号文件}
Check Reviewer prompt:
请先阅读 {this_skill_dir}/check_reviewer.md 获取指令,然后:
任务描述:{workdir}/task.md
任务文件:{workdir}/task_v{N}.md
执行报告:{workdir}/do_v{N}.md
检查报告:{workdir}/check_v{N}.md
审查输出:{workdir}/check_review_v{N}_r{CR}.md
工作目录:{workdir}
步骤 G — 提交
Checker 审议通过后,主Agent 执行 git add -A && git commit -m "v{N} done"。
步骤 H — 轮次推进
N++,回到步骤 A。若 N > max_rounds 进入步骤 3。
任务已完成,计划文件:{workdir}/plan.md,共完成 {从 ALL_DONE token 提取的已完成任务数} 个任务,分支:{branch}达到最大轮次限制,计划文件:{workdir}/plan.md,分支:{branch}仅返回文件路径和统计信息,不输出内容到对话。
采用「设计-验证」审议框架完成项目架构级OOD设计。
与用户协作进行审议式、渐进式代码审查。
审议式流程的前置准备。任何审议式流程执行前必须先调用本技能。
通用审议式流程,采用「执行-审查」审议框架完成任意用户任务。
采用审议式「计划-设计-编码-验证」管线框架,将任务逐步实现为可运行的代码。
采用「检查-计划-执行」审议循环,对代码库进行渐进式lint治理。