Plan-Do-Check-Act 技能

该技能实现 PDCA（Plan-Do-Check-Act）工作流，确保任务得到系统性规划与执行。

依赖要求

• Python 3.6+ — 所有脚本必需
• Git — 可选 — 仅用于进度追踪。PDCA 在无 Git 环境下亦可正常运行，此时将改用文件修改时间作为依据。

首次配置指南

安装完成后，请运行配置向导：

# 运行交互式配置
python3 scripts/setup.py

向导将执行以下操作：

1. 检查 Python 和 Git 依赖是否就绪
2. 创建工作区目录（默认路径：~/pdca-workspace）
3. 生成一个测试计划
4. （可选）初始化 Git 以支持进度追踪
5. 显示后续操作指引

手动配置

如需手动配置，请执行以下命令：

# 1. 创建工作区目录
mkdir -p ~/pdca-workspace

# 2. 创建测试计划
cd ~/pdca-workspace
manage_plan.py create "我的首个计划" "任务 1" "任务 2" "任务 3"

# 3. 验证功能是否正常
manage_plan.py check plan.md

# 4. （可选）配置 Git 以支持进度追踪
git init

安全说明

• 工作区范围限制： 仅操作已配置工作区目录下的 plan*.md 文件
• 破坏性操作： cleanup 命令将删除存档目录中超过指定天数的文件（默认为 7 天）
• 用户确认机制： 执行归档操作前，若计划尚未完成，将提示用户确认
• 预览模式： 使用 cleanup --dry-run 可在实际删除前预览将被清理的文件
• 自主调用限制： 执行 cleanup 或 archive 操作前必须获得用户明确确认

核心流程

1. Plan（计划）

接收到用户任务后，创建 plan.md 文件：

• 将任务拆解为可执行的子任务
• 记录会话 ID
• 标注优先级与依赖关系

2. Do（执行）

依据 plan.md 执行各项任务：

• 每完成一项任务即标记为 [x]
• 进行中的任务标记为 [>]
• 记录执行过程中发现的问题

3. Check（检查）

所有任务完成后执行检查：

• 核查是否存在遗漏项
• 验证输出结果是否符合预期
• 识别可优化环节

4. Act（处理）

根据检查结果采取行动：

• 修复已识别的问题
• 在 plan.md 中更新经验总结与改进点
• 归档已完成计划或启动下一轮迭代

plan.md 模板

# 任务计划：[任务名称]

**Session：** discord:1488795270769676318
**创建时间：** YYYY-MM-DD HH:MM
**状态：** IN_PROGRESS | COMPLETED | PAUSED

## 当前任务

> 任务 3 — 实现登录 API（进行中）

## 检查清单

- [x] 任务 1 — 数据库设计
- [x] 任务 2 — 用户模型创建
- [>] 任务 3 — 实现登录 API（进行中）
- [ ] 任务 4 — 实现注册 API
- [ ] 任务 5 — 单元测试

## 备注

执行过程中的记录...

## 检查结果

完成后填写...

触发场景

核心逻辑：步骤分析

接收到任务后，快速评估其所需执行步骤数量：

1–2 步 → 直接执行，无需生成计划

• "重命名一个文件"
• "删除那个测试文件"

3–5 步 → 可选生成计划（向用户确认）

• "帮我构建一个登录功能"

5 步以上 → 自动触发 PDCA 流程

• "构建一个包含注册和登录功能的完整用户系统"
• "将该项目从 React 重构为 Vue"

步骤分析维度

关键词触发

当用户显式提出以下请求时，无论步骤数量多少，均立即触发 PDCA：

• "拆解"、"分解"、"计划"、"检查清单"
• "计划"、"检查清单"、"待办事项"、"追踪"

会话绑定

plan.md 记录会话 ID

**Session：** discord:1488795270769676318

唤醒后分类展示

当前会话中未完成的计划：
1. plan.md — 用户系统开发（2/5）

其他会话中未完成的计划：
2. plan-blog.md — 博客搭建（1/3） ← telegram:123456

中断恢复

