repo-implement
yoshiysh/claude-plugins リポジトリの中で、コード・スクリプト・テスト・スキル・文書の実装・バグ修正・挙動の変更・リファクタを 頼まれたら使うこと。依頼をそのまま書き始めず、条件ごとのケース計画を含む計画を planner が立てて別の plan-reviewer が照らし、 承認後に implementer だけが書き、CLI が check を固定の argv で実測し、repo-review の独立レビューと上限つきの修正ループを経て、 作業ツリーが最後に check とレビューを通した状態のままかを CLI が照合してから報告する。 「この関数のバグを直して」「この CLI に option を足して」「この SKILL.md の手順を直して」「このスクリプトをリファクタして」 「さっきの repo-review の確定指摘を反映して直して」(PR に載っていないレビュー結果は依頼の文として受ける)を、 このリポジトリについて頼まれたら使う(Use when implementing, fixing, or refactoring code, tests, skills, or docs in the yoshiysh/claude-plugins repository)。 対象外: 新しいスキルの作成や best-practices への適合の評価・改稿(skill-creator-best-practices)、変更のレビューだけ(repo-review)、 GitHub の PR に付いたレビュー指摘への対応(address-review)、PRD・仕様書の作成(prd-spec)、別のリポジトリでの実装。 このリポジトリのレビュー結果の反映には、汎用の workflow:pr-review-fix でなくこれを使う。
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- repo-implement
- description
- yoshiysh/claude-plugins リポジトリの中で、コード・スクリプト・テスト・スキル・文書の実装・バグ修正・挙動の変更・リファクタを 頼まれたら使うこと。依頼をそのまま書き始めず、条件ごとのケース計画を含む計画を planner が立てて別の plan-reviewer が照らし、 承認後に implementer だけが書き、CLI が check を固定の argv で実測し、repo-review の独立レビューと上限つきの修正ループを経て、 作業ツリーが最後に check とレビューを通した状態のままかを CLI が照合してから報告する。 「この関数のバグを直して」「この CLI に option を足して」「この SKILL.md の手順を直して」「このスクリプトをリファクタして」 「さっきの repo-review の確定指摘を反映して直して」(PR に載っていないレビュー結果は依頼の文として受ける)を、 このリポジトリについて頼まれたら使う(Use when implementing, fixing, or refactoring code, tests, skills, or docs in the yoshiysh/claude-plugins repository)。 対象外: 新しいスキルの作成や best-practices への適合の評価・改稿(skill-creator-best-practices)、変更のレビューだけ(repo-review)、 GitHub の PR に付いたレビュー指摘への対応(address-review)、PRD・仕様書の作成(prd-spec)、別のリポジトリでの実装。 このリポジトリのレビュー結果の反映には、汎用の workflow:pr-review-fix でなくこれを使う。
02 资源文件 11
- 参考文档agents/implementer.md4.1 KB
- 参考文档agents/plan-reviewer.md2.7 KB
- 参考文档agents/planner.md4.4 KB
- 参考文档evals/evals.json5.6 KB
- 参考文档evals/trigger-evals.json1.9 KB
- 脚本scripts/implement-cli.mjs24.3 KB
- 脚本scripts/implement-cli.test.mjs40.6 KB
- 脚本scripts/implement-core.mjs26.9 KB
- 脚本scripts/implement-core.test.mjs25.6 KB
- 脚本scripts/implement.js9.9 KB
- 脚本scripts/plan.js16.0 KB
03 SKILL.md 正文
Repo implement
目次
目的と段
このリポジトリの変更を、計画 → 独立の計画レビュー → 実装(コードとテスト)→ 実測の check → 独立レビュー → 上限つきの修正で進める。決められる処理(状態の固定・段の順序・変更の照合・check の実行・修正の入力の選択・最終の照合)は scripts/implement-cli.mjs が行い、計画・照合・実装・レビューは別々の agent が行う。司令塔(このスキルを読む session)は段を選び、返り値を手を加えずに CLI と次の段へ写すだけで、成果物(コード・テスト・文書)を書かず、計画やレビューの合否を自分で決めない(司令塔の手修正は検証を通らずに成果物へ届く)。
| 段 | 担い手 | 書き込み |
|---|---|---|
| 開始 | CLI start |
repo の外の stateDir だけ |
| 計画 | 計画の Workflow(planner → plan-reviewer、上限つきで planner に戻す) | 無し |
| 受け入れ・開始時の check | CLI inventory・run-checks |
stateDir だけ |
| 実装・修正の回 | CLI begin-round → 実装の Workflow(implementer だけ)→ CLI inventory |
作業ツリー |
| check | CLI run-checks(plan の check を固定の argv で実行) |
check が書くもの |
| レビュー | repo-review スキル(working_tree モード)→ CLI record-review |
無し |
| 最終照合 | CLI verify |
無し |
書き込みのできる run には implementer だけを置く。runner は役ごとに書き込みの権限を分けられないので、同じ run に計画やレビューの役を置くと、その役も書けてしまう。commit(頼まれた commit は push まで含む。「最終照合と報告」)と PR の作成は利用者が頼んだときだけ行い、merge はしない。
CLI は段ごとの作業ツリーの snapshot を stateDir の記録に残し、次の段の始めに今の snapshot と照らす。段の外での書き込み(計画の段・券を閉じた後の実装の Workflow・check とレビューの間)は、次の段で E_STATE か changed_outside_steps として見つかる。記録が見ないものは「照合しないもの」にまとめる。
CLI の入力は stdin の JSON、出力は 1 行の JSON。ok: false は拒否で、code と reason を持つ(code の一覧は scripts/implement-core.mjs の CODES、個々の拒否の理由は reason)。ok: false の拒否では CLI は記録を書かないので、写し間違いが原因なら正しい入力で同じ op を流し直してよい。入力の誤りでない拒否(reason が段の順序や作業ツリーの状態を指す)なら次の段へ進まず、reason を報告する。Workflow の返り値(実装の Workflow・repo-review の Workflow)は、本文を写す代わりにファイルの path を <名前>Path(implementationPath・reviewPath)で渡せる。native の Workflow が返り値を残す tasks の .output(返り値を result に入れた包み)はそのまま渡してよく、CLI が result を取り出す(包みの判定は scripts/implement-core.mjs の unwrapWorkflowOutput)。
開始: 状態を固定する
-
依頼・Issue・要求文書から、外から確かめられる期待の挙動と守る性質を把握する。対象か期待が一意に決まらず、公開の契約・データの損失・互換性に複数の妥当な選択肢があるときだけ、根拠と選択肢を示して利用者に確かめる。
-
mktemp -dで repo の外にstateDirを作り、startを流す。方針の版(policyRef)は CLI が主ブランチの remote の先端に固定する(正本はscripts/implement-core.mjsのDEFAULT_POLICY_REF)。node [SKILL_DIR]/scripts/implement-cli.mjs start <<'JSON' {"repo": "<作業ツリーの絶対パス>", "stateDir": "<stateDir>"} JSONCLI は HEAD と policyRef の完全な SHA、開始時の変更の path(
preservedPaths。変更の集合は repo-review の working_tree と同じ集合)と、その内容・status・index の entry、作業ツリーの snapshot を記録する。policyRef は入力に取らない(作業 branch の規約で同じ変更を免責しないため)。始められない状態(主ブランチの上など)はE_PINで拒否するので、reason(状態と片付け方を書いている)を利用者に伝え、片付いてからやり直す。出力のstate・state_sum・state_pathを以後の全ての段に手を加えずに写す(写し間違いは sum で拒否される)。
計画と計画のレビュー
透過実行 route: 現在の tool inventory に native
Workflowがあり、この call が未試行なら native を 1 回だけ使う。native が存在しない Codex ではworkflow:dynamic-workflow-runnerを 内部互換層として使い、ユーザーに runner の指定を求めない。native を試行後に error / timeout / invalid result となった場合は runner へ fallback しない。human gate は無し。caller が所有する 前処理は「開始: 状態を固定する」、成功後処理はこの節の status の表。runner の verified return 以外で 成功後処理へ進まず、runner 未 install・unsupported_runtime・rejected_source・workflow_incompleteはそのまま報告する。Codex classification: read-only supported。runner request の
requirementsとlimitsは source のmeta.requirements・meta.limitsをそのまま使い、SKILL.md に値を写さない。source がagent()に渡す model 名(source のROLE_MODELS)の全てに runner のmodelMapを明示する。worker のcwdは repo にする。
Workflow({
scriptPath: "[SKILL_DIR]/scripts/plan.js",
args: { skillDir: "[SKILL_DIR]", request: "<利用者の依頼の文>", state: <start の state>, stateSum: "<state_sum>" }
})
skillDir はこのスキルの実ディレクトリの絶対パス(Workflow source は自分の位置を解決できない)。
planner は影響する path・守る性質・手順・追加の check と、変更の条件ごとの ケース計画(条件 → ケースの対応表。各ケースの観点・検証層・入力と期待値、観点ごとの不適用の理由、カバーできない条件の理由)を返す。形の正本は計画の Workflow source の schema。script はケース計画の形を検査して必須の check を足し、plan-reviewer は計画を依頼・既存の契約と照らし、ケース計画を条件の取りこぼし・観点の未検討・実装から取った期待値で照合する。形の検査か plan-reviewer に通らなかった計画は、理由を添えて planner に戻す(回数の上限は source の定数 MAX_PLAN_REVISIONS)。
| status | 司令塔の処理 |
|---|---|
| approved | 返り値の plan と plan_sum を手を加えずに次の段へ写す |
| no_change | 受け入れ(次の節の 1)と verify だけを流し、計画の根拠(no_change_reason と plan-reviewer の evidence)を示して「変更不要」と報告する |
| needs_human_decision | questions と判断の材料を示して止まる。回答を依頼の文に足して計画からやり直す |
| needs_isolated_worktree | preservedOverlaps を示して止まる。開始時の変更を動かさないまま、開始時の HEAD から別の worktree を用意するか、利用者に確かめる |
| blocked・incomplete | reason と issues・test_plan_review・problems を示して止まる。revisions_exhausted: true は planner に戻す上限に達したことを表す。成功として扱わない |
受け入れと開始時の check
-
受け入れ:
implementationを付けずにinventoryを流す。CLI は plan を今の作業ツリーと check の許可リストに照らし、admitted: trueのときだけ plan を記録する(照らす項目はproblems[].causeの名前で、正本はscripts/implement-cli.mjsのinventoryとscripts/implement-core.mjsのinventoryProblems)。falseならproblemsのcauseとmessageを示して止まる(check_not_allowedで、許可リストに無い check が要るなら、利用者に手で実行するか見送るかを確かめる)。実装の回の前なら、計画し直した plan を受け入れ直せる。出力のbaseline_neededが true なら(plan が変わって開始時の check の記録が消えたか、まだ取っていない)次の 2 を流す。false なら記録が残っているので流さない。node [SKILL_DIR]/scripts/implement-cli.mjs inventory <<'JSON' {"statePath": "<state_path>", "stateSum": "<state_sum>", "plan": <plan>, "planSum": "<plan_sum>"} JSON -
開始時の check: 同じ入力に
"phase": "baseline"を足してrun-checksを流す。実装の後に失敗した check が変更の起こしたものかを、CLI がこの記録と照らして決める。make testは数分かかり、shell の前景の実行の時間上限を超え得るので、run-checksは background で実行して終了を待つ(途中で打ち切ると記録が残らず、その段をやり直すことになる)。開始時に失敗した check(exit_codeが 0 でない)は、変更後も失敗すれば修正の回では直さない(変更が起こしたと決められない)。verifyは plan の check の全件の成功を求めるので、変更がその失敗を直さない限りverifyは通らない。依頼がその失敗を直すものでなければ、ここで止まり、失敗の argv と出力を利用者に示して、止めるか、その失敗を直すことを依頼の範囲に入れて計画からやり直すかを確かめる(そのまま続けても完了にはならない)。
実装の回
実装の回は、CLI の begin-round が出す券(ticket)で 1 回ずつ開き、実装の Workflow を 1 回呼び、inventory で閉じる。round の番号と修正の入力は CLI が記録から決め、券に載せる(司令塔は修正の入力を選ばない)。
node [SKILL_DIR]/scripts/implement-cli.mjs begin-round <<'JSON'
{"statePath": "<state_path>", "stateSum": "<state_sum>", "plan": <plan>, "planSum": "<plan_sum>", "repair": null}
JSON
repair は、最初の実装では null、check の修正では "checks"、レビューの修正では "review"。needs_replan: true が返ったら、確定指摘が計画の外か対象の外(findingsOutsidePlan)を指しているので、券を出さずに止まり、その指摘を報告する(実装の回の後は plan を受け入れ直さない。計画の外の修正をこの run に混ぜると、開始時の check と既に通した照合が別の計画のものになる)。
透過実行 route: 現在の tool inventory に native
Workflowがあり、この call が未試行なら native を 1 回だけ使う。native が存在しない Codex ではworkflow:dynamic-workflow-runnerを 内部互換層として使い、ユーザーに runner の指定を求めない。native を試行後に error / timeout / invalid result となった場合は runner へ fallback しない。human gate は無し。caller が所有する 前処理はbegin-round、成功後処理はこの節のinventoryと「check と修正ループ」。runner の verified return 以外で 成功後処理へ進まず、runner 未 install・unsupported_runtime・rejected_source・workflow_incompleteはそのまま報告する。Codex classification: workspace-write required。host は worker の
cwdを repo にし、workspace.mode: "workspace-write"を設定する (source の要求だけでは書き込みの権限は上がらず、許可が無ければ runner が最初の agent の前に拒否する)。requirements・limits・modelMapの扱いは 計画の Workflow と同じ(requirementsは source のmeta.requirementsをそのまま使う)。
Workflow({
scriptPath: "[SKILL_DIR]/scripts/implement.js",
args: { skillDir: "[SKILL_DIR]", state: <start の state>, stateSum: "<state_sum>", plan: <plan>, planSum: "<plan_sum>", ticket: <begin-round の ticket>, ticketSum: "<ticket_sum>" }
})
どの status でも、返り値をそのまま implementation に入れて inventory を流す(受け入れと同じ入力に "implementation": <返り値>)。CLI は券の round を閉じて記録し、開始時からの実際の変更と index を plan・implementer の申告・preservedPaths に照らす(照らす項目は problems[].cause の名前で、正本は scripts/implement-core.mjs の inventoryProblems・roundEffectProblems)。passed: false なら problems の cause と message を示して「止まるとき」に従う(plan の外の変更や申告漏れを司令塔が戻さない。戻すのは破壊的な操作で、利用者が決める)。通らなかった round の後は、CLI が check・レビュー・次の回を受け付けない。
| status | 司令塔の処理 |
|---|---|
| ready_for_check | 実装の Workflow の実行が終わったことだけを表す。次の節の check へ進む。implementation.notes(範囲内の判断・注記)は報告に載せる |
| repair_limit_reached | 修正の回の上限(実装の Workflow source の定数 MAX_REPAIR_ROUNDS)を超えた券で、implementer を起動していない。暴走を止める backstop で止まったこととして、残った失敗・確定指摘を示して「止まるとき」に従う |
| blocked・incomplete | reason と、ケースのテストの欠け(caseTestGaps)・果たせなかった作業(implementation.unresolved)を示して「止まるとき」に従う。承認済みの計画に implementer だけが変更不要と返したもの(no-change-against-approved-plan)もここに入る |
Workflow が返り値無しに終わった(error・timeout)ときは券が開いたままなので、inventory は流せない。「止まるとき」に従う。
check と修正ループ
- 受け入れと同じ入力に
"phase": "after"を足してrun-checksを background で流す。CLI は plan の check を 1 件ずつ固定の argv で実行し、command・exit code・HEAD・出力の末尾と、実行の前後の snapshot を記録する。モデルの文や PR のコメントを shell に渡さない。 passed: trueなら独立レビューへ進む。repairable: trueの失敗(開始時に成功していたか、開始時にまだ無かったテストの失敗)があれば、"repair": "checks"で次の回を開く。failed_at_baselineがtrueの失敗は開始時から失敗していたので直さず、原因を切り分けられなかったこととして「止まるとき」に従う。check の実行中に作業ツリーが変わった(tree_changed: true)ときも同じ。同じ回の run を流し直してもよいが、CLI は同じ回の全ての run の失敗を数えるので、一度失敗した check は修正の回を経ないと通らない。- 修正の回の後は、毎回この節の 1 から(check の全件と独立レビューを)やり直す。
独立レビュー
check が通ったら、repo-review スキルをスキル呼び出しで起動し、working_tree モードで、baseRef と headSha に state.head、policyRef に state.policyRef、preservedPaths に start の出力の preservedPaths を渡してレビューさせる(repo-review の前処理と Workflow の呼び方は repo-review の SKILL.md が正本)。repo-review の返り値と、その plan 操作の出力の plan_path・plan_sum を、そのまま record-review に渡す。
node [SKILL_DIR]/scripts/implement-cli.mjs record-review <<'JSON'
{"statePath": "<state_path>", "stateSum": "<state_sum>", "review": <repo-review の返り値>, "reviewPlanPath": "<plan_path>", "reviewPlanSum": "<plan_sum>"}
JSON
CLI は返り値を repo-review の計画のファイル・開始時の記録・今の変更に照らしてから記録し、合わなければ ok: false で拒否して reason に合わない項目を返す(照らす項目の正本は scripts/implement-core.mjs の reviewProblems)。レビューの範囲を狭めた・返り値から指摘を落とした・前の回の結果を出し直した返り値は、この照合で拒否される。記録は 1 回に 1 つで、やり直せるのは前の記録が review_incomplete のときだけ(回数の上限は scripts/implement-core.mjs の MAX_REVIEW_RETRIES。前の確定指摘と未検証は残る)。
repo-review が「レビューの対象が 0 件」(変更が除外・生成物だけ)で Workflow を呼ばずに終えたときは、記録するレビューが無く verify は通らない。レビューを経ていない変更として「止まるとき」に従う。
出力の next が、記録から決まる次の段を 1 つ示す。
next |
司令塔の処理 |
|---|---|
| verify | 「最終照合と報告」へ進む |
| repair | "repair": "review" で次の回を開く(券には CLI が記録した確定指摘が載る。refuted は直さない)。出力の unverifiedDetail(同時に残った未検証)は直さずに報告に載せる |
| retry_review | 途中で止まったレビューで、確定指摘も未検証も無い。repo-review を同じ値で呼び直し、その返り値を記録する |
| abandon | 確定していない指摘(未検証)が残るか、やり直しの上限に達した。「止まるとき」に従い、未検証の指摘を報告する |
司令塔の読み直しを独立レビューの代わりにしない(自分の読みは生成と同じ視点で、欠陥が見えない)。
止まるとき
実装の回を始めた後に止まる(上の各段の「止まるとき」・CLI の拒否・人の判断待ち)ときは、理由を添えて abandon を流す。CLI は開いた回を放棄として閉じ、以後の段を受け付けず、残った変更の path(remaining)と開始時の変更(preservedPaths)、最後に記録したレビューの確定指摘と未検証の本文(lastReview)を返す。
node [SKILL_DIR]/scripts/implement-cli.mjs abandon <<'JSON'
{"statePath": "<state_path>", "stateSum": "<state_sum>", "reason": "<止まった理由>"}
JSON
残った変更は消さない。報告に、止まった理由、remaining の path、uninventoriedWrites(開いた回の implementer の書き込みで、照らしていない)と changedOutsideSteps(段の外の書き込み)、取れる手(commit して別の run で続ける・破棄する・別の worktree に移す)を書き、どれを取るかは利用者が決める(どれも作業ツリーの内容を変える操作で、未保存の作業を失い得る)。続けるときは、片付いた作業ツリーで新しい stateDir から始める。
最終照合と報告
受け入れと同じ入力で verify を流す。CLI は check もレビューも流し直さず、記録と今の作業ツリーに照らして、最後の回の実装・check・レビューが通り、作業ツリーが最後に check とレビューを通した時点のままかを確かめる(照らす項目は problems[].cause の名前で、正本は scripts/implement-core.mjs の verifyProblems)。passed: true のときだけ完了として報告する。
報告に書くもの: 変更の内容と path、ケース計画(条件ごとのケースとテストの所在、不適用の理由、未カバーの条件と理由)、check ごとの argv と exit code、レビューの対象・観点・確定・棄却・未検証の件数、修正の回数(上限で止まったならそのこと)、verify の problems、照合の外にあるもの(ignore される path・入れ子の repo の中身)、実行していない確認と残した判断。成功していないものを成功として書かない。
commit を頼まれたときは、verify を流し、passed: true のときだけ、verify の出力の actual の path を <actual> として git add -- <actual> と git commit --only -- <actual> を続けて流す(git add は未追跡の新しいファイルと削除を commit に入れるため。--only は指定した path だけを commit に入れ、index にある他の内容、たとえば開始前に利用者が stage していた preservedPaths を入れない)。verify より先に stage すると CLI の index の照合が index_changed で落ちる。false なら stage も commit もせず、problems を報告する。commit の後は、同じ作業単位で git push origin <state.branch> を流す(AGENTS.md「作業ルール」。/tmp 系の worktree にしか無い commit は清掃で失われる)。--force を付けない。push が失敗したら、commit は残したまま失敗の出力を報告して止まる。
照合しないもの
CLI の記録と照合が見ないものは次のとおりで、報告では照合した範囲に含めない。
.gitignoreに当たる path への書き込み(git statusに出ない)。受け入れは ignore される path を plan に入れさせないが、implementer が plan の外の ignore される path に書いたことは見えない。- 実行中に作られた未追跡の入れ子の repo の中身(path だけが変更として現れる)。
- 同じ券で実装の Workflow を 2 回走らせ、どちらも
inventoryの前に書き終えたときの 2 回目の書き込み(1 回分の変更として受け入れられ、touched_paths の申告と合う限り区別できない)。 - sum を計算し直した意図的な改変(state・plan・券・Workflow の返り値・repo-review の返り値の sum は写し間違いと落としを検出するもので、署名ではない)。
04 同仓库更多 Skills
coverage-build
文書でもプログラムでも、作る(create)・既にあるものを目標に合わせて直す(update)・作らずに目標に照らして確かめる(review)作業を、 目標の固定 →(update は現状の検査)→ 設計 → 設計レビュー → 実装 → 実装レビューの段で回し、見落としを構造で減らす汎用の仕組み。 1 体には 1 単位だけを任せ、テストは実装と別の担当が先に書き、レビューは coverage-audit を呼び、悪かった出来事を探索グラフで振り返って 欠陥を原因の層(目標・設計・実装)へ戻す(指摘の箇所だけを直す経路は持たない)。台帳は run をまたいで持ち越し、変わったものだけを見直す。 「この機能を設計からレビューまで通して作って」「このスキルを目標に合わせて直して(文書とコードが混ざってよい)」 「この実装が目標を満たすか確かめて、直すならどの層からかを返して」のような依頼で使う (Use when building or updating documents or code through goal, design, design review, implementation, and implementation review with layer-routed rework)。 対象外: 目標に照らした網羅的な検査だけで振り返りも要らないもの(coverage-audit)、1 体で 1 回で済む小さな変更、このリポジトリの差分・PR のレビュー(repo-review)。
coverage-audit
与えられた目的と対象(設計・計画・要求・仕様・コード・テストなどのファイル)を、資産 × 観点の枡に分けて網羅的に検査し、 確かめた指摘と、見ていない所(開示した枡)を台帳に残して返す検査専用の仕組み。1 体には 1 枡だけを渡し、 読んだ証拠を本文の区画ごとの逐語の引用で機械が照らし、読む役と別のモデル・反証側の検証役が指摘を確かめ、 悪かった出来事を振り返り、確かめた欠陥を根本原因で束ねて型を全ての資産へ横展開する。台帳は run をまたいで持ち越し、変わった枡だけを読み直す。 「修正の前にこの設計・計画を観点ごとに漏れなく検査して」「この実装が目的と仕様を満たすか網羅的に検証して」 「前回の台帳の続きから、変わった所だけ検査し直して」のような依頼で使う(Use when files must be audited for every part × every lens with machine-checked evidence, without fixing them)。 対象外: 修正・生成の実行(このスキルは指摘と網羅の記録までを返し、直すのは呼ぶ側)、1 体で 1 回で済む小さな確認、このリポジトリの差分・PR のレビュー(repo-review)。
summarizing-meeting-notes
会議後に書かれた議事録・会議メモ・文字起こしテキストと、会議の録音ファイル(.mp3 / .m4a)を読み、 決定事項・アクションアイテム・未決事項を区分した要約を作る。 「この議事録を要約して」「会議メモから宿題を抜き出して」「定例の決定事項をまとめて」 「先週の打ち合わせの要点を出して」のように、 会議の記録から決定・宿題・未決を知りたい依頼なら使うこと。 記録が箇条書き数行のメモでも使うこと。 対象外: 会議中のリアルタイムな記録取り、議事録以外の文書(企画書・報告書)の要約、 1on1・面談の記録の要約。
release-notes-editor
リリースノートの下書きを、利用者と 1 項目ずつ確かめながら書く。「次のリリースのリリースノートを書いて」「リリースノートを作って」という依頼で使う。リリースノートの翻訳と、コミットメッセージの書き直しには使わない。
trace-cause
リポジトリで再現する 1 つの失敗(落ちるテスト・誤った出力)の根本原因を、確かめた事実の連なりとして特定する。「このテストが落ちる原因を突き止めて」「なぜこのコマンドがこの出力になるのか調べて」のように、再現手順のある失敗の原因調査を頼まれたときに使う。再現手順の無い相談、修正そのものの依頼、一般的な質問には使わない。
glossary-sync
リポジトリの用語集 docs/glossary.md と、文書の中の用語の使い方の食い違いを洗い出す。「用語集と文書の食い違いを調べて」という依頼で使う。用語集の新規作成と翻訳には使わない。