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

refactor-quality-gate

製品挙動を保つ中〜大規模リファクタで、独立した専門監査・実装・最終レビューを統合する。単一修正、機能追加、レビューのみには使わない。

インストール方法を見る

含まれるファイル(2)

  • SKILL.md8.6 KB
  • agents/openai.yaml342 B

SKILL.md(原文)

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

Refactor Quality Gate

このスキルは専門監査を再実装しない。固定scopeに対して別エージェントが元のarchitecture/front-endスキルを直接使い、main Codexが結果の採否、goal統合、実装、最終判定を担当する。

標準進行:

scope固定 → 専門監査を並行実行 → finding統合 → goal freeze → 依存順実装 → 独立review → 必要な修正 → 変更影響review

責務境界

  • 本スキル: scope、製品contract、禁止範囲、監査分担、finding採否、goal、実装順、検証、性能Gate、最終統合を所有する。
  • architecture監査: architecture-refactor-loopのRead-only audit modeをfreshな別エージェントが使う。
  • front-end監査: front-end-refactor-loopのRead-only audit modeを別のfreshなエージェントが使う。
  • test portfolio: main Codexが公開挙動と失敗原因を基準に確認し、テスト数や行数をgoalにしない。
  • 最終review: 実装者とは別のreviewerがreview-gateを使う。

監査エージェントはread-onlyであり、findingの採否、goal化、実装、完了判定をしない。main Codexは監査結果をそのまま採用せず、現在の到達経路、製品contract、変更可能範囲で反証する。

適用条件と禁止事項

次をすべて満たす場合だけ使う。

  • 複数module、state owner、resource lifecycle、React境界、性能、test portfolioのうち複数観点を横断する。
  • 現在の製品contract、対象surface、検証oracle、write禁止範囲を固定できる。
  • P1/P2を根本原因単位の独立したgoalへ分けられる。

UI、アクセシビリティ、公開API、保存形式、URL、event順、error semantics、外部作用を意図的に変えない。製品成果の変更が必要ならP0またはcontract decisionとして止め、Story/製品ownerへ返す。package、lockfile、toolchain、framework、dependencyをrefactorの都合で変えない。

既存の未コミット差分を最初に確認し、利用者または別writerの変更を戻さない。外部状態、version control、PR、merge、deployは利用者が明示的に許可した範囲だけで行う。

一時記録

本スキル自身の進行記録が必要なら/tmp/refactor-quality-<project>.mdを一つだけ使い、次だけを短く記録する。

  • scope、contract、禁止範囲、既存差分
  • 各専門監査の対象と結果
  • 採用/却下/deferした根本原因
  • goalのowner、write scope、依存、oracle、状態
  • 実装batch、検証、性能結果、review判定

本スキル独自のmanifest、schema、validator、case台帳は作らない。直接参照する専門スキルまたはreview-gateが自身の契約で必須とするtask-local成果物は、そのスキルの責務として許可する。branch、commit、worktree、port、sessionなどの実行識別子をPLAN、Story、EVIDENCEへ保存しない。

1. Scopeを固定する

production変更前に次を決める。

  • entry pointから利用側までのproduction surfaceと明示的なexcluded範囲
  • canonical state、主要データフロー、副作用/resource owner、公開contract
  • 現在の未コミット差分と保護境界
  • focused test、全体test、typecheck、build、必要な実Journey
  • write許可/禁止scope、外部副作用、停止条件
  • 性能に触れる可能性があるhot pathと既存fixture

scopeまたはcontractが曖昧なまま監査や実装へ進まない。

2. 専門監査を別エージェントへ渡す

architectureとfront-endの両方が適用される場合、別々のfreshなread-onlyエージェントへ可能なら並行して渡す。同じエージェントに両観点をまとめず、main Codex自身の事前結論や疑っている修正案を答えとして渡さない。

各依頼に含めるもの:

  • repositoryの絶対path、固定scope、contract、excluded範囲
  • git status --shortで許容する既存差分
  • 対応する元スキルとRead-only audit modeを直接使う指示
  • 編集、テスト実行、進捗file、commit/pushを禁止するread-only制約
  • 現在の実装と差分をfreshに読むこと
  • evidence付きfinding、却下/defer、既に直っている問題を分ける出力契約

別エージェントが利用できない場合、main Codexの自己監査だけで専門監査完了を名乗らない。利用できない観点を未確認として報告し、続行可否を判断する。

main Codexは別にtest portfolioを確認する。削除/統合候補は、同じ公開入口、同じ観測結果、同じ失敗原因を重ねて守るもの、到達不能な旧経路、内部実装だけを固定するものに限る。異なるstate transition、failure、retry、cleanup、event順、resource ownership、auth/client分離は統合しない。

3. Findingを統合してGoal Freezeする

両監査とtest portfolioの候補を一巡してから、同じ根本原因を統合する。

  • P0: 現在の製品contractまたは外部作用を破る。実装せずHOLDする。
  • P1: 挙動を維持したまま解消すべき重大な構造リスク。
  • P2: 挙動を維持したまま解消する根拠のある保守性問題。
  • P3/non-applicable: 好み、行数だけの分割、到達不能、根拠不足。実装しない。

