メニュー
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/aki77/skills --skill trim-agent-docコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
GitHub PR を「人間レビューが必要か」の観点で判定し、required / pending / optional の3値で報告するスキル。統制系変更・不可逆操作・セキュリティ境界・個人情報フロー・外部契約・新規パターン導入・高リスク値計算・実行時ハザードの8トリガーに照らして判定し、どれにも当てはまらなければ optional に倒す。diffの外の事実に正しさが依存する場合のみ pending とし、その場で質問して回答を反映し required / optional に確定させる。GitHubへの投稿・Approve・ラベル付与は一切行わず、会話に報告するのみ。/pr-human-review-gate コマンドで起動する。
.database_consistency.yml のチェッカーを1回の実行で1つずつ段階的に有効化するスキル。違反は自明なものは修正し、アプリ仕様上やむを得ないものは理由コメント付きでテーブル/カラム単位の個別無効化を行う。
プランモードで練り上げた実装計画が1ファイルに収まらないほど大きくなった場合に、SSOT（overview.md）+ フェーズ索引（README.md）+ フェーズ別詳細（phase-N-*.md）の複数ファイル構成に分割して出力するスキル。出力先ディレクトリは引数で指定するか、なければユーザーに確認する。各ドキュメントはコードを含まず「何を作るか」「どの順でどう作るか」を記述する設計文書。「プランが大きすぎる」「フェーズに分けたい」「プランをドキュメント化したい」「計画ドキュメントを出力して」と言われたとき、またはExitPlanModeで確定したプランが長大で1回の実装セッションに収まらないと判断したときに使う。
SOC 職業分類に基づく
SKILL.md を表示中
| name | trim-agent-doc |
| description | ユーザーが指定したMarkdownドキュメントから、AIエージェントにとって自明・冗長な記述を削って簡潔にする。 |
| license | MIT |
| disable-model-invocation | true |
このスキルはユーザーが明示的にコマンド実行したときのみ動作します。引数として対象ドキュメントのパスを受け取る：
/trim-agent-doc doc/agent/models.md
/trim-agent-doc doc/agent/general.md 200行以内に
AIエージェント向けの開発ガイドラインや指示書は、書き足されるうちに冗長になりがちです。人間向けドキュメントなら丁寧な反復説明が親切ですが、読み手が高い理解力を持つAIエージェントの場合、自明な説明や同じことの言い換えは context を圧迫するだけで価値を生みません。
このスキルは、情報（=エージェントの判断や実装に効く内容）を一切失わずに、冗長な表現だけを削るためのものです。ユーザーが指定したドキュメントを対象に作業します。
簡潔化は「内容を削る」のではなく「同じ内容をより少ない語数で表す」作業だと考えてください。判断基準は一つ — その記述を消したとき、エージェントの振る舞いが変わるか？ 変わらないなら冗長、変わるなら情報です。
セクション見出しやコマンド名・固有名詞的なテキストは書き換えない。表現の短縮は本文・箇条書きの本体に限る。
削りすぎは簡潔化ではなく劣化です。次のものは自明に見えても残す：
判断に迷ったら残す。「これは自明だから消す」と「これは知識だから残す」の線引きが、このスキルの核心です。
wc -l で行数を確認する。上限指定があれば収まっているか検証するBefore（NG/推奨の両方＋理由3点で約18行）:
### 外部APIの呼び出しにはリトライを入れる
外部APIを呼び出すときはリトライ処理を入れる必要があります。
**NG例**（リトライなしで一度きり呼び出す）:
\```
result = call_external_api()
\```
**理由**:
- ネットワークは一時的に失敗することがある
- リトライがないとエラーになりやすい
- 安定性が向上する
**推奨**:
\```
result = with_retry(max_attempts: 3) { call_external_api() }
\```
After（結論＋プロジェクト固有のやり方のみ、1段落）:
外部APIの呼び出しは `with_retry(max_attempts: 3) { ... }` で囲む。一時的なネットワーク障害を吸収するため。
NG例（自明）と利点の列挙（結論の繰り返し）を削り、「やり方」（このプロジェクトの with_retry ヘルパーの呼び出し方）は残しています。