SuperAPI AI 工具集

spec-grill

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

spec-grill 负责撰写 spec/capabilities.md,即 spec/charter.md 与当前 sprint 之间的中间层。它不是文件生成器,而是把现有仓库信号压测成持久的能力契约。适用于已有/棕地仓库在 spec-charter create 之后,或用户要求定义能力边界、组件契约、Behavior、Hard Constraint 时。文件边界参考 ../spec-charter/references/spec-axis.md;charter 方向归 spec-charter,系统形态归 spec-system-map,sprint 执行上下文留在 dev-backlog。

意图路由:无参数或模糊请求走 Grill Report,只诊断不写入;查找能力候选走 Candidate Boundary Report;补缺能力走 Next Capability Proposal,确认后才编辑;提到已知能力 slug 或自然语言能力区走 Specific Capability Review;审计走 Capability Audit Report。意图不清时优先只报告;证据不足时先出报告、指出缺失证据并询问后再写入。

辅助脚本:从已安装的 spec-grill 技能目录解析脚本,始终显式传入 --repo-root <target-repo>。棕地仓库无 spec/capabilities.md 或需要候选证据时,先运行 extract-signals.js --repo-root <target-repo> --json;该脚本只报告原始能力证据,绝不写入 spec/capabilities.md。

完成契约:每次运行结束给出简短总结,包括创建/编辑的能力块、拒绝或重写的谓词、新增约束、合并/拆分/拒绝的原始候选(区分原始信号、支持证据、缺失证据)、提升为约束的 Behavior、缺失证明或证据,以及后续 Learning Actions。

Grill Report 契约:用于无参数、模糊、候选发现和审计路由,包含 Evidence Read、Evidence Missing、Raw Candidates、Accepted/Rejected/Merged/Split Candidates、Sharp Questions、3-Axis Predicate Findings、Proposed Next Capability、Recommended Edit 等小节,诊断与改动分离。

棕地信号规则:extract-signals.js 从 README、charter(含旧根 CHARTER.md 回退)、system-map、CLAUDE.md/AGENTS.md、顶层源码目录、技能文件、脚本面、文档、测试和近期提交信息提取。草稿仅作访谈种子;README/charter/issues 是产品权威,源码目录是仓库结构证据,commit scope 是历史,CLAUDE.md/AGENTS.md 是开发脚手架上下文,脚手架上下文不能单独形成被接受的能力边界。被接受的棕地能力需要代码可理解的支持,通常至少两类证据(如 system-map 边界 + 脚本、源码面 + 测试、README/产品信号 + 命令面、反复提交 + 文档/测试);单一强用户陈述可覆盖,但报告必须明确说明。

文件形态:spec/capabilities.md 位于目标仓库根目录 spec/ 下。目标 5-10 个能力,超过 12 个能力或 400 行警告,超过 500 行、15 个能力或所有权边界要求时拆分。Goal/In-scope/Out-of-scope 经人工门控;Expected Behaviors/Hard Constraints 也经人工门控且必须通过 3 轴谓词测试;Learnings 只由有界写入器用魔术标记追加;Decisions 按惯例仅追加,跨领域决策通过 spec-charter amend 提升。

能力准入测试:能力应是反复出现的决策边界,有至少两类证据(除非用户明确授权单一来源),拥有主要中继学习目的地,Goal 可表述为可观察的用户或运维结果,且 Behavior/Hard Constraint 与邻近候选有实质差异。两个候选谓词几乎相同则合并;一个候选需要超过五个 Behavior 才完整则按契约边界拆分。仅目录、仅 commit scope、仅脚手架上下文的候选只作访谈种子,报告为缺少支持证据。

逐能力访谈:按顺序走 Goal(一句可观察结果)、In-scope/Out-of-scope、三个可验证 Expected Behaviors、两条 Hard Constraints;首轮到此为止,后续重跑再加。3 轴谓词测试包括权威轴、分布轴、可操纵轴,任一失败则重写或拆分。正向正常结果归 Expected Behaviors;亮线否定与反 Goodhart 守卫归 Hard Constraints。

写作规则:用户接受首个能力编辑且文件不存在时,把 templates/capabilities.md 复制到仓库根 spec/capabilities.md,只写被接受的能力;重跑时只编辑指定能力块,其余不动。不递增版本号,git blame 为准。仅在解释 Behavior/Hard Constraint 时回显 charter 决策,跨领域决策通过 spec-charter amend 提升。

资料未提供官方收费、价格、平台支持或具体效果等信息。