skill-review

技能审查

根据规范来源和实时证据审查已安装的清单。编辑前解析符号链接；已安装的根目录可能包含多个仓库和带命名空间的技能包。检查仓库状态并保留现有修改。

清单

列出技能根目录和规范目标。记录重名、失效链接、缺少 frontmatter、触发条件重叠以及较大的入口文件。区分受管理的来源与供应商或插件缓存。不要仅仅因为某个使用方根目录没有直接链接，就将某个目录视为孤立目录。

修改候选项前先阅读它。通过实时帮助信息或源代码核实命令，根据当前配置核实运行时事实，并根据用户请求和测试框架的层级核实行为规则。旧版 AGENTS.md 是需要审查的证据，并不能证明当前拓扑结构。

清理与修复

保留名称、来源、调用元数据、操作约束和特定领域的注意事项。删除重复的触发条件列表、过时的模型固定版本、复制过来的命令手册、重复的全局策略，以及无视已授予授权的审批关卡。

通过明确的触发条件披露分支专属参考资料。保留其中的链接。不要用空指针替代有用的操作手册，也不要将供应商缓存当作规范来源来更新。

使用 joelclaw skills ensure --help 查看支持的安装修复方式。替换任何内容前，先检查实际目录冲突。在所属仓库中添加或修改安装清单。

验证

在适用时检查元数据、链接目标、受影响的命令和提示词安装情况。对于较大的行为变更，使用贴近实际的模型变更前后案例进行测试。测试应包含已获授权的操作、缺失的输入、近似但不匹配的触发条件，以及必须坚守的边界。区分静态发现与观察到的执行结果。

报告每个已扫描来源的处理结果：已修改、已审查但未修改，或需要进一步审查。记录尚未解决的问题及其路径和原因。广泛的模式扫描并不等同于完整的语义审查。

可选的 garden 实现位于 packages/system-bus/src/inngest/functions/skill-garden.ts。调用前检查其当前事件、模式和计划；手动审计无需启动后台工作流。