mission-runner

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

它会:

1. 强制 git pull --ff-only (失败就停, 不让你基于旧版干活)
2. 打印 MISSION 文件内容给你看
3. 打印 5Q+1L 顺序引导
4. 退出, 把控制权还给你

接下来是你自己按 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: ...

---

铁律

1. 不 harness-run 就不开工 — 直接敲代码是在违反流程
2. git pull --ff-only 失败立即停 — 不要 force, 不要自己 merge, 报告羊爸爸
3. Q2 缺资源就停下问 — 不要自己找替代品
4. Q4 的边界不能碰 — 哪怕你觉得你的方案更好, 改边界要先 issue 讨论
5. 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