SuperAPI AI 工具集

spec-load

通用与其它

查看项目

更新于 10-15 20:11

技能介绍

spec-load 是一个上下文加载命令,用途是按当前工作上下文加载规格文档与经验教训。主要能力:支持 --category 与 --keyword 两个可选参数,无参数时触发全量加载;--category 会完整加载该分类的主文档以及其他文件中的匹配条目,--keyword 只返回 <spec-entry keywords="..."> 属性中关键字匹配的条目;工具会依据分类从 knowhow/ 自动发现。用法示例:$spec-load、$spec-load "--category coding"、$spec-load "--keyword auth"、$spec-load "--category coding --keyword auth"、$spec-load "--category review"。文件到主分类的映射包括 coding-conventions.md→coding、architecture-constraints.md→arch、test-conventions.md→test、review-standards.md→review、debug-notes.md→debug、quality-rules.md→quality、learnings.md→learning、tools.md→tools。执行流程含强制阻断的 Phase Gates:GATE 1 解析参数,缺少 --category 与 --keyword 且非空参数或分类无效时阻断;GATE 2 确认至少存在一个规格目录,未初始化 .workflow/specs/ 且无 CLI 回退时报 E001 阻断;GATE 3 读取并解析条目、应用关键字过滤,无可读规格文件时阻断。步骤为校验 .workflow/specs/、解析参数、通过 CLI 运行 maestro load --type spec [--category <category>] [--keyword <word>],CLI 不可用时直接读取文件并过滤,最后按文件名和分类分组展示结果并去除 <spec-entry> 标签。输出边界:该命令不产生任何文件写入,所有输出仅注入对话上下文。错误码:E001 致命,.workflow/specs/ 未初始化,需先运行 $spec-setup;W001 警告,关键字无匹配规格时会展示该分类下全部内容。限制:依赖已初始化的 .workflow/specs/ 目录,关键字过滤基于 <spec-entry> 的 keywords 属性。其他平台或价格信息暂未提供。