octocode-rfc-generator について
octocode-rfc-generatorは、技術 RFC の作成と再評価を支援するスキルです。実装者やレビュアーが実行できる根拠付きの決定を目指し、調査、選択肢の比較、前提条件、実装計画、KPI、検証を扱います。既存 RFC は現在のコードに照らして再評価します。
主な機能
- 01段階に沿った RFC 作成
- 02検証可能な根拠の調査と記録
- 03少なくとも二つの選択肢を比較
- 04要件・受け入れ条件・検証を連携
- 05現在のコードに照らした RFC 再評価
活用シーン
- 01複雑な変更の方針を計画
- 02選択肢を比較してトレードオフを記録
- 03既存 RFC と現行コードを照合
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bgauryy/ octocode --skill octocode-rfc-generatorインストール後、Claude Code で/octocode-rfc-generatorを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
README.mdreferences/improve-loop.mdoctocode.mdresearch-playbook.mdrfc-audit.mdrfc-implementation.mdrfc-kpi.mdrfc-prerequisites.mdrfc-resources.mdrfc-template.mdworkflow.md詳細
Octocode RFC ジェネレーター
実装者とレビュー担当者が実行できる、証拠に裏付けられた意思決定を作成します。
フロー:UNDERSTAND → RESEARCH → PREREQUISITES → COMPARE → WRITE → CLOSE QUESTIONS → KPI → VALIDATE → DELIVER。
既存の RFC では WRITE の代わりに REASSESS を実行してください(references/workflow.md § 既存の RFC の再評価を参照)。以前のチェックボックスではなく、最新のコードに照らして監査します。
ロビーのルール
- 些細な編集では RFC モードをスキップします。不確実性によって成果物の形式、担当者、スコープ、または判断基準が変わる場合は、焦点を絞った質問を 1 つします。
- ユーザーが 1 つの実装計画を明示的に求めていない限り、何もしない選択肢を含め、少なくとも 2 つの代替案を比較します。
- 推奨には検証可能な事実が必要です。実際に実行した正確な参照先とコマンド/チェックを引用します。
- 目標、スコープ、判断を管理するのは
RFC.mdです。他のファイルではこれらを繰り返さず、RFC のアンカーへリンクします。 - すべての未解決の質問を、証拠または明示的な保留によって解決します。不確かな主張に基づく推奨は認められません。
- 実装は見積もりではなく依存関係に基づいて順序付けます。要件を受け入れ条件と検証に結び付けます。
.octocode/rfc/のレビュー、評価、または整理(削除/実装済み/修正の判断)では、最新のコードを読み直したうえで、RFC 自体に日付入りの## Audit Reasoningブロックを必ず記載します。- RFC のステータスを記憶や他の RFC の主張に基づいて断定してはいけません。
- 次の場合は停止します:変更が些細な単一ファイル編集である場合(
octocode-researchに案内します)、ブレインストーミングの引き継ぎが Prototype First、Narrow、Park、または準備未完了とされている場合、不確実性によって成果物の形式、担当者、スコープ、またはトレードオフの優先順位が変わる場合、2 回の調査を試みても失敗した場合(判明していることを述べ、方針を尋ねます)、スコープを別々の RFC またはフェーズに分割する必要がある場合、未解決のブロッカーが解消済みであると仮定する必要がある場合、または.octocode/rfc/内の保存、削除、アーカイブに明示的な承認が必要な場合。
成果物のルート
- 小規模で元に戻せる単一パッケージの作業では、計画、受け入れ条件、インライン参照を含む
RFC.mdのみを作成します。 - それ以外の場合は、保存の承認後に
<workspace>/.octocode/rfc/{name}/を作成します:RFC.md(決定)、PREREQUISITES.md(準備状況、既存コードのみ)、IMPLEMENTATION.md(構築)、KPI.md(検証)、RESOURCES.md(ソース付録)。
スマートルート — 現在のステップで必要なものだけを読み込む
- 依頼を理解してドラフト作成前にモードを選ぶには、
references/workflow.mdを読み込みます — ゲート、主張台帳、成果物セット、トレーサビリティ、検証、納品順序。 - 証拠を調査する際は、
references/octocode.md、続いてreferences/research-playbook.mdを読み込みます — 調査内容を正確に委任し、主張を監査可能な状態に保ちます。 - 既存コードに準備作業が必要な場合は、計画前に
references/rfc-prerequisites.mdを読み込みます — ベースライン、ブロッカー、担当者、セットアップを明らかにします。 - 選択肢を比較して判断を記述する際は、
references/rfc-template.mdを読み込みます — 代替案、目標/非目標、可逆性、プレモーテムを整理します。 - 実行計画を作成する際は、
references/rfc-implementation.mdを読み込みます — 未解決の質問を解消し、依存関係を順序付け、ロールアウト/ロールバックを定義します。 - 受け入れ条件と KPI 目標を定義する際は、
references/rfc-kpi.mdを読み込みます — ユーザーストーリー、指標、判断ルール、検証をトレーサビリティマトリクスで結び付けます。 - ソースを保持する際は、
references/rfc-resources.mdを読み込みます — 決定的な引用を RFC の外に移さずに、出典情報を記録します。 - 既存の RFC を再評価、評価、または整理する際は、
references/rfc-audit.mdを読み込みます — 保持/修正/削除を判断する前に、最新コードの証拠に基づく日付入りの## Audit Reasoningブロックが必要です。 - このスキルを改善する際は、
octocode-graph-evalを優先します。それ以外の場合はreferences/improve-loop.mdを読み込みます — 測定可能な受け入れ/差し戻しを徹底します。
関連するルートと検証
- 作る価値があるかどうか決まっていない場合は、RFC の前に
octocode-brainstormingを使用します。事実に関する疑問を解消するにはoctocode-researchを、KPI の厳密性を確保するにはoctocode-graph-evalを使用します。 - このスキルフォルダーを変更する場合は、
octocode-skillsを使用します。 - 提出前に、ドキュメントの契約をセクションごとに検証し、実際の結果を報告します。
コメント
Markdown 対応