vc-audit-context
Audit project context routing, shared-skill discoverability, and Claude/Codex wiring. Use when context docs or skill surfaces move, split, or drift.
它会碰到什么
逐条看命中(21 条严重或高危)
- 高
references/skill-routing-policy.json:3identity-write"AGENTS.md",
- 高
references/skill-routing-policy.json:4identity-write"CLAUDE.md",
- 高
scripts/shared-skill-utils.mjs:3exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/shared-skill-utils.mjs:3exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/shared-skill-utils.mjs:7exec-spawnroot = execSync('git rev-parse --show-toplevel', { stdio: ['pipe', 'pipe', 'pipe'] }).toString().trim(); - 高
scripts/validate-context-discovery.mjs:4exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-context-discovery.mjs:4exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-context-discovery.mjs:8exec-spawnroot = execSync('git rev-parse --show-toplevel', { stdio: ['pipe', 'pipe', 'pipe'] }).toString().trim(); - 高
scripts/validate-context-discovery.mjs:230exec-spawnexecSync(
- 高
scripts/validate-context-discovery.mjs:252identity-write"AGENTS.md",
- 高
scripts/validate-context-discovery.mjs:253identity-write"CLAUDE.md",
- 高
scripts/validate-context-discovery.mjs:295identity-write// (the directory may not exist yet). Kit-structural files (.claude, .codex, AGENTS.md)
- 高
scripts/validate-context-discovery.mjs:298identity-write"AGENTS.md",
- 高
scripts/validate-context-discovery.mjs:299identity-write"CLAUDE.md",
- 高
scripts/validate-context-discovery.mjs:340identity-write"AGENTS.md",
- 高
scripts/validate-protocol-discovery.mjs:8exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-protocol-discovery.mjs:8exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-protocol-discovery.mjs:10exec-spawnconst root = execSync("git rev-parse --show-toplevel").toString().trim(); - 高
scripts/validate-skill-keywords.mjs:6exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-skill-keywords.mjs:6exec-spawnimport { execSync } from "node:child_process"; - 高
scripts/validate-skill-keywords.mjs:47exec-spawnexecSync("node .claude/skills/vc-audit-context/scripts/generate-skills-catalog.mjs --check", {
这一栏是扫描器报的事实,不是结论。命中多不等于有毒(安全工具、规则库、示例脚本本来就会包含危险写法),命中少也不等于干净。它和你手上的凭据、文件、网络有什么关系,需要你自己看。
技能内容
Audit Context
> Output style: Follow process/development-protocols/communication-standards.md — answer-first, plain language, no unexplained jargon, TL;DR on long responses.
Use this skill to verify that the project's durable context layer is discoverable and organized.
Optional input: a context group, agent, skill, or folder scope to prioritize during the audit.
Workflow
- Run
find process/context/ -type f | sortto get the full file listing before routing.
This ensures no context file is silently skipped when the router is incomplete or drifted.
- Read
process/context/all-context.mdfor the context routing protocol. - Read
references/audit-context.mdfor the full audit process. - Run the context discovery validator:
node .claude/skills/vc-audit-context/scripts/validate-context-discovery.mjs
3a. Run the protocol discovery frontmatter validator (enforces discovery frontmatter on every
process/development-protocols/**/*.md, recursive incl. vc-system-behavior/; note.md is the
only intentional exclusion):
node .claude/skills/vc-audit-context/scripts/validate-protocol-discovery.mjs
- Run the shared skill routing coverage validator:
node .claude/skills/vc-audit-context/scripts/validate-skill-routing.mjs
- Run the skill cross-reference validator:
node .claude/skills/vc-audit-context/scripts/validate-skill-cross-refs.mjs
- Run the skill dependency/confusable analysis:
node .claude/skills/vc-audit-context/scripts/validate-skill-dependencies.mjs
node .claude/skills/vc-audit-context/scripts/validate-confusable-skills.mjs
- Regenerate or check the machine-readable skill catalog:
node .claude/skills/vc-audit-context/scripts/generate-skills-catalog.mjs --write
node .claude/skills/vc-audit-context/scripts/generate-skills-catalog.mjs --check
- Validate that every SKILL.md carries
trigger_keywords+ a validlayer
(contract|helper) and that the catalog is in sync:
node .claude/skills/vc-audit-context/scripts/validate-skill-keywords.mjs
- If any script reports failures, inspect the referenced files and patch the smallest
relevant surface.
- Re-run the failed validators until they pass.
For agent/skill harness validation (agent parity, skill frontmatter, README.md sync, protocol wiring), use the audit-vc skill.
Context Bootstrap (when process/context/ doesn't exist or needs full init)
Use when initializing a new project's context layer from scratch:
- Run
vc-scoutin parallel across major source directories (skip.git,node_modules,.claude, caches) to gather codebase summaries. - Create
process/context/all-context.md(routing table, architecture, conventions) and groupall-{group}.mdentrypoints for any durable domains identified. - Parallel reader strategy for existing context files — before updating, spawn subagents proportional to file count: 1-3 files read directly; 4-6 files use 2-3 reader agents; 7+ files use 4-5 reader agents (max 5), distributing by LOC.
- After generating or updating context files, run
find process/context -name '*.md' -print0 | xargs -0 wc -l | sort -rn— files over 800 LOC should be split into a context group or the user asked. - Finish by running the discovery validator (step 3 above) before declaring done.
Rules
- Treat
.claude/skills/as canonical;.agents/skills/is the Codex discovery symlink. - Treat
.claude/skills/vc-audit-context/references/skill-routing-policy.jsonas the explicit allowlist for intentionally non-routed shared skills. - Do not move large context files without updating
process/context/all-context.md. - Do not delete compatibility wrappers unless no current reference points to them.
- Keep context groups durable-domain based, not one group per temporary feature.
- When updating agents, mirror Claude markdown and Codex TOML surfaces together.
- Treat validator warnings as audit findings unless the user asks for a strict cleanup.
- Prefer validator-backed routing truth over adding more soft prose.
- Treat process/context/generated-skills-catalog.json as the machine-readable catalog owned by
audit-context.
想直接用这个技能?
本站把开放许可(MIT / Apache 等)的技能按仓库打包整理到网盘,点一下转存到你自己的网盘,不用一个个从 GitHub 拉。许可未声明的技能只给原始仓库链接,不打包。