| name | mission-runner |
| description | Agent 任务启动器 — 学完后能读一个 MISSION 文件, 按 5Q+1L 框架自主完成任务。配套 harness-run 脚本控制整个流程, 防闲聊防跑偏。跟 coding-to-coding skill 互补: 这个管"怎么干活", 那个管"怎么沟通"。 |
🎯 Mission Runner — 入职第二章: 你怎么开始一个任务
前置: 如果你还没学 coding-to-coding skill, 去学一下 (没学也能用, 但沟通会比较原始)
本 skill 教你: 拿到一个任务后, 怎么开始干活
这个 Skill 解决什么
新同事 Agent 拿到任务时常见的问题:
- ❌ 不知道从哪开始, 上来就敲代码
- ❌ 忘了先同步仓库, 基于旧版工作
- ❌ 前置资源缺失时硬上 (猜着干)
- ❌ 忘了验收标准, 做完了才发现漏了东西
- ❌ 把"做什么"和"怎么做"混在一起, 想一步干一步
Mission Runner 用 5Q+1L 框架 把这些都治了。
5Q+1L 是什么
这是 Harness 项目里的经验沉淀, 5 个问题 + 1 个灯塔:
| 问题 | 意思 |
|---|
| Q1 | 做什么 | 任务目标, 一句话说清楚 |
| Q2 | 看到什么 | 执行需要的前置资源 (代码/数据/环境) |
| Q3 | 记得什么 | 执行前必须读的上下文 (已知陷阱/相关文档) |
| Q4 | 不能做什么 | 明确的边界 (防止跑偏) |
| Q5 | 怎么知道对了 | 验收标准 (完成判定) |
| L | 灯塔 | 主路径不通时的 Plan B/C/D |
每个任务都是一个 MISSION 文件, 按这 6 节写。
工具: harness-run
这是你的任务启动器, 一条命令搞定:
bash <c2c-skills路径>/skills/mission-runner/scripts/harness-run <MISSION 文件路径>
例如:
bash ~/c2c-skills/skills/mission-runner/scripts/harness-run tasks/RU-002-sanity.md
它会:
- 强制
git pull --ff-only (失败就停, 不让你基于旧版干活)
- 打印 MISSION 文件内容给你看
- 打印 5Q+1L 顺序引导
- 退出, 把控制权还给你
接下来是你自己按 Q1→Q2→Q3→Q4→Q5→L 的顺序执行。
完整工作流 (你的第一天)
Step 1 — 收到任务
羊爸爸/Napoleon 给你一句话:
"跑 harness-run tasks/RU-002-sanity.md"
Step 2 — 启动
cd <你本地的 RevUnsup 或其他项目目录>
bash ~/c2c-skills/skills/mission-runner/scripts/harness-run tasks/RU-002-sanity.md
Step 3 — 按 5Q+1L 顺序自己走
Q1 做什么 — 读 MISSION 的 Q1 章节, 确认你理解任务目标 (不理解 → 开 issue 问)
Q2 看到什么 — 按 MISSION Q2 检查前置资源都在不在, 缺了就 agent-issue open (coding-to-coding 的技能)
Q3 记得什么 — 读 MISSION Q3 里列的所有上下文文档, 特别是"已知陷阱"
Q4 不能做什么 — 贴在脑门上, 一边干一边检查
Q5 怎么知道对了 — 心里记着验收标准, 不要干超
L 灯塔 — 主路径卡住时打开看备选
Step 4 — 干活
按你自己的方式完成任务, 产出 MISSION Q5 要的东西。
Step 5 — 自检
对照 MISSION Q5 的验收清单, 逐条打钩。没达标就继续干。
Step 6 — 交付
用 coding-to-coding skill 的 agent-save 命令提交:
agent-save "任务完成: RU-002-sanity" docs/sanity-check.md
Step 7 — 报告
用 agent-issue open 或微信告诉羊爸爸: "任务完成, 产出在 docs/sanity-check.md"
MISSION 文件格式 (重要)
完整模板: references/5q-1l-template.md
示范案例: examples/sanity-check-example.md
简版:
# <任务名>
## Q1 做什么
<一句话>
## Q2 看到什么
- 需要的资源 1
- 需要的资源 2
(缺失时: agent-issue open)
## Q3 记得什么
- 必读文档 1 (为什么要读)
- 必读文档 2
## Q4 不能做什么
- ❌ ...
- ❌ ...
## Q5 怎么知道对了
- [ ] 可验证的条件 1
- [ ] 可验证的条件 2
## L 灯塔
- 主路径: ...
- Plan B: ...
铁律
- 不 harness-run 就不开工 — 直接敲代码是在违反流程
- git pull --ff-only 失败立即停 — 不要 force, 不要自己 merge, 报告羊爸爸
- Q2 缺资源就停下问 — 不要自己找替代品
- Q4 的边界不能碰 — 哪怕你觉得你的方案更好, 改边界要先 issue 讨论
- Q5 没全打钩不算完成 — 诚实是第一位
跟其他 Skill 的关系
coding-to-coding (必学):
- Mission Runner 触发到 问问题 时 → 用它的
agent-issue open
- Mission Runner 触发到 交付 时 → 用它的
agent-save
- 本 Skill 不包含沟通命令, 全部复用 coding-to-coding
未来可能的 Skill (灯塔, 不急):
code-review — 多 Agent 互相 review 代码handover — 任务交接规范incident-report — 事故记录
常见错误 (新同事看)
错误 1: 直接敲代码不走 harness-run
后果: 基于旧版本工作, 漏掉 MISSION 里的陷阱提示, 做一半才发现跑偏。
修正: 永远先 harness-run, 再动手。
错误 2: Q2 缺资源自己找替代品
后果: 用错数据/错模型, 产出不可信。
修正: 停下来 agent-issue open, 等羊爸爸回。
错误 3: 跳过 Q3 直接干
后果: 撞上已知陷阱 (比如 RU-001 记录的 pow(thresh, 2.0))。
修正: Q3 列的每份文档都读一遍, 重点看"已知陷阱"。
错误 4: Q5 自欺欺人
后果: 报告说完成了, 其实没达标, 下一个环节崩盘。
修正: 逐条对照, 没达标就是没达标。
状态
v0.1 (2026-04-10) — 第一版
- ✅ SKILL.md (本文件)
- ✅ scripts/harness-run (最小 bash 脚本)
- ✅ references/5q-1l-template.md (空模板)
- ✅ examples/sanity-check-example.md (简化示范)
- ⏳ 依赖的 coding-to-coding 还是 v0.1 占位版 (agent-save/agent-issue 暂时只是概念, 要手动 git)
v0.1 / 2026-04-10 / c2c-skills 的第二个 Skill
