Skip to content
cccskills
FreePublished on GitHub

run-migrate-audit

既存 CLAUDE.md/prompt 集を Skill 群へ移行したいとき、棚卸し分類を機械化したいときに使う。

The English summary is being prepared. Showing the original description.

See how to install

Files included (7)

  • SKILL.md11.1 KB
  • prompts/R1-audit.md6.7 KB
  • references/abstraction-checklist.md1.0 KB
  • references/classification-rules.md1.3 KB
  • references/resource-map.yaml236 B
  • schemas/output.schema.json2.6 KB
  • workflow-manifest.json2.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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-migrate-audit

Purpose & Output Contract

肥大化した prompt / CLAUDE.md / docs を doc/20-migration-path.md の 8 区分に 自動分類し、移行先 Skill 候補(ref-* / run-* / wrap-* / assign-* / delegate-*)と Hook/CI/CLI 化候補を JSON で出力する。

出力 contract

.claude/handoff/migrate-audit-<session>.json:

{
  "input_file": "{{path}}",
  "sections": [
    {
      "heading": "...",
      "classification": "always-on|ref|run|wrap|assign|delegate|hook|docs",
      "rationale": "...",
      "suggested_skill_name": "ref-..."
    }
  ],
  "summary": {
    "ref_candidates": 0,
    "run_candidates": 0,
    "hook_candidates": 0,
    "kept_in_claude_md": 0
  }
}

Boundary

  • 入口: 既存 CLAUDE.md / prompt ファイルパス(複数可)
  • 出口: 分類 JSON + 各候補に対する空 SKILL.md スケルトン提案
  • 非責務: 実際の SKILL.md 生成とその設計評価(assign-skill-design-evaluator 採点)→ 下流 run-build-skill(内蔵の設計評価ゲート)に委譲

Key Rules

  1. 入力を物理削除しない(思考リセット ≠ ファイル削除)
  2. doc/20 Step 1 の 8 区分以外を勝手に作らない
  3. 抽象化レベル: 入力中の具体的なプロジェクト名 / ドメイン語は {{var}} 化して提案する
  4. 分類根拠を 1 行以内で明示する(後段 evaluator が judge できるよう)

ゴールシーク実行

ゴール (Goal)

入力 CLAUDE.md/prompt 群が doc/20 の 8 区分へ分類され、各候補の移行先 Skill 名・根拠を含む分類 JSON と空 SKILL.md スケルトン提案が出力され、依存関係 lint(5 条件含む)を通過した brief が run-build-skill へ引き渡せる形で確定した状態。生成された SKILL.md の設計評価(assign-skill-design-evaluator 採点・閾値判定)は下流 run-build-skill 内蔵ゲートの責務であり、本 skill 自身は verdict を待たず brief/分類の確定で完了する。ゲート未達時の再分類は上位 orchestrator が該当 section で本 skill を再起動して行う(本 skill は評価器も run-build-skill も invoke しないため verdict を自ら受け取らない)。

目的・背景 (Why)

肥大化した prompt/docs の棚卸し分類を機械化し、横展開可能な抽象化された Skill 候補へ落とすため。入力構造(章立て・ドメイン語密度)に依存し固定手順では誤分類耐性が低いので、到達状態(分類 JSON + 依存 lint 通過 brief)をゴールに据える。実際の SKILL.md 生成とその設計評価は責務外(下流 run-build-skill が内蔵ゲートで担う)。

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

  • 入力棚卸し (migrate/audit.py --input <path> --output .claude/handoff/migrate-audit-<session>.json) を実施し、各 section が 8 区分(always-on/ref/run/wrap/assign/delegate/hook/docs)のいずれかに分類済み
  • 各分類に 1 行以内の根拠(後段 evaluator が judge 可能)が付与されている
  • 具体プロジェクト名 / ドメイン語が {{var}} へ抽象化された suggested_skill_name になっている
  • 分類結果がユーザーへ提示され、誤分類は手動修正済み
  • migrate/to-brief.py --audit-json ... で run-build-skill 起動 brief を生成済み
  • Gotchas 累積閾値超えの section に frontmatter lint -> Hook -> CI -> CLI 昇格パスが示されている
  • lint-dependency-direction.py --skills-dir .claude/skills/ が通過している
  • brief を run-build-skill へ引き渡せる形で確定した(本 skill の完了はこの brief/分類の確定まで。SKILL.md 生成とその設計評価=pair: 宣言の assign-skill-design-evaluator fork 採点は下流 run-build-skill 内蔵ゲートが担当し、ゲート未達時の再分類は上位 orchestrator が該当 section で本 skill を再起動して行う)
  • lint-skill-dep-step7.py --skills-dir .claude/skills/ の 5 条件(wrap に base / evaluator に pair / pair 相手の存在 / dangerous run に DMI=true / ref が到達不能でない)が全 PASS
  • 入力ファイルを物理削除していない(思考リセット≠削除)
  • kept_in_claude_md が 0 でない(repo identity 等は CLAUDE.md に最低限残す)

