SuperAPI AI 工具集

commercetools-spec-driven-development

编程与开发

查看项目

更新于 10-15 20:14

技能介绍

用途:让规范驱动开发框架具备 commercetools 感知能力,使每个涉及 commercetools 的规范、计划与任务先加载匹配的 commercetools-* 技能。工作流仍由框架自身掌控,本技能只通过各框架已有的扩展面添加 commercetools 规则。

检测目录与叠加方式:.specify/ 对应 GitHub Spec Kit,在已有文件中插入标记围栏块,不新建文件;openspec/ 对应 OpenSpec,同样插入标记围栏块;_bmad/ 对应 BMad Method,在 _bmad/custom/ 写入稀疏覆盖文件。多个框架同时存在则各自应用。BMad 已安装文件不会被编辑,因其每次安装都会重新生成。

使用方式:先运行文档搜索脚本(会话内首次使用必须先执行),再运行安装脚本,不要手工编辑框架文件。

node "<this skill's directory>/scripts/docs-search.mjs" --query "<关键词>" --app-name "<宿主应用>" --model "<当前模型>" --limit 10

node scripts/setup.mjs

setup.mjs 参数:无参数或 init 应用叠加;status 只报告;remove 移除;--dry-run 预览;--framework speckit|openspec|bmad 限定框架;--cwd <dir> 指定项目目录。

叠加内容:Spec Kit 在 constitution.md 加入不可协商条款,在 plan-template.md 加入“Platform Skills Resolution”表,在 tasks-template.md 加入 [SKILL: <name>] 任务语法;OpenSpec 在 config.yaml 加入 context 与 rules;BMad 在 _bmad/custom/ 写入规则文件及 agent、规划工作流、build 覆盖文件。

限制与异常:未检测到框架(退出码 4)需先运行 specify init、openspec init 或 npx bmad-method install;目标文件缺失、锚点未找到、不支持的框架变体(退出码 5)、回滚(退出码 6)等情况需如实报告,不要绕过。BMad 需 v6.4.0 或更高版本。其他细节暂未提供。