本文へ移動
cccskills
無料GitHub で公開

run-skill-rubric-governance

rubric変更を提案するとき、rubric改正を施行するときに使う。

インストール方法を見る

含まれるファイル(33)

  • SKILL.md10.8 KB
  • log/governance-log.jsonl981 B
  • prompts/R1-govern.md6.1 KB
  • proposals/2026-07-11-rubric-update.md2.1 KB
  • proposals/2026-07-15-rubric-update.md5.4 KB
  • proposals/2026-07-16-rubric-update.md5.4 KB
  • proposals/2026-07-22-rubric-update.md6.0 KB
  • proposals/2026-08-10-rubric-update.md5.7 KB
  • proposals/2026-08-11-rubric-update.md6.5 KB
  • proposals/2026-08-12-rubric-update.md9.8 KB
  • proposals/2026-08-13-rubric-update.md9.8 KB
  • proposals/2026-08-14-pg001-reg001-text-fix.md5.4 KB
  • proposals/2026-08-14-rubric-update.md9.2 KB
  • proposals/2026-08-15-rubric-update.md9.2 KB
  • proposals/2026-08-17-rubric-update.md9.2 KB
  • proposals/2026-08-18-rubric-update.md10.1 KB
  • proposals/2026-08-19-rubric-update.md9.2 KB
  • proposals/2026-08-20-rubric-update.md10.3 KB
  • proposals/2026-08-21-rubric-update.md9.1 KB
  • proposals/2026-08-23-rubric-update.md9.1 KB
  • proposals/2026-08-24-rubric-update.md10.0 KB
  • proposals/2026-08-25-rubric-update.md10.0 KB
  • proposals/2026-10-05-rubric-update.md1.5 KB
  • references/domain-rubric-template.json2.3 KB
  • references/governance-board.md2.2 KB
  • references/resource-map.yaml323 B
  • references/version-rules.md1.1 KB
  • schemas/output.schema.json918 B
  • scripts/aggregate-evals.py27.7 KB
  • scripts/diff-rubric-impact.py2.7 KB
  • scripts/lint-rubric-violation.py1.6 KB
  • templates/proposal.json681 B
  • workflow-manifest.json2.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Pre-choice usable artifact execution

Purpose & Output Contractの最小の実成果物をmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方を提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはその場でhandoff完了とし、後続sectionを実行しない。

Post-choice selected improvement execution

以下の既存workflow・goal-seek・評価・修正sectionはlight/standard/detailedが記録されてsemantic_evaluator_startedへ遷移した場合だけ実行する。release/exhaustiveは別の明示eventを必要とする。

run-skill-rubric-governance

Purpose & Output Contract

ref-skill-design-rubric/references/rubric.json の改正 Runbook(27章)。 提案 → 影響評価 → 猶予期間 → 発効 の4フェーズを1本のワークフローで管理。