ゴールシークループ

正本 ../run-build-skill/references/goal-seek-paradigm.md の 6 ステップに従う。本スキル固有差分:

  • 対象ファイル: 入力 CLAUDE.md/prompt(複数可・read-only / 物理削除禁止)、出力 .claude/handoff/migrate-audit-<session>.json(分類 JSON)と run-build-skill 引き渡し用 brief
  • 引き渡し先: run-build-skill(brief handoff)。設計評価=pair: 宣言の assign-skill-design-evaluator fork 採点は run-build-skill 内蔵ゲートが担い、本 skill は評価器も run-build-skill も直接 invoke せず brief 確定で完了する。ゲート未達 verdict を契機とする再分類は上位 orchestrator が本 skill を再起動して行う(本 skill 自身は verdict を待たない)
  • 固定パス/閾値: doc/20 の 8 区分以外を作らない、step7 の 5 条件は全 PASS 必須。下流ゲートの評価器スコア閾値未満は上位 orchestrator 経由で該当 section を再分類差し戻し
  • 中間状態(部分完了)で lint を fail させない(--allow-partial)。決定論的検査は ## 検証/lint へ寄せ [x] 判定する
  • 規定周回を超えても未達なら残項目を open_issues として記録し上位 orchestrator へ差し戻す

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

  • 入力棚卸し: python3 plugins/skill-governance-migration/scripts/migrate/audit.py --input <CLAUDE.md path> --output .claude/handoff/migrate-audit-$(date +%s).json
  • レビュー: 分類 JSON をユーザー提示し誤分類を手動修正
  • brief 生成: python3 plugins/skill-governance-migration/scripts/migrate/to-brief.py --audit-json .claude/handoff/migrate-audit-<session>.json
  • 昇格候補抽出: Gotchas 累積閾値超え → frontmatter lint -> Hook -> CI -> CLI
  • 移行後 lint: python3 plugins/skill-governance-lint/scripts/lint-dependency-direction.py --skills-dir .claude/skills/
  • 引き渡し・再起動受け: 確定 brief を run-build-skill へ渡す。生成後 SKILL.md の設計評価(assign-skill-design-evaluator fork 採点)は run-build-skill 内蔵ゲートが実施する。ゲート未達時は上位 orchestrator が本 skill を該当 section で再起動し brief を再分類する(本 skill 自身は verdict を待たず brief 確定で完了)
  • 依存 lint(5条件): python3 plugins/skill-governance-lint/scripts/lint-skill-dep-step7.py --skills-dir .claude/skills/

Gotchas

  • 中間状態(Step1〜4 部分完了)で lint を fail させない(--allow-partial モード)
  • 具体ドメイン語を Skill 名に焼き込まない(横展開不能になる)
  • kept_in_claude_md が 0 になったら警告(CLAUDE.md は repo identity 等で最低限残すべき)

Additional Resources

  • 設計書 20 章 全 7 ステップ
  • references/classification-rules.md — 8 区分判定ルール
  • references/abstraction-checklist.md — 具体名 → 変数化の判定基準

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

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

The English summary is being prepared. Showing the original description.

daishiman/harness-dev10Updated Oct 19, 2026

See all skills by daishiman

Report a problem with this skill