workspace-audit

name	workspace-audit
description	「审计 / 诊断 / 跑一遍审计」触发。Phase 1 脚本自动 + Phase 2 模型推理，支持按类别选执行。
type	tool
output_format	.md
output_prefix	none
depends_on	[]
optional_inputs	[]
consumed_by	[]
disallowed-tools	Edit, Write, NotebookEdit
scripts	{"audit.sh":"全局审计 — bash .claude/skills/workspace-audit/scripts/audit.sh [类别号]","rules-review.py":"季度规则瘦身 review — python3 .claude/skills/workspace-audit/scripts/rules-review.py --model <ver>"}

Workspace Audit

触发与定位

做什么：全局诊断工具。两阶段审计：Phase 1 脚本硬检查（audit.sh，零推理纯 bash）+ Phase 2 模型软检查（语义推理的矛盾分析、安全扫描、瘦身建议）。

何时触发：用户说「审计 / 诊断 / 跑一遍审计」。

不做：业务决策（仅给出问题清单 + 严重度，不替 PM 拍板）/ 自动修复（输出报告即停）。

改脚本前 30 秒

hook 守的是「Read 过本文件」不看读了多少行。改 scripts/audit.sh / rules-review.py 用 Read 此文件 limit=80（§1+§2 即够）。

Public API（不可改签名）：

• bash audit.sh [类别号] — 全局审计入口（类别号逗号分隔）
• python3 rules-review.py --model <ver> [--dry-run] — 季度规则瘦身 review

会拦你的 hook：

• post-script-syntax-check — bash -n / pyflakes
• pre-skill-load-gate — 改 .claude/skills/workspace-audit/scripts/* 必先 Read 本 SKILL.md
• pre-commit 钩 audit.sh 默认类别（1,2,3,4,7,12,13,14,15,16,17,19,20,21），audit.sh exit code 非 0 阻 commit

改完跑啥：

bash .claude/skills/workspace-audit/scripts/audit.sh 1,2,3,4,7,12,13,14,15,16,17,19,20,21  # 跑 pre-commit 覆盖类别
bash .claude/skills/workspace-audit/scripts/audit.sh 18                              # 跑场景编号悬空（warn-only，不进 pre-commit）
bash .claude/skills/workspace-audit/scripts/audit.sh 19                              # 跑跨平台兼容 lint

深入读什么：完整类别清单 grep -A 5 "^## 执行步骤" SKILL.md；新增 cat 时改 audit.sh 对应 case 段；SKILL.md 章节标准 Read .claude/runbooks/skill-conventions.md。

执行步骤

Step 0：让用户选择审计范围

展示以下菜单，用户选哪些跑哪些。默认全选。

请选择审计范围（输入编号，多选用逗号分隔，直接回车=全部执行）：

Phase 1 — 脚本自动检查（audit.sh）

1. 文件完整性 — SKILL.md 存在性、frontmatter、references 引用、配置文件
2. 数值与格式一致 — 设备尺寸、配色 token、命名前缀、字体规范、字体栈顺序
3. 依赖与链路 — depends_on 闭环、循环依赖、链路覆盖、孤立 skill
4. 规则冲突 — 章节引用扫描、触发词重叠、术语一致
5. Token 预算 — 规则层总量、单 skill 成本、全链路 session 预算、臃肿文件
6. 产出物一致性 — 场景编号、术语、文件命名（按 scene-list.md 发现活跃项目）
7. SKILL_TABLE 一致性 — workspace-context.md 表格 ↔ frontmatter 比对
8. Scripts 字段存在性 — 各 SKILL.md frontmatter scripts: 声明的脚本必须真实存在
9. scripts/lib import 链路 — 共享模块能被 skill 脚本正确 import