workspace-surface-audit

workspace-surface-audit スキルの概要

workspace-surface-audit でできること

workspace-surface-audit スキルは、読み取り専用の監査ツールです。目的は実務的で、「このワークスペースとこのマシンは、今実際に何ができるのか。次に何を追加または有効化すべきか」を見極めることにあります。アクティブな repo、MCP servers、plugins、connectors、env surfaces、harness setup を確認し、そのうえで最も価値の高い ECC-native skills、hooks、agents、operator workflows を提案します。

どんな人に向いているか

Claude Code のセットアップ中の人、automation を追加する前に workspace を見直したい人、repo は「準備できていそう」なのに capability が足りない理由を知りたい人に、workspace-surface-audit スキルは向いています。特に、skill、hook、agent、MCP server、external connector のどれを選ぶべきか判断したい場合に役立ちます。

何が優れているのか

一般的な prompt と違い、workspace-surface-audit は「すでに利用可能なもの」「部分的に設定されているもの」「まだ実装が必要なもの」を切り分けるよう設計されています。そのため、Workflow Automation における出力が意思決定に直結しやすくなります。特に、散発的な plugin アドバイスではなく、ECC-native coverage を重視したいときに強みがあります。

workspace-surface-audit スキルの使い方

workspace-surface-audit をインストールする

repo の skill install フローを使い、監査したい workspace をこの skill に指定します。典型的な install command は次のとおりです。

npx skills add affaan-m/everything-claude-code --skill workspace-surface-audit

別の skill manager を使っている場合でも、slug は同じ workspace-surface-audit を使ってください。workspace-surface-audit install は監査の挙動を変えるものではなく、自分のローカル skill system でこの skill を使えるようにするためのものです。

適切な入力を与える

workspace-surface-audit usage をうまく使うコツは、曖昧な依頼ではなく、具体的な対象から始めることです。良い prompt には repo、environment、goal を明示します。たとえば、「この workspace の Claude Code 対応状況を監査し、すでに設定済みのものを列挙し、次に追加すべき不足 surface を上位3件提案して」といった形です。

より強い入力には、通常次の要素が含まれます。

• repo path または workspace 名
• MCP、plugins、env vars、hooks、agent routing のどれを重視するか
• 読み取り専用の監査が欲しいのか、続けて implementation plan も欲しいのか
• secret disclosure をしないこと、外部 plugins を使わないことなどの制約

最初に読むべきファイル

workspace-surface-audit guide を進めるときは、まず SKILL.md を読み、続いて README.md、AGENTS.md、metadata.json、そして存在するなら rules/、resources/、references/、scripts/ の各フォルダを確認してください。この repository では SKILL.md が主ソースなので、出力を依頼する前に監査ルール、入力の前提、workflow の境界を読むことに価値があります。

結果を良くする workflow

この skill は2回に分けて使うと効果的です。まず surface inventory を依頼し、そのあと recommendations を依頼します。こうすると、監査が「まずもっと入れよう」という方向に早まりすぎず、すでに何があるかを先に確認できます。workspace-surface-audit for Workflow Automation を使う場合は、各 finding を already available、partially available、missing に分類し、そのうえで次の action を impact と effort で順位づけするよう求めてください。

workspace-surface-audit スキル FAQ

workspace-surface-audit は Claude Code のセットアップ専用ですか？

いいえ。最も強いのは Claude Code と ECC-native workflows ですが、考え方自体はもっと広く使えます。repo config、connected services、env files、automation layers から capability が生まれる workspace 全般の監査に役立ちます。

通常の prompt とは何が違いますか？

通常の prompt でも「どの plugins を使うべきか」は聞けますが、workspace-surface-audit は実際の workspace surface を確認し、境界のある recommendation を出すために作られています。そのため推測が減り、環境が支えきれない tool を勧めすぎるリスクも下がります。

初心者でも使えますか？

はい。workspace と goal を説明できれば十分です。深い infrastructure knowledge は必要ありません。この skill は、あいまいな setup の悩みを実用的な inventory と次の一手に変えるためのものです。

どんなときに使わないほうがいいですか？

すぐに code changes が欲しいとき、secret values を露出させたいとき、workspace から切り離された一般的な brainstorming が欲しいときは、workspace-surface-audit を使わないでください。最も役立つのは、「何があるのか、何が足りないのか、次に何を有効化すべきか」を判断したい場面です。

workspace-surface-audit スキルを改善する方法

まず対象を絞る

workspace-surface-audit の結果を最も早く良くする方法は、監査範囲を狭くすることです。「環境全体を監査して」よりも、「Claude Code 対応の観点で repo config、MCP connections、env surfaces を監査して」のほうが有用です。範囲が具体的だと、recommendations も実行しやすくなります。

推測ではなく根拠を与える

すでに存在が分かっている file、service、connector があるなら、最初に伝えてください。そうすれば skill はそれらを再発見するのではなく、検証して分類できます。.mcp.json、.env、plugin settings、connected apps のような実際の surface 名を入力に含めると、workspace-surface-audit guide の品質が上がります。

優先順位付きの次の一手を求める

workspace-surface-audit の出力で本当に役立つのは、単なる inventory ではなく、優先順位のついた意思決定です。最も重要な不足 ECC-native skill、hook、agent、MCP 追加候補を上位で出し、それが重要な理由と、後回しにした場合の tradeoff も合わせて聞いてください。そうすると、監査が coverage だけでなく adoption value に結びつきます。

1回目のあとに繰り返す

最初の監査で gap を見つけたら、次は1つの gap に絞って再実行します。たとえば、「今度は MCP layer だけを監査して、これが connector、hook、skill のどれに当たるか教えて」と依頼します。この2回目で、workspace-surface-audit skill の出力はより正確になり、実装もしやすくなります。