cyberagentgameentertainment SiriusPackages ドキュメント更新スキル
SiriusPackages の各パッケージに配置された CLAUDE.md（ルール・制約）と SKILL.md（設計詳細）を、最新のソースコードに基づいて更新する。
対象パッケージとファイルパス
| パッケージ | CLAUDE.md | SKILL.md |
|---|---|---|
| Sirius.Core | SiriusPackages/Sirius.Core/CLAUDE.md |
SiriusPackages/Sirius.Core/.claude/skills/ct-pkg-sirius-core/SKILL.md |
| Sirius.PostProcessing | SiriusPackages/Sirius.PostProcessing/CLAUDE.md |
SiriusPackages/Sirius.PostProcessing/.claude/skills/ct-pkg-sirius-postprocessing/SKILL.md |
| Sirius.DevSupport | SiriusPackages/Sirius.DevSupport/CLAUDE.md |
SiriusPackages/Sirius.DevSupport/.claude/skills/ct-pkg-sirius-devsupport/SKILL.md |
実行フロー
Step 1: 対象パッケージの選択
AskUserQuestion（multiSelect: true）で更新対象を選択する:
- Sirius.Core
- Sirius.PostProcessing
- Sirius.DevSupport
Step 2: 各パッケージについて以下を実行
2-1: 現状把握
- 既存の CLAUDE.md と SKILL.md を Read ツールで読む
- パッケージの主要ソースファイルを読む:
package.json— 依存関係の変化Runtime/**/*.asmdef— アセンブリ参照の変化- Feature クラス (
*Feature.cs) — パス登録の変化 - Volume クラス (
*Volume.cs) — 新しいVolume追加 - 追加・変更されたファイル（git diff で検出）
2-2: 差分分析
以下を確認し、更新が必要な箇所を特定する:
- 新しいクラス/パスの追加・削除
- 既存パスの登録条件変更
- パッケージ間の依存関係変更
- 新しいゴッチャ・制約の発見
変更が見つからない場合は「変更なし」と報告してそのパッケージをスキップする。
2-3: CLAUDE.md 更新案の作成
後述の CLAUDE.md ポリシーに厳密に従って更新案を作成する。 変更箇所のみを差分で表示する（全文書き直しではなく、追加・変更・削除を明示）。
2-4: SKILL.md 更新案の作成
後述の SKILL.md ポリシーに厳密に従って更新案を作成する。 変更箇所のみを差分で表示する。
SKILL.md の frontmatter（name, description）は変更しない。
2-5: ユーザー確認
各パッケージごとに更新内容のサマリを表示し、AskUserQuestion で確認する:
- 適用する
- 修正して適用する（フィードバックを受けて再作成）
- スキップする
2-6: ファイル書き込み
承認されたら Edit ツールで更新を適用する。
Step 3: 完了報告
更新したファイル一覧と主な変更点を表示する。
CLAUDE.md ポリシー（厳守）
CLAUDE.md はパッケージ固有の ルール・制約・ゴッチャ のみを記載するファイル。
含めるべきもの
- MUST: 違反するとバグ・ビルドエラーになるルール
- IMPORTANT: 知らないと間違いやすいゴッチャ・落とし穴
- 非自明な制約（コードを読んだだけでは気づきにくいもの）
含めてはならないもの
以下は 絶対に含めない:
- パッケージ情報（名前、バージョン、依存関係）—
package.jsonを読めばわかる - アセンブリ構成 —
.asmdefを読めばわかる - クラスやインターフェースの説明 — ソースを読めばわかる
- 設計パターンの説明 — SKILL.md の役割
- 「〜を担当する」「〜を管理する」のような機能説明
フォーマット
- MUST / IMPORTANT で重要度を明示する
- 見出し（
##）でカテゴリ分け - 箇条書きで簡潔に記述
- 50行以内を目標とする
検証テスト
各行に対して「この行を削除したら、Claude がこのパッケージで作業する際に間違いを犯すか？」を自問する。答えが No なら削除する。
SKILL.md ポリシー（厳守）
SKILL.md はパッケージの 設計詳細 を記載するファイル。コードの1ファイルからは読み取れない、アーキテクチャレベルの知識を提供する。
含めるべきもの
- コンポーネント間の関係性: パッケージ横断の依存、暗黙的な連携（例: Bloom→GBuffer）
- パス登録順序と条件のサマリテーブル: 複数パスの全体像
- 設計パターンの「なぜ」: AllowFlagパターン等の規約の理由
- 非自明な設計判断の理由: なぜこの実装になっているかの背景
- ワークフロー/パイプライン: 複数Stepにまたがる処理の流れ
含めてはならないもの
以下は 絶対に含めない:
- ASCIIディレクトリツリー —
Globツールで取得可能。最も陳腐化しやすい - ソースコードのコピペ（インターフェース定義、クラス定義等）— ソースを読めばわかる
- Enum一覧テーブル — ソースを読めばわかる
- フィールド/プロパティの列挙 — ソースを読めばわかる
- CLAUDE.md と重複する内容 — ルール・制約は CLAUDE.md に一本化
フォーマット
- frontmatter の name / description は既存のものを維持する
- テーブル形式はパスサマリ等の全体像把握に有効。積極的に使う
- コードブロックは設計パターンの例示（数行以内）にのみ使用