1仕組みと動作原理
本スキルの骨格は「3つの役割分担」です。リーダー(ユーザー)がアイデアを出し最終決定を行い、マネージャー(現在のエージェント)が調査・執筆・検収を担当し、実行者(ゴールモードのエージェント)が指示書を受け取って自律完走します。
三个角色:**领导**(用户)出想法、拍板;**管理者**(你)调研、写书、验收;**执行者**(目标模式里干活的 agent)拿书独立跑完。
執筆の前提は「実行者には質問相手がいない」ことです。指示書が唯一の真実(Single Source of Truth)であり、曖昧さは文字通りに誤認・実行されるため、「尋ねに来ること」のような曖昧なフォールバック表現は全面禁止です。
执行者一字不差地执行、把书当唯一真理、中途没人可问——写错的事实 100% 被执行,全文不许有「来找我」。
プロセスの最初のステップは質問ではなく「調査」です。自力で確認できる事項は一切質問せず、コードベースがある場合はコマンドの実在性やベースライン数値を手動で実測します。
**1 调研。**自己能查的一律不问。有代码库就实测
質問は2巡目に行い、1回につき5問以内(≤5問)にとどめ、各質問に2〜4つの選択肢と推奨案を提示します。調査不可能な業界知識は「仮説(未検証)」と明記します。
**2 提问,一轮 ≤5 个。**只问查不到且会改变任务书的:方向取舍、验收裁量、风险偏好、时间盒;每个给 2–4 个选项加推荐。
指示書には4000文字以内(≤4000文字、/goal コマンドの入力制限)という厳格な上限があります。収まらない場合はスコープが大きすぎるため、複数の独立したタスクに分割する必要があります。
**≤4000 字符,硬上限**(`/goal` 官方限制,超了粘不进去)。字符花在不查就会踩的坑上,不写执行者打开仓库一眼能看到的事实;砍调研过程、重复规矩、背景故事。压不进就是活太大——拆成独立几件,一次给一件。
実行型と探索型の振り分け:検収コマンドが定義可能な場合は実行型仕様を適用し、リーダーが答えそのもの(調査・選定)を求めている場合は探索型を適用します。これにより、形だけの穴埋め回答を防ぎます。
**先分型**:动笔前能写出验收命令的是**执行型**,全套照走。领导要答案本身(调研、选型、该不该做 X)的是**探索型**——硬指标只会收到凑数的答案,改四处见 anatomy.md。
「5つの失敗パターン」の防止が本スキルの最も実践的なアプローチです。不正合格(.skipの追加/アサーションの緩和/モック化/テスト削除)、コマンドの幻覚、コンテキスト喪失、無謀な試行錯誤、サイレント障害に対し、それぞれ具体的な対策(ベースライン後退の禁止、コマンド実走確認、PROGRESS.md、3回連続失敗時のアプローチ変更、ネガティブテスト)を講じます。
**防它五种死法**: 1. **作弊达标**(最重要):说「让测试绿」,最省力的是加 `.skip`、放松断言、mock 被测对象、删测试、`|| true`——不是它坏,是目标函数写错。对策:基线不可退(测试数/覆盖率 ≥ 基线、skipped 0)、点名禁止具体姿势、判卷标准冻结、暗卷自留。若「测试要绿」与「实现不许改」冲突而代码真有 bug:点破并给方法(characterization test:锁当前行为+标 KNOWN DEFECT),否则它必偷改实现 2. **幻觉命令**:它会平静地编造命令再甩锅环境——书里每条命令你必须亲手跑过,摸不到就写进任务 0 让它查实 3. **失忆**:进度写 `PROGRESS.md`,接手会话先读它别重做;任务 0 过后先写 ≤10 行开工回执(理解的目标/顺序/最大风险)再动工;单任务一个会话内做得完 4. **一条道走到黑**:任务 0 兼前提核验,量出的数字对不上就停;同一验收连败 3 次换项;结果比基线差就回滚如实报告——「没做成但说清了」合格,「做了但更糟」不合格 5. **静默事故**:坏了不发信号的(假绿灯、失效报警器)配反向验证
「ルール(禁止事項)」と「情報(推奨事項)」の分離:禁止事項はすべて実測結果またはリーダーの決定に紐づけ、推奨事項は実行者の裁量に任せてPROGRESS.mdに理由を記録させます。
**法与情报分家**:「不许」是法,违反即不合格,每条溯源到一次实测或一次领导裁决;「建议」是情报,执行者有更好的路可以走、在 `PROGRESS.md` 记一句为什么。把情报写成法,是替执行者做它临场更懂的决定。
マルチエージェント並行分割はリーダーの承認がある場合のみ実施し、各指示書に同一の「全体像」(全体目標、担当範囲、結合ポイント)を含め、対象ディレクトリを分離して共有書き込み先を単一に限定します。
## 多 agent 并行(领导点头才拆) 每份书带同一段「全局」(整体干什么、谁管哪段、接缝在哪——接缝没人接是头号事故)。
納品規律:最終回答は3つの要素のみ(1行の使い方 + コピー可能なタスク指示書ブロック + 1行の結び)とし、過程のノイズは一切含めません。ブラインドテスト(実行者には見せない2〜3項目の抜き打ちチェック)はチャット側に保持し、指示書には含めません。
**4 交付。**最终回复只有三样,过程噪音(调研表格、中途更正、分析过程)一概不带: - 一句用法:「在执行 agent 那边输 `/goal `,粘贴下面整段,发出去。」(`/goal` 是斜杠命令,没有单独输入框;没有目标模式的工具就直接粘贴发送。)附导读:领导只看三处——开头「这活为什么干」两行、「我替领导拍的板」、末尾「完成条件」的两条硬指标。 - 任务书代码块,整块可复制。 - 一句收尾:「跑完回来说一声,我来验收,给你 5 行内的人话报告。」 **一个目标、一次粘贴。**不许第二条 `/goal`、不许让领导存文件、不许发明开工命令。 **5 验收,是管理者的活。**明卷(验收命令)在书里,目标模式自己盯;暗卷——2–3 条执行者看不见的抽查——自留在会话侧 scratchpad,不进书。
2コア機能
4推奨統制措置と判定根拠
- SKILL.md: 純粋なプロンプト指示およびルールテキストであり、スクリプト実行や外部への副作用はありません。
5二重目の独立検証
- [ok] 无脚本 / 无端点 / 无凭证 — 三文件 token 扫描全零命中(含 URL 与工具名);目录仅 3 个 markdown。
- [ok] 无写盘指令 — SKILL.md 不要求本 agent 写文件;PROGRESS.md / BLOCKED.md 是任务书里要写给执行者的机制,暗卷是「自留在会话侧 scratchpad」。
- [ok] 「≤4000 字符」的出处与一致性 — SKILL.md 写「**≤4000 字符,硬上限**(`/goal` 官方限制,超了粘不进去)」;anatomy.md 写「整本 ≤4000 字符,单任务的书通常 1500–2000」;自检 1 再确认。三处一致。
- [ok] anatomy.md 与主文件的六节结构 — anatomy.md 开头「六节,顺序固定:「我替领导拍的板」放最前…「完成条件」放最后(两条硬指标收拢一切)」;主文件写书规则节的「任务书六节的结构规格与探索型改法见 references/anatomy.md」。
- [ok] 防作弊对策是否可执行 — 给出具体姿势黑名单(`.skip`、放松断言、mock 被测对象、删测试、`|| true`)与基线不可退(测试数/覆盖率 ≥ 基线、skipped 0)、判卷标准冻结、暗卷自留四项对策。
- [ok] 法/情报分家 — 原文「「不许」是法,违反即不合格,每条溯源到一次实测或一次领导裁决;「建议」是情报,执行者有更好的路可以走、在 `PROGRESS.md` 记一句为什么」。
- [ok] 提问上限与选项格式 — 「**2 提问,一轮 ≤5 个。**」+「每个给 2–4 个选项加推荐」+「要拆多份并行必须在这轮问」。
- [ok] 验收隔离(暗卷不进书) — 「暗卷——2–3 条执行者看不见的抽查——自留在会话侧 scratchpad,不进书」与自检第 5 条「暗卷自留没进书」互相印证。
6結論
0f1d60fb834f833f…