锋刃配置审计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/hone。
技能介绍
为什么需要专门的 CLI 配置审计
Codex、Antigravity(Gemini CLI)和 Claude Code 的配置分散在 ~/.codex/、~/.gemini/、~/.claude/ 以及项目内的 CLAUDE.md、AGENTS.md、settings.json 等文件中。设置层叠(插件 → 用户 → 项目 → 本地 → 托管)容易互相覆盖;MCP 服务器的 PAT 范围、OAuth 传输和 RFC 8707 资源绑定一旦配错,可能把 Shell 访问和数据外泄风险放大。Hooks 在 -p 非交互模式下行为与文档预期不一致、wire_api = "chat" 已弃用等问题,单靠「凭感觉改配置」很难系统对齐官方最佳实践。
Hone 如何工作
Hone 扮演 AI CLI 配置审计员:只读配置、只出建议,永不直接编辑任何配置文件,也不读取认证令牌与会话历史。
工作流固定为 FETCH → AUDIT → PROPOSE:
- FETCH:用 Web 检索对照 Codex / Antigravity / Claude Code 官方文档与发布说明,对引用来源做 T1–T4 层级标注。
- AUDIT:按目标 CLI 读取全部相关配置,对照
reference/audit-checklist.md逐项检查(模型与信任级别、MCP 健康度、权限 allow/deny、hooks 结构与退出码、CLAUDE.md 行数与指令密度等)。 - PROPOSE:用 Before/After 差异格式输出改动建议,并为每条标注 P0–P3 优先级与 safe / ask-first / risky 安全分类。
子命令可按范围收窄:codex(含 wire_api 弃用)、agy(Antigravity 安全与 GEMINI.md)、claude(权限、MCP、hooks)、或默认 audit 做全面审计。涉及 hooks 设计/调试会路由到 Latch;纯 Shell/编辑器环境则交给 Hearth。
边界与注意点
涉及信任级别变更、MCP 增删、权限或 hooks 改动类建议,Hone 会先询问再推进。它不做代码 review(Judge)、不做 OWASP/WCAG 合规(Canon)、也不替代 Latch 做 hook 实现。审计前必须先 FETCH 官方文档;不会仅依据 T4 来源给出核心建议。对超过 300 行 的 CLAUDE.md、宽范围 MCP PAT、第三方插件自动更新等会按 SKILL 内阈值标为 P0/P1,便于你按风险排序处理。
使用场景
- 团队统一接入 Claude Code 前,需对照官方清单审计项目内 `settings.json`、权限 allow/deny 与 MCP 服务器版本锁定
- Codex 自定义提供商仍使用 `wire_api = "chat"`,需在升级后排查硬错误并整理 config.toml 迁移项
- CI 以 `claude -p` 非交互跑流水线,需确认未依赖 PermissionRequest hooks,并改用 PreToolUse 做权限门控
- 仓库同时存在 AGENTS.md 与 CLAUDE.md,需检查两套指令是否漂移并决定是否收敛为单一可信源
适合人员
- 负责编写与下发组织托管 Claude Code 策略的平台工程师,需要发现用户/项目/本地层设置冲突
- 在 MCP 接入生产前做最小权限审查的安全工程师,关注 PAT 范围、OAuth 2.1 与 RFC 8707 资源绑定
- 维护超 200 行 CLAUDE.md 的技术负责人,希望在模型升级前做防膨胀审计并拆到 `.claude/rules/`
- 日常维护 `~/.codex/` 或 `~/.gemini/antigravity-cli/` 的 SRE,需要对扩展、插件来源与自动更新做供应链风险标记