SuperAPI AI 工具集

audit-encapsulation

智能体与模型

查看项目

更新于 10-16 00:23

技能介绍

用途:审计并修复 skill 封装违规,即外部消费者(规则、智能体、其他技能、文档)越过公开面,直接引用 .claude/skills/<X>/ 内部私有路径的问题。契约由 context/public-surface-contract.md 定义:公开面为 frontmatter、文档化动作、args/flags、/skill-name 斜杠调用及 scripts/ 入口面;私有面为技能目录内其他子目录、任意层级的 *.schema.json 及标题锚点。

主要能力:运行检测脚本 bash "${CLAUDE_SKILL_DIR}/scripts/detect.sh"(可选 --apply-filters),扫描消费方仓库中的 .claude/ 子目录(默认排除 skills/ 与 worktrees/)、.github/、docs/、.lefthook/ 及根指令配置文件,并按过滤分类区分合法命中与违规。合法情形包括自引用、KIND-1 元描述、KIND-2 结构性强制引用、KIND-3 自测夹具、镜像自动化、glob 配置、插件缓存与 worktree 路径。

使用方式:提供动作路由,空参数或 detect 执行默认检测并输出违规表;fix <file>:<line> 对单条命中做定向修复;file-issues 为每条非法命中批量创建跟踪项。修复路径分 A(将内容提升为技能外共享文档,需经 /extract-ssot verify)与 B(改为调用 /<skill-name> <action>;若动作缺失则记录待办并保留带 TODO(audit-encapsulation) 标记的违规)。

适用场景:技能维护评审、CI 或 git 钩子需要共享技能逻辑时的封装合规检查、定期封装审计。

限制:不做内容重复检测(属 /extract-ssot);不强制代码层公开/私有;不自动修复,每条 Path B 改动需用户审查;不适用于合法自包含技能的重构。资料未提供收费、价格与平台信息。