| name | commander |
| description | 任务管理主入口。用于：(1) 使用 /commander start 启动新任务，(2) 使用 /commander status 查看全局状态，(3) 查看任务进度，(4) 继续执行任务，(5) 管理任务生命周期。启动任务前会自动检查用户画像新鲜度。 |
Commander
任务管理系统的主入口，协调整个工作流程。
角色定位
commander 是任务调度器，管理任务的完整生命周期。
职责边界
| ✅ 应该做 | ❌ 不应该做 |
|---|
| 管理任务状态（active/completed/archived） | 分析任务内容 |
| 调用 skill-generator 生成技能 | 直接生成技能文件 |
| 协调生成的技能执行 | 提取用户画像信息 |
| 创建任务结果目录（results/k01/） | 修改 .info/usr.json |
| 检查用户画像新鲜度 | 决定生成哪些技能 |
| 维护 tasks.json 的任务数据 | 决定技能的执行顺序 |
| 任务完成时询问是否升级 k_ 技能为 p_ 技能 | 直接修改技能文件 |
与其他 Skills 的关系
┌─────────────────┐
│ commander │ (任务调度器)
└────────┬────────┘
│
┌────────────────┼────────────────┐
↓ ↓ ↓
┌───────────────┐ ┌──────────────┐ ┌─────────────┐
│ user-profile │ │skill-generator│ │ k01_* skills │
│ (检查画像) │ │ (生成技能) │ │ (执行任务) │
└───────────────┘ └──────────────┘ └─────────────┘
- 对 user-profile：检查画像新鲜度，提示用户更新（不直接调用）
- 对 skill-generator：调用生成技能，接收技能列表
- 对 k_ 技能：协调执行顺序，跟踪进度
- 数据流：任务描述 → skill-generator → 技能列表 → commander → 执行协调
命令
| 命令 | 功能 |
|---|
/commander start [描述] | 启动新任务 |
/commander status | 显示全局状态 |
/commander progress k01 | 显示任务详细进度 |
/commander list | 列出所有任务 |
/commander results k01 | 显示任务结果文件 |
/commander continue k01 | 继续执行下一步 |
/commander complete k01 | 标记任务完成 |
/commander archive k01 | 归档已完成任务 |
/commander upgrade | 查看并升级已完成的任务技能 |
/commander cleanup | 清理低频技能（基于阈值） |
详见 命令详细说明
用户画像检查
启动任务前自动检查 info/ 目录是否有新文件，提示更新画像。
详见 画像检查流程
目录管理
每个任务在 results/k01/ 下创建独立目录：
results/k01/
├── README.md # 任务总览
├── plan.md # 任务计划
├── execution.md # 执行记录
├── notes.md # 笔记
├── .reasoning.md # 推理日志（实时维护）
└── artifacts/ # 生成的文件
详见 目录管理
推理日志
commander 在执行任务时会输出推理块，记录"用了什么方法"和"得到了什么结论"：
<reasoning>
🎯 目标：[当前步骤的目标]
🔍 方法：[使用了什么方法/工具]
💡 发现：[得到了什么发现/结论]
✅ 决策：[做出了什么决策及原因]
</reasoning>
推理块会通过 Hook 系统自动捕获：
- 写入
results/k01/.reasoning.md（任务级）
- 同时合并到
.info/.reasoning.md（全局，活跃任务）
自动维护机制
推理日志通过以下 Hooks 自动维护：
| Hook | 触发时机 | 作用 |
|---|
update-reasoning-on-task.sh | TaskCreate/TaskUpdate | 任务状态变化时更新推理日志 |
capture-reasoning.sh | Write/Edit .reasoning.md | 捕获推理块内容 |
fix-reasoning.sh | SessionStart | 修复损坏的推理文件 |
重要：每次任务操作（创建、更新）都会自动触发推理日志更新，无需手动维护。
查看推理日志：
cat .info/.reasoning.md - 查看全局活跃任务推理cat results/k01/.reasoning.md - 查看特定任务推理
任务状态
| 状态 | 说明 |
|---|
active | 进行中 |
completed | 已完成 |
archived | 已归档 |
详见 状态管理
错误处理
| 场景 | 处理方式 |
|---|
| 画像缺失 | 提示运行 /user-profile |
| 画像过期 | 提示更新，显示新文件 |
| tasks.json 损坏 | 重建默认结构 |
| 任务 ID 冲突 | 自动递增 next_id |
详见 错误处理
技能升级流程
自动检测机制
当任务完成时，detect-task-complete.sh Hook 会自动：
- 检测
TaskUpdate(status="completed")
- 扫描任务的 k_ 技能（如
k01_research, k01_write_article）
- 设置
tasks.json.tasks[k01].upgrade_pending = true
- 记录可升级技能列表到
upgrade_candidates
TaskUpdate(status="completed")
↓
[detect-task-complete.sh Hook]
↓
设置 upgrade_pending = true
↓
/commander upgrade 查看升级选项
手动触发升级
使用 /commander upgrade 命令查看所有待升级的任务：
/commander upgrade
↓
扫描 upgrade_pending=true 的任务
↓
显示可升级技能列表
↓
AskUserQuestion: 选择升级方式
↓
调用 promote-to-proven.sh 执行升级
技能分类
| 类型 | 前缀 | 来源 | 生命周期 | 上限 |
|---|
| 任务技能 | k_ | 任务创建时生成 | 临时，任务完成后可选升级 | 2-3个/任务 |
| 验证技能 | p_ | k_ 技能升级 | 永久，可被后续任务复用 | 10个 |
| 用户技能 | u_ | info/ 更新 | 永久，用户主动维护 | 5个 |
升级命令示例
/commander upgrade
📋 发现 1 个任务有待升级技能：
任务: k01 - 调研 openclaw 并写公众号推文
状态: 已完成
可升级技能:
• k01_research_openclaw
• k01_write_article
请选择升级方式：
- 全部升级 → 将所有技能升级为 p_ 技能
- 选择升级 → 自定义升级哪些技能
- 跳过 → 保留 k_ 技能，稍后处理
升级后效果
k01_research_openclaw → p_research_open_source
k01_write_article → p_article_techar
✅ 已创建: .claude/skills/p_*/
✅ 已更新: .info/tasks.json (proven_skills)
✅ 已归档: .claude/skills/.archived/k01_*/
