SuperAPI AI 工具集

speckit-artifact

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:用于检查 Spec Kit 项目中生效的工件清单与组合栈,覆盖命令、模板、脚本、钩子。需 Specify CLI >= 1.0.7;若 specify --version 失败,先用 speckit-cli-setup 技能安装。

主要能力:列出项目可见的全部命令、模板、脚本和钩子;说明某工件由哪个项目、预设、扩展或内置层提供;查看优先级、组合策略、活动层与隐藏层;检查声明的钩子是否已注册并生效;将栈条目解析回 Spec Kit 使用的已验证清单贡献。

使用方式:在包含 .specify/ 的已初始化 Spec Kit 项目中运行。常用命令:specify artifact list --json;specify artifact info <name> --json;specify artifact info <kind>:<name> --json;specify artifact info <name> --kind <command|template|script|hook> --json;specify artifact lookup <lookupId> --json。工件 id 形如 <kind>:<name>,例如 command:speckit.specify。栈条目的 lookupId 标识该层背后的预设或扩展贡献,需原样传入 lookup。内置层没有 lookupId;项目层或仅约定层可能没有可解析的清单贡献。

限制:所有 specify artifact 子命令均为只读;当前 --json 为必需参数,缺失会报用法错误。list 与 info 返回有序栈,命令、模板、脚本的索引 0 为胜出层;钩子栈为叠加式,可有多条同时生效。组合策略包括 replace、wrap、prepend、append,钩子为 additive。active 与 hidden 相互独立:非活动层仍可能参与组合输出,除非被更高层的 replace 隐藏。钩子工件 id 对事件与目标命令组件做百分号编码,应原样复用返回的 id 与 lookupId,不要手动构造。