hrt-dark-mode-routing について
hrt-dark-mode-routingは、ダークモード有効時に各開発フェーズの未解決の指摘をどこへ送るか定めるスキルです。関連するhrtスキルを使うワークフロー向けに、フェーズ指示へ分散していたルールを集約します。
主な機能
- 01dark.mdの有無を確認してルーティング
- 02フェーズと指摘の種類で振り分け
- 03セキュリティ判断はユーザーに委ねる
- 04計画のみと実装ありの変種に対応
- 05判断ゲートの推論をdark.mdに記録
活用シーン
- 01提案・仕様・設計の指摘の振り分け
- 02整合性レビューの判断と高重要度指摘の処理
- 03適用フェーズのブロッカーやコード指摘の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hash-id/ openspec-schema --skill hrt-dark-mode-routingインストール後、Claude Code で/hrt-dark-mode-routingを入力して読み込まれたか確認します。
詳細
hrt-dark-mode-routing
既存の dark.md がダークモードの有効化を示す唯一の合図です(hrt-dark-mode-opt-in によって作成されます)。このスキルには、以前は各フェーズの指示にコピーされていたルーティング規則が記載されています。各フェーズの指示からは1行でここを参照し、規則はここに集約します。
dark.md が存在しない場合、このスキルは何もしません。すべての指摘は通常どおりユーザーに伝えられます。
呼び出し元のフェーズごとのルール
通常ならユーザーにエスカレーションされる指摘は、以下のとおりルーティングされます。ダークモード以外でも自動解決されるものは、引き続き自動解決されます。ダークモードによって変わるのは自動解決のルールではなく、自動解決されない指摘の伝達先だけです。
| フェーズ | hrt-dark-mode-decision-gate にルーティング | 引き続きユーザーに伝える内容 | dark.md のセクション |
|---|---|---|---|
proposal(hrt-adversarial-authoring、成果物:proposal) | 単一レビュー担当者による UNANCHORED の指摘 | hrt-security-pass が判断したすべての内容、「変更は1つか複数か?」という hrt-change-size-gate の質問 | Proposal |
specs(hrt-adversarial-authoring、成果物:specs) | 単一レビュー担当者による UNANCHORED の指摘 | hrt-security-pass が判断したすべての内容 | Specs |
design(hrt-adversarial-authoring、成果物:design) | 単一レビュー担当者による UNANCHORED の指摘 | hrt-security-pass が判断したすべての内容 | Design |
align(hrt-align-consistency-review) | すべての ALIGN DECISION と HIGH の指摘 | 追加でユーザーに伝えるものはありません。ただし VERIFY と WALKTHROUGH は変更されず、WALKTHROUGH は必須の最終レビューとして維持されます。また、ユーザーには dark.md も提示されます | Align(各エントリにサイクル番号を付ける) |
apply Phase 1(tdd ループ) | seam-mismatch のブロッカー(ゲートはコード、設計、仕様に照らして別のシームを検討できます) | Phase 1 のその他すべてのブロッカー | Apply |
apply Phase 2(hrt-apply-code-review) | 通常ならユーザーに提示されるすべての指摘 | 追加でユーザーに伝えるものはありません | Apply |
すべてのフェーズに共通する不変条件
- ANCHORED の指摘、および独立した両方のレビュー担当者が挙げた指摘は、呼び出し元のスキル内で自動解決され、このルーティングには到達しません。
- セキュリティ要件または
hrt-security-passがすでに決定した緩和策に関する指摘は、必ずユーザーに伝えられ、hrt-dark-mode-decision-gateにルーティングされることはありません。この決定は検討対象となる対立意見ではなく、厳守すべき制約です。 - 「変更は1つか複数か?」という
hrt-change-size-gateの質問は、必ずユーザーに伝えられます。回答はユーザーの対応能力と優先事項によって決まり、それらを把握している根拠資料はないためです。 alignの WALKTHROUGH は、すべてのダークモードの種類で必須の完全手動レビューとして維持されます。hrt-dark-mode-decision-gateは必ず新しいサブエージェントとして起動し、対応するdark.mdのセクションに判断理由を記録します。また、自身の処理内でユーザーにエスカレーションすることはなく、必ず判断を提示します。スティールマンの手順については、このスキルを参照してください。
planning-only と +implementation
dark.md のヘッダーにモードの種類が記載されています。
- planning-only:ルーティングは
alignまで適用されます。applyは対象外です。dark.mdのヘッダーが planning-only の場合、applyは停止し、planning-only のダークモードは WALKTHROUGH で終了することをユーザーに伝えます。 - +implementation:表に記載されているとおり、ルーティングは
applyPhase 1 と Phase 2 にも適用されます。Phase 2 の後、ユーザーがコミットする前の2回目の最終レビューとして、コード差分とともにdark.md全体を提示します。
コメント
Markdown 対応