\r \r

Triphasic Execution Framework v5.5\r

\r 执行 → 审查 → 推进。每次交互只做一件事，三者缺一不可。\r \r ---\r \r

⚠️ 监控能力边界（重要说明）\r

\r

全局模式 vs 临时调用\r

\r | 功能 | 全局模式（Global） | 临时调用（按需） |\r |------|-------------------|-----------------|\r | 问题记录 | ✅ 自动（Shell 命令失败/中断） | ✅ 任务结束后强制执行 |\r | 风险记录 | ✅ 自动（Shell 命令异常） | ✅ 任务规划时强制执行 |\r | 经验积累 | ❌ 手动调用 merge-to-lessons | ❌ 手动调用 merge-to-lessons |\r \r

全局模式的实际覆盖率\r

\r

✅ 全局模式可以监控：通过 exec_wrapper.py 执行的 Shell 命令。\r \r

• ✅ 能自动记录：\r
  • Shell 命令执行失败（退出码非零）\r
  • Shell 命令被中断（Ctrl+C / SIGTERM）\r
  • Shell 输出中匹配错误模式的文本\r \r
• ❌ 无法自动记录：\r
  • Read/Write/Edit 等直接工具调用\r
  • ToolSearch/DeferExecuteTool 等 API 调用\r
  • AI 推理错误、幻觉\r
  • 逻辑错误（命令成功执行但结果错误）\r \r 实际覆盖率：约 30-40%（仅 Shell 命令部分）\r \r

临时调用的实际行为\r

\r

⚠️ 重要：临时调用模式下，记录是任务结束后的强制步骤，不是可选的。\r \r

• ✅ 任务结束后强制记录：\r
  • 识别问题 → 必须调用 add\r
  • 识别风险 → 必须调用 add-risk\r
  • 任务完成 → 必须调用 merge-to-lessons\r \r
• ✅ 用户触发时必须执行：\r
  • 用户说"记录问题" → 立即调用 add\r
  • 用户说"记录风险" → 立即调用 add-risk\r
  • 用户说"总结经验" → 立即调用 merge-to-lessons\r \r ---\r \r

问题、风险、经验调用方式\r

\r

1. 问题记录（Problem Logging）\r

\r 触发时机：任务执行过程中发现错误/异常时\r \r

# 标准调用\r
python {SKILL_DIR}/scripts/problem_logger.py add \\r
  --scene "API测试" \\r
  --symptom "HTTP 503" \\r
  --cause "服务端限流" \\r
  --solution "增加重试机制" \\r
  --task "用户头像接口"\r
\r
# 最小调用（仅必填项）\r
python {SKILL_DIR}/scripts/problem_logger.py add \\r
  --scene "文件读取" \\r
  --symptom "FileNotFoundError"\r
```\r
\r
### 2. 风险记录（Risk Logging）\r
\r
**触发时机**：任务规划（Phase 1）时识别到潜在风险\r
\r
```bash\r
# 标准调用\r
python {SKILL_DIR}/scripts/problem_logger.py add-risk \\r
  --description "网络不稳定可能导致API调用失败" \\r
  --impact "用户体验下降，转化率降低" \\r
  --mitigation "增加重试机制和降级策略" \\r
  --task "用户头像接口"\r
\r
# 最小调用（仅必填项）\r
python {SKILL_DIR}/scripts/problem_logger.py add-risk \\r
  --description "第三方服务可能宕机"\r
