SuperAPI AI 工具集

spec-grill

通用与其它

查看项目

更新于 10-16 08:42

技能介绍

用途:在 spec/charter.md 与日常执行工作之间维护 spec/capabilities.md 这一能力契约层。该文件是可选的,仅在满足保留条件时创建,已存在则可修订;它不是由目录列表生成,也不是 charter 之后的必需步骤。

主要能力:默认以报告形式输出,采用最安全的解读,用户无需记住模式名。只有在明确编辑意图(如“write it”“add the missing capability”)或用户确认提议的编辑后才写入 spec/capabilities.md,且需先说明证据与拟写块。诊断、候选发现、单能力审查和既有谓词审计均以报告结束;Learnings 是写入门禁的唯一例外。

使用方式:可运行 node <skill-dir>/scripts/extract-signals.js --repo-root <target-repo> --json 获取全仓库候选的原始能力证据,需从已安装技能目录解析并显式传入目标仓库;该脚本不会写入 spec/capabilities.md,准入、合并、拆分与命名仍由本技能处理。

准入与契约:README、spec/charter.md 和 issues 是产品权威;源码目录是结构证据;提交范围是历史;CLAUDE.md/AGENTS.md 是可能引发问题的 harness 上下文,不能单独确立边界。能力需是重复出现的决策边界,包含可观察结果的 Goal、学习归属和与邻近能力有实质差异的 Behaviors。棕地仓库至少需要两类证据。每个能力包含 Goal、In-scope/Out-of-scope、Expected Behaviors、Hard Constraints;所有 Behavior 与 Hard Constraint 须通过 Authority、Distributional、Manipulability 三轴测试,未通过则重写或拆分。

文件纪律:单文件目标 5–10 个能力,超过 12 个或 400 行警告,仅在超过 15 个、500 行或需要独立审查路径时拆分。首次接受编辑时复制 templates/capabilities.md 并只写入被接受的能力;重跑时只编辑指定块。无修订号,git blame 即历史。Goal、Scope、Behaviors、Hard Constraints 经人工门控;Learnings 可由任何智能体或人按内容规则增删改;Decisions 为常设且人工门控。

限制:资料未提供具体收费、价格、平台支持范围或效果数据;该技能不自动写入能力文件,不将目录名或提交范围直接当作能力,也不在缺少证据时编造边界。