메뉴
ユーザーが指定したMarkdownドキュメントから、AIエージェントにとって自明・冗長な記述を削って簡潔にする。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
GitHub PRのレビューコメントのうち、Hide・解決済みでないものだけを抽出して対応する。
Commit, push, and create or update a PR
GitHub Actions の CI 失敗を、失敗ジョブの特定 → ログからの原因抽出 → 原因分類 → ローカル再現 → 修正 → 検証まで体系的に進めるスキル。特に、失敗ログのノイズに埋もれて原因が見えないとき、環境依存でフレーキーに落ちているときに役立つ。修正に人の判断が必要な場合は、対話モードでは確認して中断し、--non-interactive 指定時はPRにコメントを投稿して中断する。
`bundle exec erblint app` の既存違反をファイル単位で無効化する todo ファイル群 （`.erb_lint_todo.yml` / `.erb-lint-rubocop-todo.yml`）を生成・初期化する手順。手動起動専用 （`/erblint-todo-init`）。todo を作り直したいときなど、一回性のセットアップ作業でのみ使う。 rubocop 単体・haml-lint・herb-lint の運用には使わない。
プランモードで作成したプランファイル（Markdown）の内容に沿って実装を行う。実装フェーズを軽量なsonnetモデルで実行し、コスト・速度を最適化する。引数でプランファイルのパスを指定できる。省略時は直近のセッションログから対象プランを自動特定してユーザーに確認する。コミット・push・PR作成は、プランに明記されている場合のみ実施する。
APM パッケージ由来ルール（.claude/rules/*.md）と重複するプロジェクト固有ローカルルール （.apm/instructions/*.local.instructions.md）を検出し、ローカル側を削除・縮小する。未管理ルールの 新規移行は行わない（それは migrate-rules-to-apm の役割）。手動実行専用（自動トリガーしない）。
| 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 ヘルパーの呼び出し方）は残しています。