```\r
\r
### 3. 经验积累（Lessons Learned）\r
\r
**触发时机**：任务完成后或定期（如每天/每周）\r
\r
```bash\r
# 合并问题清单和风险手册到经验教训登记册\r
python {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r
\r
# 查看统计\r
python {SKILL_DIR}/scripts/lessons_register.py stats\r
```\r
\r
---\r
\r
## 人机交互调用方式（与AI对话触发记录，v5.4 更新）\r
\r
### 触发指令示例\r
\r
#### 1. 任务执行后触发记录\r
\r
用户可以通过以下方式触发AI执行记录：\r
\r
```\r
用户：请审查上面执行的任务，记录问题和风险\r
\r
用户：任务结束了，帮我总结问题和经验\r
\r
用户：记录一下刚才的错误：API超时\r
\r
用户：帮我把今天的经验整理一下\r
\r
用户：记录一下风险：网络不稳定\r
```\r
\r
#### 2. 定时任务执行后触发记录（v5.4 新增）\r
\r
```\r
用户：定时任务跑完了，有问题要记录\r
\r
用户：审查刚才的定时任务，帮我记录问题\r
\r
用户：补充记录：merge-to-lessons 执行时有超时\r
\r
用户：刚才的定时任务有风险需要记录吗？\r
```\r
\r
### AI响应模板\r
\r
当用户触发记录时，AI应执行以下流程：\r
\r
```\r
### 📋 任务后记录\r
\r
**问题记录**：\r
python {SKILL_DIR}/scripts/problem_logger.py add \\r
  --scene "任务执行" \\r
  --symptom "错误描述" \\r
  --cause "原因分析" \\r
  --solution "解决建议" \\r
  --task "任务名称"\r
\r
**风险记录**：\r
python {SKILL_DIR}/scripts/problem_logger.py add-risk \\r
  --description "风险描述" \\r
  --impact "影响评估" \\r
  --mitigation "缓解措施" \\r
  --task "任务名称"\r
\r
**经验积累**：\r
python {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r
```\r
\r
### 强制记录规则\r
\r
> **⚠️ 重要**：每次任务执行完成后，AI必须执行以下记录步骤：\r
>\r
> 1. **任务结束时自动记录**（强制，非可选）：\r
>    - 回顾执行过程，识别问题 → 调用 `add`\r
>    - 回顾执行过程，识别风险 → 调用 `add-risk`\r
>    - 执行完成后 → 调用 `merge-to-lessons`\r
>\r
> 2. **用户触发时记录**（必须执行）：\r
>    - 用户说"记录问题" → 立即调用 `add`\r
>    - 用户说"记录风险" → 立即调用 `add-risk`\r
>    - 用户说"总结经验" → 立即调用 `merge-to-lessons`\r
>\r
> 3. **定时任务触发时记录**（必须执行）：\r
>    - 定时任务完成后推送摘要，用户回复"有问题要记录"\r
>    - 用户主动触发"审查刚才的定时任务"\r
\r
---\r
\r
## 定时任务集成（v5.4 更新）\r
\r
### WorkBuddy 定时任务命令\r
\r
在 WorkBuddy 中创建定时任务时，使用以下命令：\r
\r
#### 每日经验积累（推荐）\r
\r
**任务类型**：Shell 命令\r
**命令**：\r
```bash\r
python {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r
```\r
\r
**定时设置**（根据需求选择）：\r
- 每天 22:00：`0 22 * * *`\r
- 每天早上 08:00：`0 8 * * *`\r
\r
#### 定时检查未解决问题\r
\r
```bash\r
python {SKILL_DIR}/scripts/cron_helper.py\r
```\r
\r
### 定时任务人机交互方式（v5.4 新增）\r
\r
定时任务执行后，**也应该能触发人机交互记录**。有以下两种方式：\r
\r
#### 方式 1：定时任务完成后通知 + 人工触发\r
\r
定时任务执行后（如 `merge-to-lessons`），通过以下方式触发人机交互：\r
\r
1. **定时任务执行后发送通知**：\r
   - 任务完成后向用户发送摘要通知\r
   - 通知包含"有问题需要记录吗？"的交互提示\r
\r
2. **用户通过对话触发**：\r
   ```\r
   用户：定时任务跑完了，有问题要记录\r
   用户：审查刚才的定时任务，帮我记录问题\r
   \r
   AI：检测到定时任务执行，执行审查：\r
   → 问题记录：调用 add\r
   → 风险记录：调用 add-risk\r
   → 经验积累：调用 merge-to-lessons\r
   ```\r
\r
#### 方式 2：WorkBuddy 企微/消息推送 + 人工触发\r
\r
1. **定时任务完成后推送摘要**：\r
   - 合并的问题/风险/经验摘要\r
   - 包含"点击查看详情"或"有问题要补充吗"的链接\r
\r
2. **用户回复触发详细记录**：\r
   ```\r
   用户：补充记录问题：API超时\r
   \r
   AI：立即执行：\r
   python {SKILL_DIR}/scripts/problem_logger.py add \\r
     --scene "定时任务执行" \\r
     --symptom "API超时" \\r
     --task "每日经验积累"\r
   ```\r
\r
#### 定时任务人机交互命令\r
\r
| 触发场景 | 命令/操作 |\r
|---------|----------|\r
| 定时任务完成通知 | 推送摘要 + "有问题要记录吗？" |\r
| 用户主动补充记录 | `add` / `add-risk` 命令 |\r
| 用户要求审查 | 执行三个记录步骤 |\r
| 用户要求查看统计 | `lessons_register.py stats` |\r
\r
#### 推荐定时任务配置\r
\r
| 任务 | 命令 | 时间 | 人机交互 |\r
|-----|------|-----|---------|\r
| 每日经验积累 | `merge-to-lessons` | 22:00 | 推送摘要，用户可补充 |\r
| 每周问题审查 | `cron_helper.py` | 周一 09:00 | 推送未解决问题，用户可处理 |\r
| 定期风险检查 | `list --recent 50` | 每月1日 | 推送高风险项，用户可确认 |\r
\r
---\r
\r
## 设置界面（v5.1 更新）\r
\r
安装技能后首次运行 `install.py` 时，会自动弹出 HTML 设置界面（系统默认浏览器），引导用户完成初始配置。\r
\r
### 设置项说明\r
\r
| 设置项 | 选项 | 说明 |\r
|---|---|---|\r
| **默认调用方式** | 调用模式（按需） / 全局模式 | 控制技能激活方式 |\r
| **记录文件路径** | TRIPHASIC_HOME、Problems、Risks、Lessons、Logs | 未自定义时使用默认值 |\r
| **任务规划确认** | 询问确认后再执行 / 直接按照规划执行 | 控制 Agent 执行前是否请求确认 |\r
\r
### 当前配置\r
\r
> **调用方式**：🟢 按需调用模式（默认）\r
> **数据目录**：`~/.workbuddy/triphasic/`\r
> **任务规划确认**：询问确认后再执行\r
\r
（上方配置会根据实际设置值自动更新）\r
\r
### 再次呼出设置界面\r
\r
**方式 1：通过 Agent 对话（推荐）**\r
- 向 Agent 发送："打开 triphasic 设置"、"修改配置"、"打开设置界面"\r
- Agent 执行步骤：\r
  1. 运行 `python {SKILL_DIR}/scripts/settings.py --serve-only`，解析输出中的 `SERVER_STARTED:\x3Cport>`\r
  2. 调用 `webbrowser.open(f"http://localhost:{port}/")` 打开浏览器\r
  3. 轮询检查 `{SKILL_DIR}/.settings_done` 标志文件是否存在\r
  4. 检测到标志文件后，调用 `python -c "from settings import shutdown_server; shutdown_server()"` 关闭服务器\r
\r
**方式 2：手动运行脚本（终端）**\r
```bash\r
python {SKILL_DIR}/scripts/settings.py\r
```\r
（脚本会自动启动服务器、打开浏览器、阻塞等待设置完成）\r
\r
### 对话式设置（回退方案）\r
\r
当 HTML 设置界面无法打开时（例如浏览器不可用、系统无图形界面等），Agent 应通过对话方式收集配置。\r
\r
**触发条件：**\r
- Agent 调用 `webbrowser.open()` 失败（`--serve-only` 模式下）\r
- 用户明确说"使用对话方式设置"、"不用 HTML"\r
\r
**对话流程（Agent 必须严格遵循）：**\r
\r
```\r
步骤 1：确认默认调用方式\r
请确定默认调用方式（输入 1/2 选择）：\r
1. 按需调用模式（默认）-- 用户主动加载技能时才启用\r
2. 全局自动模式 -- 后台 daemon 监控，自动捕获异常\r
请输入（1 或 2）：\r
\r
步骤 2：确认数据目录路径\r
当前数据目录为：~/.workbuddy/triphasic/\r
- 确认请直接输入 y\r
- 更改请输入具体路径（例如：D:\my_data	riphasic）\r
请输入：\r
\r
步骤 3：确认任务规划\r
任务规划是否需要确认（输入 1/2 选择）：\r
1. 确认 -- 执行前询问用户\r
2. 无需确认 -- 直接按照规划执行\r
请输入（1 或 2）：\r
\r
步骤 4：总结配置\r
已收集配置：\r
- 调用方式：[用户选择]\r
- 数据目录：[用户路径]\r
- 任务确认：[true/false]\r
确认保存？（y/n）\r
\r
步骤 5：保存配置\r
Agent 执行：\r
  python {SKILL_DIR}/scripts/settings.py --save-config '{json}'\r
```\r
\r
**Agent 执行指令（对话式设置）：**\r
\r
1. 先尝试 `--serve-only` 方式打开 HTML 设置界面\r
2. 如果浏览器不可用，按上述对话流程逐步询问用户\r
3. 收集完配置后，构造 JSON，调用：\r
   ```bash\r
   python {SKILL_DIR}/scripts/settings.py --save-config '{json_string}'\r
   ```\r
4. 检查退出码：0 表示成功，向用户确认"✅ 设置已保存"\r
\r
**对话式设置完成后的操作：**\r
1. 将用户选择写入 `TRIPHASIC_HOME/config.json`\r
2. 调用 `update_skill_md()` 更新 `SKILL.md`\r
3. 向用户确认"设置已保存"\r
\r
---\r
\r
## 双模式设计（v4.1 核心更新）\r
\r
### 核心理念：用户习惯决定启动方式\r
> **当前配置：🟢 按需调用模式（默认）**\r
\r
| 维度 | 按需调用模式（默认） | 全局自动模式（可选） |\r
|---|---|---|\r
| **触发条件** | 用户主动加载技能 | 配置 `mode: global` + 启动 daemon |\r
| **记录行为** | 调用时才记录三步框架 | 所有任务自动应用三步框架 |\r
| **后台守护** | 不启动 daemon | `problem_daemon.py` 持续监控 |\r
| **异常捕获** | 靠 Agent 主动调用 CLI 命令记录 | 自动捕获 + 写入 PROBLEMS.md |\r
| **适用场景** | 日常简单任务、跨平台协作 | 复杂多步骤项目、长期维护 |\r
\r
### 按需调用模式（默认，符合"不调用就不记录"习惯）\r
\r
用户主动加载技能后，Agent 遵循三步框架，通过 CLI 命令手动记录问题。\r
\r
### 全局自动模式（可选，适合长期项目）\r
\r
```bash\r
# 安装时选择 global 模式\r
python install.py --mode global\r
\r
# 启动守护进程（仅一次）\r
python problem_daemon.py start\r
\r
# 此后所有命令异常 → 自动捕获 → 自动写入 PROBLEMS.md\r
```\r
\r
注意：daemon 不自启，必须手动 `problem_daemon.py start`。\r
\r
---\r
\r
## 跨平台通用化设计（v4.1 核心更新）\r
\r
核心逻辑 = Python CLI，不依赖任何 Agent 平台。安装路径由调用方决定。\r
\r
```bash\r
# 安装路径由调用方通过 --target 或 TRIPHASIC_SKILL_DIR 指定\r
python install.py --target /path/to/skills\r
\r
# 数据目录由调用方通过 --home 或 TRIPHASIC_HOME 指定\r
python problem_logger.py --home /path/to/data init\r
```\r
\r
| 平台 | 集成方式 | 是否必须 |\r
|---|---|---|\r
| **WorkBuddy** | `execute_command` 调用 CLI | 可选（纯 CLI 也可用） |\r
| **Cursor** | Terminal 运行 CLI | 可选 |\r
| **VS Code** | 任务运行器调用 CLI | 可选 |\r
| **纯手动** | 直接运行 Python 脚本 | 原生支持 |\r
\r
---\r
\r
## 核心规则\r
\r
### Phase 1 -- 执行 (EXECUTE)\r
- 执行前**重述任务目的**，确认当前步骤要达成什么\r
- 实际运行命令、调用工具、测试代码\r
- 只跑一个主要命令（可并行多个独立命令）\r
- 不提前分析结果，不跳到审查阶段\r
\r
### Phase 2 -- 审查 (REVIEW)\r
- 分析执行结果，对照**任务目的**给出明确判断：✅成功 / ❌失败 / ⚠️部分\r
- 列出具体证据（数据、错误码、状态）\r
- 不执行新操作\r
\r
### Phase 3 -- 推进 (ADVANCE)\r
- 基于审查结论决定下一步\r
- 明确：继续 / 换方向 / 结束 / 向上返回\r
- **更新进度追踪表**，标记当前步骤状态\r
- 不直接执行，只规划\r
\r
---\r
\r
## 临时进度文件机制（v5.6 核心更新）\r
\r
### 为什么需要临时进度文件\r
\r
> **问题**：任务执行中途意外中断（会话超时、网络断开、AI 重启）后，进度全部丢失，重新执行时不知道从哪里继续。\r
\r
> **解决方案**：任务规划后立即创建临时进度文件，每步执行后更新，任务完成后删除。中断后读取文件即可恢复。\r
\r
### 核心原理\r
\r
```\r
任务规划\r
  └─→ 创建临时进度文件（init）\r
         │\r
         ├─ 步骤1 执行 → 更新文件（update）\r
         ├─ 步骤2 执行 → 更新文件（update）\r
         ├─ 步骤3 执行 → 更新文件（update）\r
         │   ...\r
         │\r
         └─ 任务完成 → 删除进度文件（complete）\r
             中断/异常 → 保留文件，下次 resume 恢复\r
```\r
\r
### 文件路径与命名\r
\r
| 项目 | 说明 |\r
|------|------|\r
| **目录** | `TRIPHASIC_HOME/.active_tasks/` |\r
| **命名** | `{任务名}_{时间戳}.json` |\r
| **编码** | UTF-8 |\r
| **格式** | JSON（机器可读）+ 配套 Markdown 摘要（人类可读） |\r
\r
例：`修复登录Bug_20260518_195030.json`\r
\r
### 生命周期\r
\r
| 阶段 | 命令 | 调用时机 | 文件状态 |\r
|------|------|---------|---------|\r
| 创建 | `init` | 任务规划后，执行前 | 新建文件，状态 `active` |\r
| 更新 | `update` | 每步 Execute→Review→Advance 后 | 更新对应步骤状态 |\r
| 恢复 | `resume` | 中断后、用户问"继续上次任务" | 读取文件，输出恢复信息 |\r
| 完成 | `complete` | 所有步骤成功，任务结束 | 删除文件 |\r
| 中止 | `abort` | 用户取消任务 | 标记 `aborted`，保留文件 |\r
| 清理 | `clean` | 定期维护 | 删除 `completed`/`aborted` 状态文件 |\r
\r
### AI 调用时机（强制执行）\r
\r
| 时机 | 必须调用的命令 | 说明 |\r
|------|----------------|------|\r
| 任务规划输出后、执行前 | `init` | 创建进度文件，记录规划和步骤 |\r
| 每个步骤 Execute 开始前 | `update --step N --status running` | 标记步骤为执行中 |\r
| 每个步骤 Review 后 | `update --step N --status success/failed --review "..."` | 更新审查结论 |\r
| 每个步骤 Advance 后 | `update --step N --advance "..."` | 更新推进决策 |\r
| 任务全部完成后 | `complete` | 删除进度文件 |\r
| 用户说"继续"、"恢复"、"刚才做到哪了" | `resume` | 读取进度文件，输出恢复信息 |\r
| 用户说"取消任务"、"停止" | `abort --reason "..."` | 标记中止，保留文件备查 |\r
\r
### 命令速查\r
\r
```bash\r
# 初始化（任务规划后调用）\r
python {SKILL_DIR}/scripts/task_progress.py init \\r
  --task "修复登录Bug" \\r
  --purpose "修复Token验证缺失" \\r
  --requirements "添加Token验证逻辑" \\r
  --risks "可能影响正常登录" \\r
  --steps '[{"description":"读取代码","purpose":"理解逻辑","tool":"Read"},{"description":"修复代码","purpose":"添加验证","tool":"Edit"}]'\r
\r
# 更新步骤状态（每步后调用）\r
python {SKILL_DIR}/scripts/task_progress.py update \\r
  --task "修复登录Bug" \\r
  --step 1 \\r
  --status success \\r
  --review "代码已读取，发现Token验证缺失" \\r
  --advance "继续步骤2"\r
\r
# 步骤失败重试\r
python {SKILL_DIR}/scripts/task_progress.py update \\r
  --task "修复登录Bug" \\r
  --step 2 \\r
  --status failed \\r
  --review "语法错误，第45行缺少冒号" \\r
  --advance "修复后重试" \\r
  --error "SyntaxError: invalid syntax"\r
\r
# 恢复中断任务\r
python {SKILL_DIR}/scripts/task_progress.py resume --task "修复登录Bug"\r
\r
# 列出所有活跃任务\r
python {SKILL_DIR}/scripts/task_progress.py list\r
\r
# 完成任务（删除进度文件）\r
python {SKILL_DIR}/scripts/task_progress.py complete --task "修复登录Bug"\r
\r
# 中止任务（保留文件）\r
python {SKILL_DIR}/scripts/task_progress.py abort --task "修复登录Bug" --reason "用户取消"\r
\r
# 清理已完成/中止的任务文件\r
python {SKILL_DIR}/scripts/task_progress.py clean\r
```\r
\r
### 恢复流程（AI 看到 resume 输出后）\r
\r
```\r
[恢复信息]\r
任务名称: 修复登录Bug\r
创建时间: 2026-05-18T19:50:30\r
最后更新: 2026-05-18T20:15:45\r
当前状态: active\r
\r
任务目的: 修复Token验证缺失导致的认证绕过漏洞\r
具体要求: 添加Token验证逻辑，确保未携带有效Token的请求被拒绝\r
\r
进度追踪：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ✅    │  0     │ 成功       │ 继续→步骤2 │\r
  │  2   │  ❌    │  1/3   │ 语法错误   │ 重试       │\r
  │  3   │  ⏳    │  -     │     -      │     -      │\r
  │  4   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：1/4（25%）▸ 当前：步骤2（重试中）\r
\r
[AI 行动]\r
→ 重述任务目的："继续修复登录Bug，当前在步骤2（分析错误日志），上次失败原因：语法错误"\r
→ 从步骤2继续执行\r
→ 如果步骤2重试仍失败，换方案处理步骤3\r
```\r
\r
### 进度文件 JSON 结构\r
\r
```json\r
{\r
  "task_name": "修复登录Bug",\r
  "plan": "【任务规划】内容...",\r
  "status": "active",\r
  "created_at": "2026-05-18T19:50:30",\r
  "updated_at": "2026-05-18T20:15:45",\r
  "total_steps": 4,\r
  "completed_steps": 1,\r
  "steps": [\r
    {\r
      "index": 1,\r
      "description": "读取登录接口代码",\r
      "purpose": "获取当前代码，理解认证逻辑现状",\r
      "tool": "Read",\r
      "status": "success",\r
      "retries": 0,\r
      "review": "成功读取，发现Token验证缺失",\r
      "advance": "继续步骤2",\r
      "started_at": "2026-05-18T19:51:00",\r
      "completed_at": "2026-05-18T19:51:30",\r
      "error_detail": ""\r
    },\r
    {\r
      "index": 2,\r
      "description": "分析错误日志定位问题",\r
      "purpose": "从日志中找到Token验证缺失的具体证据",\r
      "tool": "Bash(grep)",\r
      "status": "failed",\r
      "retries": 1,\r
      "review": "语法错误，第45行缺少冒号",\r
      "advance": "修复后重试",\r
      "started_at": "2026-05-18T19:52:00",\r
      "completed_at": "2026-05-18T19:52:30",\r
      "error_detail": "SyntaxError: invalid syntax (login.py, line 45)"\r
    }\r
  ],\r
  "context": {\r
    "workspace": "C:/Users/sm001/WorkBuddy/project",\r
    "purpose": "修复Token验证缺失导致的认证绕过漏洞",\r
    "requirements": "添加Token验证逻辑",\r
    "risks": "修改可能影响正常登录流程"\r
  }\r
}\r
```\r
\r
### 与 MEMORY.md 的配合\r
\r
| 机制 | 用途 | 生命周期 |\r
|------|------|---------|\r
| **临时进度文件** | 任务级进度恢复（中断后继续） | 任务创建→任务完成/中止 |\r
| **MEMORY.md** | 跨任务经验积累（长期记忆） | 永久保留，定期整理 |\r
\r
**恢复顺序**（中断后）：\r
1. 读取临时进度文件 → 恢复任务执行进度\r
2. 读取 MEMORY.md → 恢复用户偏好、项目约定\r
3. 继续任务执行\r
\r
---\r
\r
## 任务规划与拆分（v5.5 核心更新）\r
\r
### 核心原则：规划必做，拆分看规模\r
\r
> **⚠️ 关键区分（v5.5 强制）**：\r
> - **任务规划**：**所有任务必须执行**，无论大小。规划 = 明确任务目的、要求、工具、预期结果。\r
> - **任务拆分**：**仅大任务执行**（3步以上）。拆分 = 将大任务分解为多个子步骤。\r
>\r
> **判断标准**：如果任务可以一步完成（如读一个文件、执行一个命令），仍需规划但不需拆分。\r
\r
### 判断流程\r
\r
```\r
收到任务\r
  │\r
  ├─ 第一步：任务规划（必做，所有任务）\r
  │   → 明确：任务目的、具体要求、使用工具、预期结果、潜在风险\r
  │\r
  ├─ 第二步：判断是否需要拆分\r
  │   ├─ 单步任务（1个操作可完成）→ 直接进入执行\r
  │   └─ 多步任务（2个以上操作）→ 任务拆分，列出子步骤\r
  │\r
  └─ 第三步：进入 Execute→Review→Advance 循环\r
```\r
\r
### 一、任务规划模板（所有任务必做）\r
\r
每个任务（无论大小）开始前，**必须**输出以下规划：\r
\r
```\r
【任务规划】任务名称\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
📌 任务目的：[一句话说明为什么要做这个任务，最终要达成什么]\r
📋 具体要求：[用户的核心要求，必须满足的条件]\r
🔧 执行工具：[使用什么工具或命令]\r
✅ 预期结果：[成功后的具体状态或输出]\r
⚠️ 潜在风险：[可能出现的问题]\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
**请确认执行（输入选项，调整请同时说明要求）**：\r
1. 执行全部（包括问题/风险/经验记录）\r
2. 执行但跳过问题/风险/经验记录\r
3. 取消任务\r
4. 调整任务\r
\r
请输入：\r
```\r
\r
> **执行前重申**：每个步骤开始前，AI必须重述该步骤的**任务目的**和**具体要求**，确保不偏航。\r
\r
### 二、任务拆分模板（仅大任务，3步以上）\r
\r
当任务需要多步执行时，在任务规划基础上**追加**拆分步骤：\r
\r
```\r
📌 任务目的：[一句话说明]\r
📋 具体要求：[核心要求]\r
⚠️ 潜在风险：[整体风险]\r
\r
**执行步骤**：\r
  步骤 1: [操作描述]\r
    - 任务目的：[这一步要达成什么，为什么需要这一步]\r
    - 工具/命令：`[具体工具或命令]`\r
    - 操作说明：`[具体要做什么]`\r
    - 预期结果：`[预期输出或状态]`\r
    - 潜在风险：`[可能的问题或风险]`\r
\r
  步骤 2: [操作描述]\r
    - 任务目的：[这一步要达成什么]\r
    - 工具/命令：`[具体工具或命令]`\r
    - 操作说明：`[具体要做什么]`\r
    - 预期结果：`[预期输出或状态]`\r
    - 潜在风险：`[可能的问题或风险]`\r
  ...\r
\r
**进度追踪**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ⏳    │  -     │     -      │     -      │\r
  │  2   │  ⏳    │  -     │     -      │     -      │\r
  │  3   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：0/3（0%）\r
```\r
\r
**字段说明**：\r
\r
| 字段 | 必填 | 说明 |\r
|------|------|------|\r
| 任务目的 | ✅（v5.5 新增）| 这一步要达成什么目标，为什么需要这一步 |\r
| 工具/命令 | ✅ | 使用什么工具（Read/Write/Bash/Edit等）或具体命令 |\r
| 操作说明 | ✅ | 具体要执行什么操作 |\r
| 预期结果 | ✅ | 预期成功后的输出或状态 |\r
| 潜在风险 | ✅ | 可能出现的问题、中断、失败情况 |\r
\r
> **⚠️ 任务目的**：每步的"任务目的"字段是防止偏航的关键。AI执行前必须重述目的，执行后审查时必须对照目的判断是否达成。\r
\r
### 三、进度追踪机制（v5.5 新增）\r
\r
> **核心目的**：每执行完一个步骤，立即在进度追踪表中标记状态，让执行进度一目了然。\r
\r
**状态标记规则**：\r
\r
| 标记 | 含义 | 说明 |\r
|------|------|------|\r
| ⏳ | 待执行 | 初始状态 |\r
| 🔄 | 执行中 | 正在执行 |\r
| ✅ | 成功 | 审查通过，一次完成 |\r
| ❌ | 失败 | 需要重试或换方案 |\r
| ⏭️ | 跳过 | 经评估无需执行 |\r
\r
**每步执行后必须更新进度表**：\r
\r
```\r
### 🔧 [EXECUTE] - 步骤 2\r
🔧 执行前重述目的：分析错误日志定位问题\r
（执行操作...）\r
\r
### 🔍 [REVIEW] - 步骤 2\r
✅成功 -- 找到 Token 验证缺失的具体行号\r
\r
### 📍 [ADVANCE] - 步骤 2\r
推进：继续步骤 3\r
\r
**进度更新**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ✅    │  0     │ 成功       │ 继续→步骤2 │\r
  │  2   │  ✅    │  0     │ 成功       │ 继续→步骤3 │\r
  │  3   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：2/3（67%）▸ 下一：步骤3\r
```\r
\r
**重试时的标记**：\r
\r
```\r
### 🔧 [EXECUTE] - 步骤 3（重试 1/3）\r
🔧 执行前重述目的：修复代码，添加 Token 验证逻辑\r
（执行操作...）\r
\r
### 🔍 [REVIEW] - 步骤 3（重试 1/3）\r
❌失败 -- 语法错误，第45行缺少冒号\r
\r
### 📍 [ADVANCE] - 步骤 3（重试 1/3）\r
推进：修复语法后重试（剩余 2 次重试机会）\r
\r
**进度更新**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ✅    │  0     │ 成功       │ 继续→步骤2 │\r
  │  2   │  ✅    │  0     │ 成功       │ 继续→步骤3 │\r
  │  3   │  ❌    │  1/3   │ 语法错误   │ 重试       │\r
  │  4   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：2/4（50%）▸ 当前：步骤3（重试中）\r
```\r
\r
> **⚠️ 3次失败强制换方案**：同一步骤 3 次重试仍失败，必须在推进决策中写明换方案或向上回溯。\r
\r
### 四、单步任务示例（小任务，无需拆分）\r
\r
```\r
用户：读一下 config.json 的内容\r
\r
【任务规划】读取 config.json\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
📌 任务目的：获取 config.json 的配置内容，供后续分析使用\r
📋 具体要求：读取完整文件内容并展示\r
🔧 执行工具：`Read`\r
✅ 预期结果：完整文件内容输出\r
⚠️ 潜在风险：文件不存在、编码问题\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r
\r
### 🔧 [EXECUTE]\r
🔧 执行前重述目的：获取 config.json 配置内容\r
（读取文件...）\r
\r
### 🔍 [REVIEW]\r
✅成功 -- 文件读取完整，共 42 行\r
\r
### 📍 [ADVANCE]\r
推进：任务完成，进入记录步骤\r
\r
【任务完成】\r
- 目标：读取 config.json\r
- 结果：✅成功 -- 42行配置内容\r
- 经验教训：已合并到登记册\r
```\r
\r
### 五、强制记录步骤位置（所有任务必含）\r
\r
每个任务规划中，**必须**包含记录步骤位置：\r
\r
```\r
**📋 任务后强制记录**（必须执行，除非用户明确跳过）：\r
  → 问题记录：回顾执行过程，识别问题 → 调用 add\r
  → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r
  → 经验积累：执行完成后 → 调用 merge-to-lessons\r
```\r
\r
### 六、与设置联动（根据配置决定是否显示确认）\r
\r
> **设置项**：`require_task_confirmation`（任务规划确认）\r
\r
| 配置值 | 行为 |\r
|--------|------|\r
| `true`（询问确认后再执行，默认） | 显示完整确认选项（1/2/3/4） |\r
| `false`（直接按照规划执行） | 不显示确认，直接执行任务 |\r
\r
### 七、用户跳过机制\r
\r
- **默认行为**：问题/风险/经验记录是强制步骤\r
- **跳过条件**：用户明确选择"2"或说"跳过记录步骤"\r
- **跳过后**：执行任务但不记录，AI不再主动记录\r
- **不跳过**：按步骤1执行，任务结束后强制执行三个记录步骤\r
\r
### 八、调整任务流程（选项4）\r
\r
用户可在选择"4"的同时输入调整要求：\r
\r
```\r
用户：4 我想先在测试环境验证问题，再读代码\r
\r
AI：根据用户要求调整后的规划：\r
【任务规划】任务名称（已调整）\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
📌 任务目的：[更新后的目的]\r
📋 具体要求：[更新后的要求]\r
\r
**执行步骤**：\r
  [更新后的步骤列表，含任务目的字段]\r
\r
**进度追踪**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ⏳    │  -     │     -      │     -      │\r
  │  2   │  ⏳    │  -     │     -      │     -      │\r
  │  ... │        │        │            │            │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
\r
**📋 任务后强制记录**：...\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
**请确认执行（输入选项，调整请同时说明要求）**：\r
1. 执行全部（包括问题/风险/经验记录）\r
2. 执行但跳过问题/风险/经验记录\r
3. 取消任务\r
4. 调整任务\r
\r
请输入：\r
```\r
\r
> **说明**：调整任务后仍显示确认选项，用户可继续调整或选择执行\r
\r
### 九、简化确认（无图形界面时）\r
\r
```\r
【任务规划】任务名称\r
📌 目的：[一句话]\r
🔧 工具：[工具]\r
⚠️ 风险：[风险]\r
步骤: 1.[目的-操作-工具] 2.[目的-操作-工具]\r
记录: 问题/风险/经验总结（强制步骤）\r
\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）:\r
```\r
\r
---\r
\r
## 循环规则\r
\r
1. **规划先行** = 所有任务必须先输出任务规划，明确目的和要求\r
2. **临时文件持久化** = 规划后立即创建进度文件（init），每步更新（update），完成删除（complete）\r
3. **最小单元** = 单次工具调用，每步必须立即审查+推进\r
4. **最多 3 次重试** -- 3 次失败后必须换方案或向上回溯\r
5. **大任务才拆分** -- 3步以上任务输出步骤列表；单步任务只做规划不拆分\r
6. **每步更新进度** -- 执行后更新进度文件和进度追踪表\r
7. **完成后必须输出总结** -- 目标/结果/关键发现/异常记录，不可静默消失\r
8. **中断可恢复** -- 进度文件保留，重启后 resume 恢复\r
\r
## 禁止行为\r
\r
- ❌ 不做规划直接执行（无论任务大小）\r
- ❌ 不创建临时进度文件（规划后必须 init）\r
- ❌ 每步执行后不更新进度文件（必须 update）\r
- ❌ 任务完成后不删除进度文件（必须 complete）\r
- ❌ 连续执行不审查\r
- ❌ 只审查不推进\r
- ❌ 同一操作重复 3 次以上无策略调整\r
- ❌ 任务完成后不输出总结\r
- ❌ 遇到问题硬跑不换思路\r
- ❌ 步骤执行前不重述任务目的\r
- ❌ 执行后不更新进度追踪表\r
\r
---\r
\r
## 两种调用方式\r
\r
### 方式 1：直接调用（Skill 模式，推荐）\r
\r
Agent 加载本技能后，遵循三步框架。问题由 Agent 通过 `problem_logger.py` 自主记录。\r
\r
```bash\r
# 初始化数据目录（首次使用）\r
python {SKILL_DIR}/scripts/problem_logger.py init\r
\r
# 记录问题（任务执行中发现错误时）\r
python {SKILL_DIR}/scripts/problem_logger.py add \\r
  --scene "API测试" --symptom "HTTP 503" \\r
  --cause "服务端限流" --solution "增加重试机制"\r
\r
# 记录风险（任务规划时识别到潜在风险）\r
python {SKILL_DIR}/scripts/problem_logger.py add-risk \\r
  --description "网络不稳定可能导致API调用失败" \\r
  --impact "用户体验下降" \\r
  --mitigation "增加重试机制"\r
\r
# 搜索历史问题（执行前检索，避免重复踩坑）\r
python {SKILL_DIR}/scripts/problem_logger.py search "503"\r
\r
# 列出最近问题\r
python {SKILL_DIR}/scripts/problem_logger.py list --recent 10\r
\r
# 更新问题（补充原因/解决路径）\r
python {SKILL_DIR}/scripts/problem_logger.py update --id P001 --cause "xxx" --solution "yyy"\r
\r
# 生成经验教训登记册（任务完成后或定时调用）\r
python {SKILL_DIR}/scripts/problem_logger.py merge-to-lessons\r
```\r
\r
### 方式 2：注册为 exec 全局管理（Wrapper 模式）\r
\r
自动拦截所有 shell 命令，后台 daemon 实时监控异常。\r
\r
```bash\r
# 启动后台监控守护进程\r
python {SKILL_DIR}/scripts/problem_daemon.py start\r
\r
# 查看守护进程状态\r
python {SKILL_DIR}/scripts/problem_daemon.py status\r
\r
# 停止守护进程\r
python {SKILL_DIR}/scripts/problem_daemon.py stop\r
\r
# 使用 exec_wrapper 拦截命令\r
python {SKILL_DIR}/scripts/exec_wrapper.py "your command here"\r
```\r
\r
**全局注册（可选）：**\r
\r
```bash\r
# Linux/Mac (.bashrc / .zshrc):\r
export TRIPHASIC_HOME=~/.workbuddy/triphasic\r
alias exec="python3 {SKILL_DIR}/scripts/exec_wrapper.py"\r
\r
# Windows (PowerShell Profile):\r
$env:TRIPHASIC_HOME = "$env:USERPROFILE\.workbuddy	riphasic"\r
function exec { python "{SKILL_DIR}\scripts\exec_wrapper.py" @args }\r
```\r
\r
---\r
\r
## 数据目录\r
\r
所有数据存储在 `TRIPHASIC_HOME` 环境变量指定的目录：\r
\r
| 路径 | 说明 |\r
|------|------|\r
| `TRIPHASIC_HOME/.problem_logs/problems.jsonl` | JSONL 问题日志（机器可读，防丢失） |\r
| `TRIPHASIC_HOME/.problem_logs/daemon.log` | 守护进程运行日志 |\r
| `TRIPHASIC_HOME/.problem_logs/risks.jsonl` | JSONL 风险日志（机器可读，防丢失） |\r
| `TRIPHASIC_HOME/PROBLEMS.md` | 问题清单（人类可读） |\r
| `TRIPHASIC_HOME/RISKS.md` | 风险手册 |\r
| `TRIPHASIC_HOME/LESSONS_REGISTER.md` | 经验教训登记册 |\r
| `TRIPHASIC_HOME/.exec_output_pipe.txt` | exec 输出管道文件 |\r
| `TRIPHASIC_HOME/config.json` | 用户配置 |\r
\r
**当前配置**：`~/.workbuddy/triphasic/`（可通过设置界面修改）\r
\r
所有脚本支持 `--home` 参数覆盖，优先级：`--home` > `TRIPHASIC_HOME` > 默认值\r
\r
---\r
\r
## 安装（v4.1：路径由调用方决定）\r
\r
```bash\r
# 基础安装（按需调用模式，默认）\r
python install.py\r
\r
# 全局自动模式\r
python install.py --mode global\r
\r
# 指定安装路径（由 Agent/平台决定）\r
python install.py --target ~/.workbuddy/skills/\r
python install.py --target ~/.openclaw/workspace/skills/\r
\r
# 指定数据目录\r
python install.py --home ~/.myagent/triphasic/\r
\r
# 卸载\r
python install.py --uninstall\r
```\r
\r
---\r
\r
## 配置\r
\r
首次 `init` 后，编辑 `TRIPHASIC_HOME/config.json` 自定义：\r
\r
```json\r
{\r
  "enabled": true,\r
  "mode": "on_demand",\r
  "poll_interval_ms": 100,\r
  "error_patterns": ["error|Error|ERROR", "exception|Exception", "failed|Failed"],\r
  "auto_resolve_timeout_hours": 24,\r
  "daemon": {\r
    "enabled": false,\r
    "start_on_boot": false\r
  },\r
  "hooks": {\r
    "pre_exec_search": true,\r
    "auto_record_exception": true,\r
    "require_task_confirmation": true\r
  }\r
}\r
```\r
\r
> **当前配置（由设置界面写入，自动更新）：**\r
> 实际配置值存储在 `TRIPHASIC_HOME/config.json`，可通过运行 `python {SKILL_DIR}/scripts/settings.py` 查看和修改。\r
\r
- `mode`: `"on_demand"`（默认，按需调用）| `"global"`（全局自动）\r
- `daemon.enabled`: 仅 `mode=global` 时应设为 `true`\r
- `daemon.start_on_boot`: 始终 `false`，daemon 必须手动启动\r
\r
---\r
\r
## 完整示例\r
\r
### 示例 1：单步任务（小任务，只需规划不需拆分）\r
\r
```\r
用户：读一下 config.json 的内容\r
\r
【任务规划】读取 config.json\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
📌 任务目的：获取 config.json 的配置内容，供后续分析使用\r
📋 具体要求：读取完整文件内容并展示\r
🔧 执行工具：`Read`\r
✅ 预期结果：完整文件内容输出\r
⚠️ 潜在风险：文件不存在、编码问题\r
\r
**📋 任务后强制记录**（必须执行，除非用户明确跳过）：\r
  → 问题记录：回顾执行过程，识别问题 → 调用 add\r
  → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r
  → 经验积累：执行完成后 → 调用 merge-to-lessons\r
\r
**临时进度文件**：规划后自动创建，每步更新，完成后自动删除\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r
\r
→ AI 执行：首先创建临时进度文件\r
```bash\r
python {SKILL_DIR}/scripts/task_progress.py init \\r
  --task "读取config.json" \\r
  --purpose "获取 config.json 的配置内容，供后续分析使用" \\r
  --requirements "读取完整文件内容并展示" \\r
  --risks "文件不存在、编码问题" \\r
  --steps '[{"description":"读取文件","purpose":"获取配置内容","tool":"Read"}]'\r
```\r
\r
### 🔧 [EXECUTE]\r
🔧 执行前重述目的：获取 config.json 配置内容\r
→ 更新进度文件：步骤1 标记为 running\r
（读取文件...）\r
\r
### 🔍 [REVIEW]\r
✅成功 -- 文件读取完整，共 42 行\r
→ 更新进度文件：步骤1 标记为 success\r
\r
### 📍 [ADVANCE]\r
推进：任务完成，进入记录步骤\r
→ 更新进度文件：任务完成\r
\r
【任务完成】\r
- 目标：读取 config.json\r
- 结果：✅成功 -- 42行配置内容\r
- 经验教训：已合并到登记册\r
→ 删除临时进度文件：\r
```bash\r
python {SKILL_DIR}/scripts/task_progress.py complete --task "读取config.json"\r
```\r
```\r
\r
### 示例 2：多步任务（大任务，含拆分+进度追踪）\r
\r
```\r
用户：请帮我修复登录接口Bug\r
\r
【任务规划】修复登录接口Bug\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
\r
📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞\r
📋 具体要求：添加 Token 验证逻辑，确保未携带有效 Token 的请求被拒绝\r
⚠️ 潜在风险：修改可能影响正常登录流程\r
\r
**执行步骤**：\r
  步骤 1: 读取登录接口代码\r
    - 任务目的：获取当前代码，理解认证逻辑现状\r
    - 工具/命令：`Read`\r
    - 操作说明：读取 login.py 文件，找到 Token 验证逻辑\r
    - 预期结果：获取完整代码内容\r
    - 潜在风险：文件不存在、权限不足\r
\r
  步骤 2: 分析错误日志定位问题\r
    - 任务目的：从日志中找到 Token 验证缺失的具体证据\r
    - 工具/命令：`Bash`（grep）\r
    - 操作说明：在日志中搜索 "token" 关键词\r
    - 预期结果：找到 Token 验证缺失的具体行号\r
    - 潜在风险：日志格式不一致\r
\r
  步骤 3: 修复代码\r
    - 任务目的：添加缺失的 Token 验证逻辑\r
    - 工具/命令：`Edit`\r
    - 操作说明：在指定位置添加 Token 验证逻辑\r
    - 预期结果：代码修改成功，无语法错误\r
    - 潜在风险：语法错误、引入新bug\r
\r
  步骤 4: 测试验证\r
    - 任务目的：验证修复有效且未影响正常功能\r
    - 工具/命令：`Bash`（pytest）\r
    - 操作说明：运行测试用例验证修复\r
    - 预期结果：测试通过，登录功能正常\r
    - 潜在风险：测试环境问题\r
\r
**进度追踪**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ⏳    │  -     │     -      │     -      │\r
  │  2   │  ⏳    │  -     │     -      │     -      │\r
  │  3   │  ⏳    │  -     │     -      │     -      │\r
  │  4   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：0/4（0%）\r
\r
**📋 任务后强制记录**（必须执行，除非用户明确跳过）：\r
  → 问题记录：回顾执行过程，识别问题 → 调用 add\r
  → 风险记录：回顾执行过程，识别风险 → 调用 add-risk\r
  → 经验积累：执行完成后 → 调用 merge-to-lessons\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
请输入：1\r
\r
### 🔧 [EXECUTE] - 步骤 1\r
🔧 执行前重述目的：获取当前代码，理解认证逻辑现状\r
（读取 login.py...）\r
\r
### 🔍 [REVIEW] - 步骤 1\r
✅成功 -- 发现 Token 验证逻辑缺失\r
\r
### 📍 [ADVANCE] - 步骤 1\r
推进：继续步骤 2\r
\r
**进度更新**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ✅    │  0     │ 成功       │ 继续→步骤2 │\r
  │  2   │  ⏳    │  -     │     -      │     -      │\r
  │  3   │  ⏳    │  -     │     -      │     -      │\r
  │  4   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：1/4（25%）▸ 下一：步骤2\r
\r
...（继续执行步骤 2-4，每步更新进度表）\r
\r
### 🔧 [EXECUTE] - 步骤 3（重试 1/3）\r
🔧 执行前重述目的：添加缺失的 Token 验证逻辑\r
（编辑代码...）\r
\r
### 🔍 [REVIEW] - 步骤 3（重试 1/3）\r
❌失败 -- 语法错误，第45行缺少冒号\r
\r
### 📍 [ADVANCE] - 步骤 3（重试 1/3）\r
推进：修复语法后重试（剩余 2 次重试机会）\r
\r
**进度更新**：\r
  ┌──────┬────────┬────────┬────────────┬────────────┐\r
  │ 步骤 │ 状态   │ 重试   │ 审查结论   │ 推进决策   │\r
  ├──────┼────────┼────────┼────────────┼────────────┤\r
  │  1   │  ✅    │  0     │ 成功       │ 继续→步骤2 │\r
  │  2   │  ✅    │  0     │ 成功       │ 继续→步骤3 │\r
  │  3   │  ❌    │  1/3   │ 语法错误   │ 重试       │\r
  │  4   │  ⏳    │  -     │     -      │     -      │\r
  └──────┴────────┴────────┴────────────┴────────────┘\r
  进度：2/4（50%）▸ 当前：步骤3（重试中）\r
\r
...（重试成功后继续步骤4）\r
\r
【任务完成】\r
- 目标：修复登录接口Bug\r
- 结果：✅成功 -- Token验证已添加\r
- 进度：4/4（100%）\r
- 异常记录：步骤3重试1次\r
- 经验教训：已合并到登记册\r
```\r
\r
### 示例 3：用户选择调整任务（选项4）\r
\r
```\r
用户：请帮我修复登录接口Bug\r
\r
【任务规划】修复登录接口Bug\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
📌 目的：修复 Token 验证缺失\r
步骤: 1.[目的-Read] 2.[目的-grep] 3.[目的-Edit] 4.[目的-pytest]\r
记录: 问题/风险/经验总结（强制步骤）\r
\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 4 我想先在测试环境验证问题，再读代码\r
\r
AI：根据用户要求调整后的规划：\r
📌 任务目的：修复登录接口 Token 验证缺失导致的认证绕过漏洞（已调整：增加验证步骤）\r
\r
**执行步骤**：\r
  步骤 1: 测试环境复现问题\r
    - 任务目的：确认 Token 验证缺失确实存在\r
    - 工具/命令：`Bash`（curl）\r
    - 操作说明：发送登录请求，确认Token验证缺失\r
    - 预期结果：复现问题，获取错误响应\r
    - 潜在风险：测试环境不可用\r
\r
  步骤 2: 读取登录接口代码\r
    - 任务目的：获取代码，理解认证逻辑\r
    - 工具/命令：`Read`\r
    - 操作说明：读取 login.py 定位问题\r
    - 预期结果：获取完整代码内容\r
    - 潜在风险：文件不存在\r
\r
  步骤 3: 修复代码\r
    - 任务目的：添加 Token 验证逻辑\r
    - 工具/命令：`Edit`\r
    - 操作说明：添加 Token 验证逻辑\r
    - 预期结果：代码修改成功\r
    - 潜在风险：语法错误\r
\r
  步骤 4: 测试验证\r
    - 任务目的：验证修复有效\r
    - 工具/命令：`Bash`（pytest）\r
    - 操作说明：验证修复\r
    - 预期结果：测试通过\r
    - 潜在风险：测试失败\r
\r
**📋 任务后强制记录**：...\r
\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 1\r
```\r
\r
### 示例 4：用户跳过记录步骤\r
\r
```\r
用户：读一下 config.json 的内容\r
\r
【任务规划】读取 config.json\r
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\r
📌 目的：获取配置内容\r
🔧 工具：Read\r
步骤: 单步任务，无需拆分\r
记录: 问题/风险/经验总结（强制步骤）\r
\r
确认执行？（1.全部执行 2.跳过记录 3.取消 4.调整）: 2\r
\r
→ 执行任务，跳过问题/风险/经验记录步骤\r
\r
### 🔧 [EXECUTE]\r
🔧 执行前重述目的：获取 config.json 配置内容\r
（读取文件...）\r
\r
### 🔍 [REVIEW]\r
✅成功\r
\r
### 📍 [ADVANCE]\r
推进：任务完成\r
\r
【任务完成】\r
- 目标：读取 config.json\r
- 结果：✅成功\r
- 问题/风险/经验记录已跳过\r
```\r
\r
### 示例 5：定时任务人机交互\r
\r
```\r
【定时任务通知】22:00 每日经验积累\r
\r
✅ 经验积累已完成：\r
- 本周新增问题：3 条\r
- 本周新增风险：2 条\r
- 已合并到经验教训登记册\r
\r
💬 有问题要补充记录吗？\r
  回复"记录问题+描述"可补充记录\r
  回复"审查"可查看详情\r
```\r
\r
```\r
用户：补充记录，刚才merge有超时\r
\r
AI：立即执行：\r
python {SKILL_DIR}/scripts/problem_logger.py add \\r
  --scene "定时任务执行" \\r
  --symptom "merge-to-lessons 执行超时" \\r
  --cause "数据量过大" \\r
  --solution "考虑分批处理" \\r
  --task "每日经验积累"\r
\r
✅ 问题已记录：P0XX - merge超时\r
```\r
\r
---\r
\r
## 脚本清单（v5.6 更新）\r
\r
| 脚本 | 功能 | 依赖 |\r
|------|------|------|\r
| `install.py` | 安装/卸载（支持 --mode --target --home） | 无 |\r
| `settings.py` | HTML 设置界面（v5.0 新增） | 无 |\r
| `problem_logger.py` | 问题/风险 CRUD + 合并登记册（add/add-risk/list/search/update/merge-to-lessons） | 无 |\r
| `exec_wrapper.py` | 命令执行拦截器 | 无 |\r
| `problem_daemon.py` | 后台监控守护进程（仅全局模式） | 无 |\r
| `lessons_register.py` | 登记册管理（generate/diff/stats） | 无 |\r
| `cron_helper.py` | 定时任务钩子 | 无 |\r
| `task_progress.py` | 临时进度文件管理（init/update/resume/complete/abort/clean）**v5.6 新增** | 无（标准库） |\r
\r
所有脚本零外部依赖，仅使用 Python 标准库。跨平台支持 Windows/Linux/macOS。\r