两类中断场景

进度推断（主动检测）

1. 检查 Git 状态 — 是否存在未提交的变更
2. 检查文件修改时间 — 是否存在 10 分钟内被修改的文件
3. 比对任务描述 — 关键词匹配
4. 识别任务类型 — 代码/测试/部署/文档/通用任务
5. 请求用户确认 — 最终确认是否继续

恢复流程

唤醒 → on-start → 读取 plan.md → 检查 10 分钟内修改的文件
                                    ↓
                    "login_api.py 3 分钟前被修改，是否继续？"

消费机制

状态流转

CREATED → IN_PROGRESS → PAUSED ↔ RESUMED → COMPLETED → ARCHIVED

执行规则

• 一次仅处理一个任务
• 任务完成后立即标记为 [x]
• 若任务受阻，则跳过并记录原因

并发控制

• 同一时刻仅允许一个活跃计划
• 新任务到达时：若已有未完成计划 → 提示用户选择“继续上一个”还是“新建计划”

销毁机制

归档策略

清理命令

# 归档已完成计划
manage_plan.py archive

# 清理过期文件（超过 7 天）
manage_plan.py cleanup --days 7

# 列出全部计划
manage_plan.py list

使用方法

Agent 工作流

触发条件

当用户执行以下操作时，自动触发 PDCA：

• 询问未完成任务："哪些还没做？"、"还有哪些待办？"、"有没有未完成的任务？"
• 询问进度："进展如何？"、"检查进度"、"当前状态是什么？"
• 询问计划内容："计划是什么？"、"给我看看计划"
• 提交复杂任务（5 步以上）
• 显式请求："拆解"、"创建计划"、"生成检查清单"

Plan 阶段

1. 使用 analyze_steps.py 分析步骤数量
2. 若步骤 ≥ 5 → 创建 plan.md
3. 将计划内容输出给用户

Do 阶段

1. 逐项执行任务
2. 每完成一项任务 → 更新 plan.md
3. 向用户报告进度

示例：

「✓ 任务 1 完成（数据库设计）
→ 开始执行任务 2（用户模型创建）」

Check 阶段

1. 当用户询问 "哪些还没做？" → 运行 manage_plan.py on-start
2. 输出所有未完成计划及其进度
3. 示例响应：

「您当前有 1 个未完成计划：

**用户系统开发**（共 5 项，已完成 2 项）
✓ 数据库设计
✓ 用户模型创建
○ 实现登录 API（进行中）
○ 实现注册 API
○ 单元测试

下一任务：实现登录 API」

Act 阶段

1. 修复已识别的问题
2. 归档已完成计划

创建计划

# 简单创建
manage_plan.py create "用户系统" "数据库设计" "用户模型" "登录 API"

# 指定会话
manage_plan.py create "用户系统" "任务 1" "任务 2" 
  --session "discord:1488795270769676318"

# 指定输出文件名
manage_plan.py create "博客搭建" "购买域名" "部署" 
  --output plan-blog.md

更新状态

# 完成第 0 和第 1 项任务（索引从 0 开始）
manage_plan.py update plan.md --completed 0,1

# 标记第 2 项任务为当前进行中任务
manage_plan.py update plan.md --current 2

暂停 / 恢复

# 暂停
manage_plan.py pause plan.md --reason "等待 API 响应"

# 恢复
manage_plan.py resume plan.md

会话启动检查

# 检查当前会话中的未完成计划
manage_plan.py on-start . "discord:1488795270769676318"

进度检查

# 检查当前计划进度
manage_plan.py check plan.md

# 详细进度检查（含 Git 状态与文件修改分析）
python3 scripts/check_progress.py . plan.md

脚本列表

配置

默认工作区路径：~/.openclaw/workspace/
计划文件名：plan.md 或 plan-*.md
归档目录：archive/

安全性说明：

• 仅操作工作区目录内的 plan*.md 文件
• 不会修改任何非计划类文件
• 归档与清理操作仅影响 archive/ 目录
• 使用 --dry-run 参数可在实际删除前预览清理内容