SuperAPI AI 工具集

spec-tech

设计与创作

查看项目

更新于 10-15 20:34

技能介绍

用途:撰写或修订技术规格(the how),位于产品规格(/spec-product)下游、按切片设计(/design)上游,用于记录持久架构与机制。

主要能力:技术规格与产品规格一样由三处协同写入构成——用 spec new(仅 subtype/title/slug)搭建骨架,手工编辑 spec-NNN.toml 中的脊柱与扁平字段,再用 spec req add 添加需求。身份、关系脊柱与扁平字段(含 c4_level、[[source]] 锚点)在 spec-NNN.toml,叙述在 spec-NNN.md;需求是同级实体(REQ-NNN),通过 members.toml 归属;技术规格间的 spec→spec 边用 doctrine spec interactions add/remove 写入,不手工编写。用 show 读取重组后的整体,用 validate 校验外键完整性,用 list 查看语料库。

关系脊柱:descends_from 为 tech→PRD 的单值外键;parent 为单一父级、无环包含(C4 分解)。包含关系不是同级边,parent 绝不用 interactions 边表达。C4 层级上,手工规格通常止于容器/组件级,代码级(C4 level 4)属例外。

三种规范形态:context 为全系统综合,无锚点、无 parent、无 descends_from;container 仅有 parent、无 descent;component 为 parent + descends_from 的薄能力形态。撰写前先用 spec show 读取对应形态。

限制:脊柱无 CLI 标志,需手工编写 TOML,spec validate 是完整性关口;需求为 pending 状态,无覆盖表、无状态推导;单一变更的具体设计应放在该切片的 /design,项目全局且承重的决策可写成 ADR(doctrine adr new)。