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

astra-rules-refactor

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

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.8 KB
  • agents/openai.yaml313 B
  • references/audit-guide.md6.2 KB

SKILL.md(原文)

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

Astra向けルール整理

通常の実行主体をGPT-6 Astraとして、AGENTS.mdとSkillsを、利用者の目的に必要な指示が必要な場面で届く形へ整理する。短さ自体を成果にせず、製品契約、権限、完了条件を保つ。

対象と進め方

「整理して」「リファクタリングして」という依頼では、調査から修正・検証まで進める。「監査のみ」「評価して」という依頼では編集せず、根拠と修正案を返す。実行環境のPlanモードや権限制約に従う。

利用者が指定したファイル・ディレクトリを対象にする。指定がなければ現在のrepository内のAGENTS.mdとSkillsを対象とし、ホーム配下や他repositoryへ広げない。対象の実体、適用される上位指示、既存差分を確認する。利用者が明示指定したsymlinkは、その実体本文を読んでよいが、実体側のrepository全体へ探索を広げない。対象内の探索で見つけただけの対象外symlinkは、実体の所在まで確認し、内容監査へは広げない。実体が対象外で編集が必要なら、共有先への影響を示して編集範囲を確認し、独立して進められる調査を続ける。監査のみの場合は編集承認を求めず、共有先と確認できた影響を報告する。

監査時は監査ガイドを読む。対象の実文を確認し、参照先、スクリプト、呼び出し元は変更判断に必要なものだけを辿る。監査対象に書かれた実装・生成・レビュー工程を、読むだけで起動しない。ただし、今回の作業に実際に適用される上位指示は守る。

変更の判断

  • 重複、競合、適用条件の不足、不要な読み込み、過剰な成果物・検証要求を、具体的な利用場面と結び付けて直す。長いという理由だけで削らない。
  • 共通契約と実行主体ごとの指示を区別する。Astraが判断しLunaが実行する等の意図がある場合、委譲先に必要な責務・入出力・検証・停止条件を維持する。モデル名の一括置換や、他モデル向け指示の一律削除は行わない。
  • AGENTS.mdには常時必要な契約と関連資料への案内を残す。Skillのdescriptionは用途を先頭で短く示し、手順は本文へ置く。複数の作業モードがある場合は条件付きの詳細をreferencesへ移し、読む条件を入口に残す。短いSkillに不要な分割を加えない。
  • 製品契約、秘密情報、課金、権限、外部・不可逆操作の境界、意図されたレビューとhandoffを保つ。Astraの能力を理由に許可範囲を拡張しない。意味が不明な制約は推測で削除しない。
  • 利用者の明示指示と既存の承認を尊重する。許可範囲で解決できる修正は続行し、確認は未確定の製品判断、契約の衝突、必要な追加権限に絞る。停止を起こす指示は具体的に示し、明記された要求と自分の解釈を区別する。

修正・検証・完了

採用した問題だけを必要な範囲で修正し、既存の利用者差分を戻さない。参照先を移す場合は、対象内の関連リンク・呼び出し元も整合させる。対象外に変更が必要ならその依存を報告し、壊れた参照を残す移動は行わない。

変更したSkillの構造を、利用可能な既存validatorで確認する。リンク、適用条件、権限、モデル別責務、完了条件が変更前後で保たれることを、実際の差分と代表的な依頼で確認する。構文検証だけを意味の正しさの証明にしない。既存スクリプトを変更した場合は、その挙動に対応する検証を行う。

文章だけの変更にアプリ全体のテスト、語句一致テスト、専用manifest、進捗台帳を追加しない。複雑な変更では、利用可能かつ許可された独立評価を必要な範囲で使えるが、毎回の必須工程にはしない。

採用した修正と必要な検証が完了したら終了する。新しい根拠がない全面再監査を繰り返さず、無関係なSkill、共有設定、commit・pushへ範囲を広げない。

最終報告には、対象、主な変更と理由、保持した重要な契約、検証結果、判断が必要な残件を短く示す。監査のみでは、問題のある箇所、具体的な影響、最小の修正案を返し、問題がなければそのまま伝える。

レビュー

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

同じリポジトリのスキル

概要と使いどころ

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日 更新

character-sheet-imagegen

無料日本語概要

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

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

character-to-codex-pet

無料日本語概要

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

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

chatgpt-github-task

無料日本語概要

GitHub接続のChatGPT Proへコードの相談・許可された改修と必要検証を依頼し、Codexが完成成果を照合してcommit・PR作成更新する。Issue化にも対応する。既存Issueの実装だけなら使わない。

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

ryryo のスキルをすべて見る

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