Menú
Architecture Decision Record (ADR) を作成するスキル。 ADR フォーマット・品質基準に準拠した ADR ファイルを生成する。 「ADRを書いて」「ADRを作成して」「アーキテクチャの意思決定を記録したい」「〇〇を採用する判断を文書化して」 などの指示で発動する。技術選定、設計方針の変更、規約の策定など、アーキテクチャに関する意思決定の記録が必要な場面で使用すること。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
macOSのデスクトップアプリ（GUI）をAIが起動・キー操作・スクリーンショットで動作確認するノウハウ。 トリガー: デスクトップアプリの動作確認、GUIのE2E的な検証、「アプリを起動して確認して」
spec-driven developmentで機能開発したいときに使う。 トリガー: "specdd", "spec-driven", "スペック駆動"
Codex CLI（OpenAI）を使用してコードや相談・レビューを行う。 トリガー: "codex", "codexと相談", "codexに聞いて"
PRの説明文作成 トリガー: ユーザーから明示的に`/pr-description`と言われたときのみ使う。`PR作成`などのスキルはたいていリポジトリに用意されているのでそちらを優先して使う
セッション終了時や作業の区切りで、引き継ぎノートを生成する。 トリガー: "handover", "引き継ぎ", "ハンドオーバー"
コミットメッセージの作成 トリガー: "commit", "コミット"
| name | adr-creator |
| description | Architecture Decision Record (ADR) を作成するスキル。 ADR フォーマット・品質基準に準拠した ADR ファイルを生成する。 「ADRを書いて」「ADRを作成して」「アーキテクチャの意思決定を記録したい」「〇〇を採用する判断を文書化して」 などの指示で発動する。技術選定、設計方針の変更、規約の策定など、アーキテクチャに関する意思決定の記録が必要な場面で使用すること。 |
ADR（Architecture Decision Record）を一定品質で作成するためのスキル。
ADR の品質は、書き手がどれだけ背景を理解しているかで決まる。以下の情報を集める。 ユーザーが既に十分な情報を提供している場合は、不足分だけを確認する。
docs/adr/ ディレクトリを確認し、既存 ADR の最大番号 + 1 を新しい番号とする。
ls docs/adr/*.md | sort -t/ -k3 | tail -1
以下のフォーマットとガイドラインに従って ADR を作成する。
docs/adr/{NNNN}-{kebab-case-name}.md
{NNNN}: ゼロ埋め4桁の連番（例: 0019）{kebab-case-name}: ADR の内容を端的に示す英語のケバブケース名例:
0024-adopt-redis-for-caching.md0025-frontend-state-management-with-zustand.md# ADR {NNNN}: {日本語のタイトル}
## Status
{Proposed | Accepted | Deprecated | Superseded}
## Context
{背景と課題を価値中立的に記述する}
### 解決したい課題
{箇条書きまたは説明文で、具体的な課題を挙げる}
### 検討した選択肢
{少なくとも2つ以上の選択肢を列挙する}
### 各選択肢の評価
{比較表で客観的に評価する}
| 観点 | 選択肢A | 選択肢B | 選択肢C |
|------|---------|---------|---------|
| ... | ... | ... | ... |
## Decision
**{決定内容を太字で一文にまとめる。}**
### 1. {決定の詳細1}
{必要に応じてコード例、図、設定例を含める}
### 2. {決定の詳細2}
{...}
## Consequences
### Positive
- {ポジティブな結果}
### Negative
- {ネガティブな結果}
- → {緩和策}
### Risks
- {リスク}
- → {対策}
## 決めていないこと（任意）
{スコープ外とした事項がある場合に記載する}
| 項目 | 決めない理由 | いつ決めるか |
|------|------------|------------|
| ... | ... | ... |
## Notes
### 参考資料
- {参考リンクや関連ADR}
→ で緩和策を付けるADR のドラフトが完成したら、ユーザーに提示してフィードバックを求める。
指摘に基づいて修正し、最終版を docs/adr/ に書き出す。
Status は特に指定がない場合 Proposed とし、レビュー承認後に Accepted へ変更する運用を提案する。