mcpField
O
octocode-rfc-generator

octocode-rfc-generator

github.com/bgauryy開発95752 回インストール11 週間前に更新
リポジトリ

octocode-rfc-generator について

octocode-rfc-generatorは、技術 RFC の作成と再評価を支援するスキルです。実装者やレビュアーが実行できる根拠付きの決定を目指し、調査、選択肢の比較、前提条件、実装計画、KPI、検証を扱います。既存 RFC は現在のコードに照らして再評価します。

主な機能

  1. 01段階に沿った RFC 作成
  2. 02検証可能な根拠の調査と記録
  3. 03少なくとも二つの選択肢を比較
  4. 04要件・受け入れ条件・検証を連携
  5. 05現在のコードに照らした RFC 再評価

活用シーン

  1. 01複雑な変更の方針を計画
  2. 02選択肢を比較してトレードオフを記録
  3. 03既存 RFC と現行コードを照合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bgauryy/octocode --skill octocode-rfc-generator

インストール後、Claude Code で/octocode-rfc-generatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
references/
improve-loop.md
octocode.md
research-playbook.md
rfc-audit.md
rfc-implementation.md
rfc-kpi.md
rfc-prerequisites.md
rfc-resources.md
rfc-template.md
workflow.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 を使用します。
  • 提出前に、ドキュメントの契約をセクションごとに検証し、実際の結果を報告します。

コメント