PR作成時に生成AIがPR本文にオンボーディングを記述するスキル。変更の契約を、レビューア・将来の自分・障害対応者に渡す。理解の再現性・反証可能性・運用可能性を同時に成立させる。 トリガー条件: - PRを作成する時(「PRを作成して」「プルリクを書いて」) - PR本文を充実させたい時(「PR説明を書いて」「PRオンボーディングして」) - 変更の影響を整理したい時(「この変更の影響範囲を整理して」) - レビューの準備をする時(「レビュー用に変更をまとめて」)
PR作成時に「説明」ではなく「変更の契約」を生成し、理解の再現性・反証可能性・運用可能性を同時に成立させる。PR作成時や本文充実させたい時にトリガーされ、レビュー・障害対応・将来の自分に向けた品質を担保する。
/plugin marketplace add CAPHTECH/claude-marketplace/plugin install caphtech-plugin@caphtech-marketplaceThis skill inherits all available tools. When active, it can use any tool Claude has access to.
references/evaluation-rubric.mdreferences/guardrails.mdreferences/skills-catalog.mdPR作成時に「説明」ではなく「変更の契約」を記述し、理解負債の蓄積を防ぐ。
PRオンボーディングの目的は、以下3つを同時に成立させること:
PR本文(+リンク先)を読むだけで、レビューアが以下を答えられる状態:
| # | 項目 | 内容 |
|---|---|---|
| 1 | What | 何が変わったか |
| 2 | Why | なぜそう変えたか(代替案含む) |
| 3 | Invariants | 何を壊してはいけないか |
| 4 | Blast Radius | どこに影響するか(境界・波及) |
| 5 | Failure Modes | どう壊れうるか |
| 6 | Evidence | どう確かめたか(検証・根拠) |
| 7 | Rollback | どう戻すか(または戻せない条件) |
1. 契約確立 → 2. 変更理解 → 3. 意図抽出 → 4. 境界特定 → 5. 不変条件 → 6. 失敗モード → 7. 検証証拠化 → 8. リリース戦略 → 9. レビュー誘導 → 10. DocDD同期 → 11. 不確実性管理
PR本文が長文化・散逸しないよう、"出力の契約"を確立。
出力:
行数差分ではなく、振る舞い・責務・契約の変化を抽出。
出力:
Why(設計意図)を、作文ではなく意思決定の記録として残す。
出力:
出力:
出力:
出力:
出力:
出力:
出力:
出力:
出力:
詳細は references/guardrails.md を参照。
各ステップの詳細な実行方法と品質ゲートは references/skills-catalog.md を参照。
PRオンボーディングの品質評価基準は references/evaluation-rubric.md を参照。
## Summary
[変更の中心を1〜3文で]
## Why
- **Goal**: [目的]
- **Reason**: [採用理由]
- **Alternatives**: [検討した代替案と棄却理由]
## What Changed
- [振る舞いが変わった点1]
- [振る舞いが変わった点2]
## Blast Radius
- **Affected**: [影響範囲]
- **Compatibility**: [互換性への影響]
## Invariants (Must Stay True)
| 条件 | 根拠 | 破ったときの症状 |
|------|------|-----------------|
| [条件1] | [コード/テスト] | [症状] |
## Failure Modes
| 種類 | パターン | 検知手段 |
|------|---------|---------|
| 起きやすい | [説明] | [テスト/ログ] |
| 致命的 | [説明] | [テスト/ログ] |
| 気づきにくい | [説明] | [テスト/ログ] |
## Evidence
- [x] 自動テスト: `npm test` 全パス
- [x] 手動検証: [手順]
- 根拠: [リンク]
## Rollout & Rollback
- **Rollout**: [手順]
- **Rollback**: [手順]
- **Cannot rollback if**: [条件があれば]
## Review Focus
- [ ] [重点ファイル1]: [観点]
- [ ] [重点ファイル2]: [観点]
## Unknowns
| 項目 | 解消手段 | ブロッカー? |
|------|---------|-----------|
| [未確定事項] | [手段] | Yes/No |
## Related
- Issue: #XXX
- Docs: [リンク]