skill-audit

スキル監査

依頼されたパッケージを、実際のリポジトリと検証範囲に照らして監査します。文体上の好みより、証拠を重視します。

モードを選択する

• 通常： 構造、起動、削減、または軽微な編集を行います。無料のプラグイン lint と手動スコアカードを実行し、クラウドクレジットは使いません。
• 正式： 公開準備、Tessl のスコア、または 100 点に到達させる必要がある実質的な発見・ワークフローの書き換えを行います。リポジトリが所有するランチャー、認証情報、クレジットが揃っている場合に限り、範囲を絞ったクラウドレビューを 1 回実行します。
• 実地： 最近のタスクで誤った起動、ガイダンスの不足、過剰な手順、または脆弱なワークフローが明らかになりました。その失敗を再現し、動作を変える最小限の修正を行います。

正式なコマンド、クレジットの範囲、フォールバック、オプティマイザーの承認については、Tessl のポリシーをお読みください。

ベースライン

1. リポジトリのガイダンスと対象の SKILL.md を最後まで読みます。

2. 監査の範囲に必要な場合に限り、リンクされたリファレンス、スクリプト、評価、ピッカーのメタデータ、パッケージマニフェストを調べます。

3. リポジトリが所有する検証方法を確認します。

4. 無料の構造的ベースラインを実行します。

   pnpm exec tessl plugin lint skills/<name>
   

5. スコアカードと作成ガイダンスを適用します。

正式なレビューを実施できない場合は、その制約を一度だけ記録し、lint と手動スコアカードを続行します。インストール、認証、別の CLI の解決、スコアの捏造、クレジットの無断使用は決して行わないでください。

監査項目

• 発見性： 名前と説明から、アクション、異なるトリガー、主な境界が分かり、類義語を詰め込みすぎていません。
• ワークフロー： 本文に明確な開始点、証拠のループ、停止条件、観察可能な完了が示されています。
• 段階的な情報開示： 主要な判断は本文に記載し、各リファレンスにはタスクに即した取得目的を持たせ、繰り返し発生する決定的な作業は既存のツールまたは保守されている実行可能なリソースに委ねます。
• リポジトリとの適合性： リンク、コマンド、メタデータ、規約が最新で、パッケージを単独で利用できます。
• 検証： 利用可能な中で最も強力な機械的チェックと、現実的な証拠のループが明示されています。
• 境界： パッケージが無関係な作業を取り込まず、兄弟スキルの識別情報にも依存していません。

無効なメタデータ、壊れたリンクやコマンド、完了条件の欠落、リポジトリとの競合、兄弟パッケージへの依存は、いずれも阻害要因です。肥大化した本文、曖昧な発見性、抽象的な例、重複する原則、既存の決定的な実装を文章で置き換えることは、重大な問題です。

改善

まず阻害要因と、効果の大きい重大な問題を修正します。起動、判断の質、または証明を改善する最小限の変更を優先します。削減する際は、代表的なリクエストについて一般的な経路のコンテキスト量を測定します。パッケージ全体の合計や行数だけでは、情報取得コストは分かりません。

編集後は、同じ lint とリポジトリのゲートを再実行します。スキルを、結論の漏えいや危険な外部作用なしに評価できる場合に限り、フォワードテストを使用します。

出力

scope: package or portfolio
validation: commands and Tessl score, or explicit no-score boundary
strengths: highest-signal dimensions
findings: blockers and major findings only
changes: files changed or smallest recommended change; include rerun status