無料GitHub で公開

overlay-audit

指定した起動ディレクトリと、親が確定した dotfiles root のスキル配置・エージェント定義を点検する。判定の正は etc/audit-skill-agent-layout.py。実効 runtime の native 優先順、Cursor の name、 agent の model/role、生成物の状態を報告する。

「overlay 点検」「スキル配置」「エージェント定義は共通か」「layout audit」「/overlay-audit」で使う。

coil398/dotfiles

インストール方法を見る

含まれるファイル（1）

SKILL.md4.3 KB

SKILL.md（原文）

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

/overlay-audit — スキル / エージェント配置点検

指定された起動ディレクトリと、親が実在確認した dotfiles root を監査します。修正・再生成はせず、判定 engine の実測結果だけを要約します。あるべき形と合否は etc/audit-skill-agent-layout.py が決めます。

責任と読者

親が起動ディレクトリ、dotfiles root、監査範囲、判定結果の統合と報告を持つ。これは engine を一度実行する短い read-only 作業なので、親だけで完結できる場合は子を起動しない。委任する場合は、親が実在確認した engine の物理 path、対象、変更禁止範囲、返却形式を担当へ渡し、担当自身に必要な Skill/reference を Read させる。

担当は engine の実測 output と未確認範囲だけを親へ返し、配置・生成物・report・記憶を変更しない。子へ親用の監査進行や委任手順を渡して再起動させず、FAIL/WARN の意味と最終報告は親がこの Skill と engine の結果を照合して決める。

実効配置と優先順

共有 Skill の種は .agents/skills です。Claude は .claude/skills の配布先を使います。
Codex は共有 Skill を直接使います。CODEX_EXCLUDED_SHARED_SKILLS の共有 Skill は無効化されます。
Cursor は .cursor/skills/<name> の native overlay を優先し、link.sh が ~/.cursor/skills に実体 directory として materialize した内容を読みます。overlay と共有側の本文差は、生成器が lockstep を宣言している場合を除き単独の FAIL としません。
Cursor agent の model / role、Skill frontmatter の name と親 directory、home materialize の一致は engine の出力を正とします。Skill 本文へ判定規則を複製しません。

手順

1. 入力の確定

起動ディレクトリ引数は runtime の構造化された引数として受け取ります。省略時は runtime が渡した現在のディレクトリを使い、未引用の shell word splitting、glob、eval で再解釈しません。dotfiles root も親が実在確認した値を使い、未確認の home path を補いません。

TARGET_CWD="<runtime が確定した起動ディレクトリ>"
DOTFILES_ROOT="<親が実在確認した dotfiles root>"
python3 "$DOTFILES_ROOT/etc/audit-skill-agent-layout.py" --cwd "$TARGET_CWD" --dotfiles "$DOTFILES_ROOT"

起動ディレクトリが repository 内なら engine が Git top-level を解決します。対象が存在しない、dotfiles root や engine が存在しない場合は、状態を変えずに停止して理由を報告します。

2. 判定結果の扱い

出力の LEVEL<TAB>repo<TAB>topic<TAB>message と SUMMARY fails=N を読み、FAIL は engine が示した壊れた生成物・配置だけを報告します。WARN は現行 native overlay 方針に沿う限りエラーへ昇格しません。生成器、seed、link、home materialize を起動して結果を補いません。

報告は次の順で、対象と実測値を明示します。

対象: 指定起動ディレクトリから解決された Git root、dotfiles root
Skill: .agents の件数、Claude 配布、native overlay の有無
Cursor: overlay の name == folder、実行時契約、home materialize
Agent: 各 runtime の件数、欠け、Cursor の model / role
本文: identical / vocab-only / substantive / generated-stale / native-overlay
generator: engine が出した生成器検査の結果

3. 不変条件

ファイルを Edit、Write、seed、sync、再生成しない
判定ルールをこの Skill に追加せず、engine の判定を正とする
overlay 本文を byte 一致させる修正を提案しない

レビュー

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

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

agent-cli

無料日本語概要

ある AI エージェントから別の AI CLI（devin / codex / claude / cursor-agent / opencode / gemini / grok）を非対話で呼び出すときの実行規則。print モードの選び方、認証・権限・cwd の罠、出力フォーマット、ACP 起動の注意をまとめる。「codex に投げて」「devin を CLI から呼んで」「別エージェントに委譲」といった依頼で使う。ユーザーが /agent-cli と入力したら使う。