SuperAPI AI 工具集

edit-spec

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:该技能用于编辑 vigiles 项目的 .spec.ts 文件,从而改变编译生成的智能体指令文件(如 CLAUDE.md、AGENTS.md),可添加、修改或删除规则、章节、命令与文件指针。规格文件是唯一事实来源,指令文件为编译构建产物,不得直接编辑。

主要能力:支持增删改三类规则——enforce() 由真实 linter 规则支撑并校验存在且已启用;check() 用于文件配对等文件系统结构约定;guidance() 为纯文字、无法机械校验的约定。支持修改 sections 章节、向 commands 添加命令(会对照 package.json 校验)、以 ${file(...)} 在内联章节中放置经校验的文件指针。

使用方式:先在仓库根查找 CLAUDE.md.spec.ts、AGENTS.md.spec.ts 或匹配指令文件的 *.spec.ts。读取并理解规格结构后按用户请求修改;若不存在规格但存在手写 CLAUDE.md,建议使用 adopt-spec 技能,否则建议运行 npx vigiles init 脚手架。编辑完成后运行 npx vigiles compile 重新生成指令文件,再运行 npx vigiles lint 校验。若已安装插件,PostToolUse 钩子会在保存规格后自动重新编译。

适用场景:需要调整项目智能体指令、新增可校验规则、更新架构或定位章节、集中维护 AI 指令文件的团队与项目。

限制:不得直接编辑 CLAUDE.md / AGENTS.md(含哈希注释、属构建产物)。keyFiles 已弃用,禁止添加;编译可能报 stale-file、stale-command、invalid-rule、section-has-header 等错误。章节内不得包含 # 或 ## 标题。不应擅自升级强制级别或改动 linter 配置;enforce() 需要改动 linter 配置或安装插件时应告知用户并让其选择。若不确定规则是否存在,应询问用户而非猜测。