メニュー
既存または新規のコメントを SoT 規約 (CLAUDE.md / code-comments rule) に照らして audit し、削除・短縮候補を抽出する手順。「他に削れるコメントある?」「コメント減らしたい」「AI-workslop ないか?」のような問い、または PR/diff のレビュー段階で使う。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
herdr で管理されている他の agent pane（別 worktree / 別タブで動く Claude Code や Codex 等）にメッセージを送り応答を確認する手順。「他の agent に FB して」「herdr 経由で伝えて」「並行作業中の agent に連絡して」等で使う。
ブラウザ操作に関する要件
Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me" / 「詰めて」「設計を grill して」.
GitHub CLI を使った PR 作成
セッションで得た学びを dotfiles ハーネス（Skill / Rule / Subagent）に恒久反映する方法論。「学んだことを焼き込みたい」「/learn」のときに使う。手順は Skill、原則は Rule、専門役割は Subagent に振り分け、共有レイヤー（dot_agents / .chezmoitemplates）優先で chezmoi ソースを編集し apply する。
agent 向けテキスト指示（skill / slash command / task プロンプト / CLAUDE.md 節 / コード生成プロンプト）を、バイアスを排した実行者に動かしてもらい、両面（実行者の自己申告 + 指示側メトリクス）で評価して反復改善する手法。改善が頭打ちになるまで回す。プロンプトや skill を新規作成・大幅改訂した直後、またはエージェントの挙動が期待通りにならない原因を指示側の曖昧さに求めたいときに使う。
| name | comment-audit |
| description | 既存または新規のコメントを SoT 規約 (CLAUDE.md / code-comments rule) に照らして audit し、削除・短縮候補を抽出する手順。「他に削れるコメントある?」「コメント減らしたい」「AI-workslop ないか?」のような問い、または PR/diff のレビュー段階で使う。 |
| 残すべき | 削るべき |
|---|---|
| 非自明な局所的意図 (recipe quirk・stopPropagation の理由・副作用注意・workaround の根拠) | WHAT の言い換え (識別子で分かる事実の繰り返し) |
| 隠れた制約・契約・前提 | 現在のタスク言及 (「issue #X 用」「Y フローで追加」) — PR description が SoT |
| 触ろうとした人に必要な warning | rejected alternative (「X じゃなく Y にした」) — git blame が SoT |
| SoT ドキュメントの繰り返し (CLAUDE.md / rules / docs に既にある記述の再掲) | |
| 下行で見える事実の言い直し (例: 「下記で override するので default は無視」) |
git diff (uncommitted + staged) / 引数あり → そのファイル・PR 番号・コミット範囲。//) / ブロック (/* */) / JSX ({/* */}) / doc (/** */) を該当 scope から列挙。