各P1/P2 goalに、守るcontract、main/worker owner、狭く排他的なwrite scope、禁止scope、依存順、behavior oracle、focused/全体検証、必要な性能計測を固定する。新しい機能、UI、dependencyを解決策にしない。

4. 依存順に実装する

既存検証では守る挙動を観測できないgoalにだけcharacterization testを追加し、依存順に小さなbatchで実装する。main Codexはshared contract、state owner、resource lifecycle、routing、integration判断を持つ。別workerへ渡せるのは、判断が固定済みで独立し、write scopeが狭く、localで可逆、strong oracleがあるleafだけである。

各batch後にmain Codexがdiff、write scope、behavior oracle、focused検証を確認する。これは実装上の安全確認であり、新しい監査や最終reviewではない。

5. 性能Gate

render、context、canvas、list、scheduler、queue、serialization、resource lifecycle、bundle境界を変えるgoalは、実装前にmetric、workload、sample方法、baselineの幅、合格条件を固定する。同じhost、fixture、操作、build modeでbefore/afterを測る。

保守性目的ならbaseline変動を越えて悪化しないことを必須にする。性能改善を主張する場合だけ、追加の改善閾値を置く。計測差分が変動内なら改善を主張せず、計測用codeやartifactをproductionへ残さない。

6. 独立reviewと修正

全goalの実装と必要な性能確認後、固定scope、全goal、実diff、維持するcontract、対象外、検証結果をfreshな別reviewerへ渡し、review-gateで全適用観点を一度にreviewする。

fix_hereは根本原因単位にまとめて修正し、既報findingと修正差分が届く観点だけを再reviewする。contract、surface、因果経路、観点集合が変わった場合は差分reviewを続けずscopeを再固定する。修正前からの見逃しが判明した場合は、同じ探索不足が残した候補を一度だけfreshな専門監査で回復確認する。再び見逃しが出たら原因と影響範囲を確認する。固定契約内で根拠と修正方法が揃う問題は修正・検証を続け、契約判断や取得不能な必須証拠が必要な場合だけHOLDする。新しい根拠なしに全面監査を繰り返さない。

完了条件

  • 全専門観点を別エージェントがread-onlyで確認し、main Codexが採否を終えている。
  • 全P1/P2 goalと必要なcorrectionが検証済みで、未解決P0/P1/P2がない。
  • 製品挙動、禁止scope、外部状態を変えていない。
  • focused/全体検証、必要な性能計測が成功している。
  • 最新の独立review-gateがGOである。

最終報告は、固定scope、採用goal、変更path、対象外、検証、性能結果、review判定、残るfollow-upだけにする。

レビュー

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

同じリポジトリのスキル

概要と使いどころ

Rebuild a degraded AI image to remove crunchy textures and repeated-edit artifacts while preserving identity, style, and composition. Use for clean remakes, not ordinary retouching or upscaling.

日本語の概要は準備中です。原文の説明を表示しています。

ryryo/dot-claude-dev32026年10月10日 更新

analyze-seminar-video

無料日本語概要

セミナー・講義・ウェビナー・研修・実演動画をローカルで文字起こしし、内容を分析して、必要なスライド画像や動画クリップ付きのHTML/Markdown資料を作る。動画から学習資料・実践ガイドを作りたい場合に使う。映像作品の再現設計やCanvas生成は対象外。

ryryo/dot-claude-dev32026年10月10日 更新

architecture-refactor-loop

無料日本語概要

責務・依存方向・状態や副作用の境界を監査し、既存挙動を保って段階的にリファクタリングする。read-only監査にも対応する。

ryryo/dot-claude-dev32026年10月10日 更新

astra-rules-refactor

無料日本語概要

AGENTS.mdや既存スキルをGPT-6 Astra向けに監査・整理するときに使う。契約と意図的な他モデル委譲を保ち、重複、過剰な手順、曖昧な停止条件を修正する。

ryryo/dot-claude-dev32026年10月10日 更新

character-sheet-imagegen

無料日本語概要

人物の参照写真から、同一性を保った複数アングルのキャラクターシートを生成・修正する。指定された身だしなみや撮影表現も整える。

ryryo/dot-claude-dev32026年10月10日 更新

character-to-codex-pet

無料日本語概要

既存キャラクター画像を、承認制でピクセルアートの正準画像へ変換し、3状態パイロット、クロマ前処理、状態間ジオメトリ検証、9状態生成、遷移QA、仮配置、アプリ内確認、ロールバック可能な正式配置まで行う。キャラクターからCodexペットを作る依頼に加え、ジャンプで小さくなる、状態ごとに身長が変わる、足元が跳ねる、クロマ縁が出る、アニメーションを修復したい依頼で使用する。

ryryo/dot-claude-dev32026年10月10日 更新

ryryo のスキルをすべて見る

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