入力: templates/proposal.json を埋めた改正提案ファイル 出力: rubric.json のPR、 governance log($SKILL_DIR/log/*.jsonl)

Key Rules

  1. 直接編集禁止: rubric.json は本Runbook経由でのみ更新。
  2. semver: minor=緩和(しきい値↓、ルール削除)、major=厳格化(ルール追加、weight↑)、patch=文言のみ。
  3. 猶予期間: major は最低14日、minor は7日、patch は即時可。
  4. 影響評価必須: scripts/diff-rubric-impact.py で過去 eval-log の合否変動率を測る。
  5. 承認ボード: 提案者 / 第三者レビュア / 承認者 / tooling役 の4ロール(references/governance-board.md)。

ゴールシーク実行

ゴール (Goal)

提案された rubric 改正が「影響評価・猶予期間・rubric_hash 再計算・派生同期・版ずれ検証」を全通過し、rubric.json が正しい semver で発効され、governance log が closed として記録された状態。

目的・背景 (Why)

rubric は全 Skill 採点の SSOT であり、直接編集や手順抜けは採点基盤を破壊する。固定手順では提案種別(add/modify/remove)や bootstrap 有無に応じた分岐に脆いため、到達状態(発効+検証通過+log closed)をゴールとし、未達項目を都度埋める。

完了チェックリスト (Checklist)

  • resolve-skill-dirs.py で SKILL_DIR が解決され eval-log/skill-dirs.json 出力済み
  • templates/proposal.json が rule_id / change_type / bump / rationale / sunset_days を埋めた状態で存在
  • 時系列違反率 (lint-rubric-violation.py --log-dir eval-log --n 3 --threshold 0.20) を評価し trigger.json 出力済み(eval-log 件数が governance-params.json の bootstrap_mode.min_eval_log_records(既定 20)未満なら exit 3=pending を許容、bootstrap 時は solo_operator_mode: true を log 記録し major bump は禁止)
  • ルール別違反集計 ($SKILL_DIR/scripts/lint-rubric-violation.py --rule $RULE_ID) と差分影響評価 (diff-rubric-impact.py) を実施済み
  • 合否変動率が 30% 超なら bump を major へ強制昇格している
  • 猶予期間(major≥14日 / minor≥7日 / patch即時)を governance log(jsonl 1行)に記録し、旧ルールを warning(severity→low)へダウングレード済み
  • rubric.json 編集後 rubric_version を semver で bump 済み
  • assign-skill-design-evaluator/references/rubric.json を deep-merge 同期済み
  • compute-rubric-hash.py で rubric.normalized.json と rubric_hash を再計算済み(27章§8.2)
  • check-rubric-sync.py が exit 0(RUBRIC_DRIFT: でない)であることを確認済み
  • git commit 実行し governance log を closed に更新済み
  • 1 release 後に違反率が悪化した場合、安定版凍結条件(freeze.consecutive_runs × violation_rate_ceiling)を満たす版へ rollback-to-stable.py で巻き戻し可能な状態(PostToolUse Hook 連携、27章§9)

ゴールシークループ

正本 ../run-build-skill/references/goal-seek-paradigm.md の 6 ステップ(現状評価→手順生成→実行→検証→Anchor Step→反復/差し戻し)に従う。本スキル固有差分:

  • 対象ファイル: ref-skill-design-rubric/references/rubric.json(直接編集禁止・本 Runbook 経由のみ)、templates/proposal.json、governance log($SKILL_DIR/log/*.jsonl)
  • 固定パス/閾値: 違反率閾値 0.20 / 連続 3 release、合否変動率 30% で major 昇格、bootstrap 最小件数 20、猶予 major14/minor7/patch0 日
  • 検証は ## 検証 系スクリプト(lint-rubric-violation.py / diff-rubric-impact.py / check-rubric-sync.py)へ寄せ、決定論的に [x] 判定する
  • 規定周回を超えても未達なら残項目を承認ボード(references/governance-board.md の 4 ロール)へ差し戻す

局面カタログ (順序は都度判断)

  • 出力先解決: python3 plugins/harness-creator/skills/run-build-skill/scripts/resolve-skill-dirs.py --skill-dir-name run-skill-rubric-governance > eval-log/skill-dirs.json
  • 影響評価コマンド群:
    python3 plugins/skill-governance-lint/scripts/lint-rubric-violation.py --log-dir eval-log --n 3 --threshold 0.20 --out eval-log/trigger.json
    python3 "$SKILL_DIR/scripts/lint-rubric-violation.py" --logs "$SKILL_DIR/log" --rule "$RULE_ID"
    python3 "$SKILL_DIR/scripts/diff-rubric-impact.py" --proposal proposal.json --logs "$SKILL_DIR/log"
    
  • 発効: compute-rubric-hash.py --rubric plugins/harness-creator/skills/ref-skill-design-rubric/references/rubric.json → check-rubric-sync.py(exit 0 確認)→ git commit
  • 自動 rollback:
    python3 plugins/skill-governance-automation/scripts/rollback-to-stable.py \
      --rubric plugins/harness-creator/skills/ref-skill-design-rubric/references/rubric.json \
      --versions-md eval-log/rubric-versions.md \
      --params references/governance-params.json --dry-run
    

Gotchas

  • patchで内容変更は禁則: 文言のみ。閾値や severity 変更は最低 minor。
  • assign 側 override をrebaseし忘れる事故: deep-merge の most-specific-wins が壊れる(29章)。
  • eval-log がない: 影響評価できないので diff-rubric-impact.py は exit 2 でフェイルセーフ。
  • 緊急パッチ: high severity の誤検出固定は patch 例外(log に emergency: true)。

Additional Resources

  • templates/proposal.json — 改正提案テンプレ
  • plugins/skill-governance-lint/scripts/lint-rubric-violation.py — 時系列違反率検出(連続 N×閾値超 → trigger.json)正本(27章§3.2)
  • $SKILL_DIR/scripts/lint-rubric-violation.py — ルール別違反集計(単一 release/proposal 単位)
  • $SKILL_DIR/scripts/diff-rubric-impact.py — 差分影響評価
  • plugins/skill-governance-automation/scripts/compute-rubric-hash.py — rubric_hash 再計算(27章§8.2)
  • plugins/skill-governance-automation/scripts/notify-if-governance-trigger.py — Stop Hook 用招集通知(27章§3.4)
  • plugins/skill-governance-automation/scripts/rollback-to-stable.py — 安定版凍結条件を満たす版への自動 rollback(27章§9)
  • plugins/skill-governance-automation/scripts/doc-to-skill-adapter.py — 設計書を Skill artifact 化して自己採点する起動装置(26章)
  • references/governance-board.md — ボード構成
  • references/version-rules.md — semver規約
  • 27章: {{PROJECT_ROOT}}/doc/ClaudeCodeスキルの設計書/27-rubric-governance-runbook.md
  • 26章: {{PROJECT_ROOT}}/doc/ClaudeCodeスキルの設計書/26-meta-skill-dogfooding.md
  • 28章: {{PROJECT_ROOT}}/doc/ClaudeCodeスキルの設計書/28-script-execution-model.md
  • plugins/harness-creator/skills/run-build-skill/scripts/resolve-skill-dirs.py — SKILL_DIR 解決スクリプト

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

app-excellence

無料日本語概要

アプリ・Webサービス・業務ツールの制作を、証拠分析→確定的な初稿→要件定義→体験設計→機能分解→実装→品質ゲート→リリース判定の手順ゲート制で進めるスキル。質問で要件を埋めるのではなく、依頼文・既存コード・資料・ログから最有力案を選び、動く成果物を先に出して差分で改善する。ユーザーが「アプリを作りたい」「ツールを作って」「〜を自動化したい」「システム化したい」「要件定義」「仕様を決めたい」「UI/UXを設計して」「体験を良くしたい」「機能を洗い出して」「MVPを決めたい」「品質チェック」「リリースしていいか判断して」などと言ったら必ず使用する。外部データの取込・マスタ・締め処理を伴う業務システムでは references/data-lifecycle.md も併用する。新規・既存を問わずアプリの制作・改善・リニューアルで使用する。

daishiman/harness-dev102026年10月12日 更新

app-orchestrator

無料日本語概要

Webアプリの準備→要件定義→設計→実装→公開→品質ゲートを実行する内部オーケストレーター。Claude Codeの /build-app /improve-app、Codexの $build-app / $improve-app から明示的に委譲された場合、custom agent起動時、または利用者が $app-orchestrator を明示した場合だけ使用する。一般のアプリ相談から暗黙起動しない。

daishiman/harness-dev102026年10月12日 更新

run-extract-blueprint が生成した章別ブループリントの忠実性を独立 context で評価したいとき、事実/推測区別と粒度と被覆を検証し draft_hash に束縛した PASS/FAIL verdict をローカル品質ゲート (C01 の周回内の受入判定・差し戻し) へ渡したいときに使う。

daishiman/harness-dev102026年10月12日 更新

assign-briefing-evaluator

無料日本語概要

確認点で利用者が見る深さを選んだあと打ち合わせ資料を作り手とは別の目で確かめたいとき、正確さ・言葉・見た目・シンプルさの指摘を資料の編集なしで受け取りたいときに使う。

daishiman/harness-dev102026年10月12日 更新

生成した handout 資料が初心者に伝わるか読みやすさレビューを依頼したいとき、独立 context のレビュアーから指摘と根拠つきの verdict を回収したいときに使う。

daishiman/harness-dev102026年10月12日 更新

Notion ページを描画する直前に粒度を検証したいとき、info-collector-agent ページと同等の section 充足度を section_canonical_map 基準で機械検証したいときに使う。

daishiman/harness-dev102026年10月12日 更新

daishiman のスキルをすべて見る

このスキルの問題を報告する