SuperAPI AI 工具集

grace-spec

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:通过访谈用户,生成 GRACE 4 的 GraceChangeSpec,写入 .grace/changes/active/C-*/ 目录。主要产物为 spec.xml(规范性变更规格),可选 design-context.xml(仅解释性),plan.xml 由后续 grace-plan 创建,本技能不创建或编辑。

主要能力:创建 spec.xml 时初始 status="draft",仅在用户明确批准后设为 status="approved";被拒绝或取消的规格以终态移入归档。直接 C-* 包装必须恰好包含一个有意义的 Summary、Goals、Constraints、NonGoals、AcceptanceCriteria、AffectedAreas 和 VerificationIntent 段,空容器不可用于批准。语义锚点是规范的、无属性的 XML 标签,不能是属性或属性值。

使用方式:先访谈用户收集需求,再写入变更包。写入后可建议运行 grace lint --path <project-root> --assertions current 作为实现前的活动基线检查,但不得将其作为目标或最终证据。

限制:spec.xml 是 grace-plan 的唯一事实来源,设计上下文不添加需求;不实现代码、不改变当前图或验证状态、不创建追溯性变更包。