Agent Skills
返回列表
🔒

锋刃配置审计

IT 运维与安全 更新于 2026.08.29

将以下提示词粘贴到你的 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,需要对扩展、插件来源与自动更新做供应链风险标记