| name | grimodex-author |
| description | Grimodex の AI 指示、system prompt、Codex skill、AI policy、AI 経路レジストリ、 評価 fixture と品質 manifest を作成・変更し、正本、Iron Laws、契約テスト、 追跡可能性を一貫して更新する。AI behavior asset の追加・変更、 「AI指示」「システムプロンプト」「Codexスキル」「AI評価fixture」で使用する。 一般的な UI／DB／IPC／Rust 機能実装、テストだけの追加、レビューだけの依頼、 バグ修正には使用しない。
|
Grimodex Author
AI の振る舞いを決める資産を、実在する正本と評価証跡から切り離さずに変更する。
Ownership
対象ごとに次の正本を使う。
- Codex の常設指示と workflow:
AGENTS.md、.agents/skills/**
- アプリの localized prompt と trust boundary:
src/prompts/**
- Scan の versioned prompt と評価:
packages/scan-prompts/**
- AI capability／policy:
src/features/ai-policy/**
- AI 経路と model role:
src/features/ai-verification/aiPathRegistry.ts、
src/features/chat/modelRouting.ts
- 品質要件、評価ケース、差分評価:
policies/quality/iron-laws.md、
evals/quality-manifest.yaml、evals/impact-map.yaml
- AI 経路の検証方針:
docs/AI経路検証.md
src-tauri/capabilities/** は凍結された Tauri v1 shell の設定であり、現行 Electron の
AI capability 正本として変更しない。一般アプリ機能は implement-feature、新規 IPC は
add-electron-command、複数境界の既存経路再編は refactor-cross-boundaries を主フロー
とし、本スキルは AI behavior asset と評価証跡の部分だけを担当する。
Workflow
1. Precheck と正本の確認
AGENTS.md、policies/quality/iron-laws.md、
evals/quality-manifest.yaml を変更前に読む。git status と既存差分を確認し、ユーザーの変更を上書きしない。- 対象の正本、consumer、出力契約、関連 requirement ID、既存の focused test を
rg で実在確認する。ツール名や schema を推測で補わない。
- 入力、権限、必要データ、情報鮮度、期待出力を確認する。満たせない場合は
[precheck] と根拠を報告し、変更を開始しない。
2. 変更契約を定義する
- 保持する振る舞い、変更する振る舞い、禁止動作、出力 schema を明示する。
evals/quality-manifest.yaml から関連 requirement と Light／Heavy 評価を特定する。- prompt 変更では ja／en catalog、reserved data tags、JSON delimiter、parser、
prompt version のファイル内規約を確認する。
- 新しい AI 経路では
docs/AI経路検証.md に従い、aiPathRegistry.ts の verifier と
実在する test reference を割り当て、model role の完全性も維持する。
- 評価 fixture は会話、状態 ID、生成物をケース間で共有せず、requirement ID と
failure class を追跡可能にする。
3. 正本と証跡を一緒に変更する
- 同じ規則を別の instructions／policy tree へ複製せず、既存の正本を更新する。
- 正常系、拒否系、境界値、prompt injection、出力契約を focused test または評価ケースで
先に固定する。
- skill 変更では
skill-creator の現行 frontmatter と metadata 規約に従う。
- 副作用を伴う検証を無言で再試行しない。Heavy 評価や実 connector は、必要な資格情報と
実行権限が揃う場合だけ実行する。
- 依頼範囲外の refactor、commit、push、PR 作成へ広げない。
4. 検証する
- 変更資産に最も近い focused test／contract test を実行する。
pnpm verify:quality で Iron Laws、manifest、fixture、impact selector の整合性を確認する。$grimodex-impact-gate を使い、現在の差分へ選択された Light suite をすべて実行する。- Heavy 評価の
deferred は成功へ読み替えず、コマンドと延期理由を残す。
runner が存在しない評価は runnable Heavy にせず blocked と必要作業を残す。
- 失敗を
[routing]、[precheck]、[tool]、[policy]、[quality]、
[artifact] のいずれかへ分類する。
Completion evidence
完了時に、変更した正本、requirement ID、追加・更新した評価ケース、実行した focused test、
impact gate が選択した suite、Heavy の deferred 項目、残るリスクを報告する。検証失敗を
成功扱いにせず、出力 schema、引用、リンク、生成物の正常性を確認してから完了とする。
