用途:Sus Spec 用于把尚未解决的意图写成可验证的规格,或在需要时修订、做结构检查。它只在明确请求或人工选择该工作流时进入;直接实现不产生规格。若工作过于琐碎、写不写契约都不会改变执行或评审,则只保留一句内联意图,不写文件。
主要能力:写规格前先读项目规则、现有代码、持久决策、相关产物与未决问题,锁定目标、受众、成功标准、边界与来源;对缺证据的决策先研究,再解决可逆约定;对仍有后果的开放行为,给出不同可行方案并按依赖顺序解决。选定的行为转为意图与可执行需求,在实质行为、公共契约、安全、高成本权衡、权威冲突和不可逆操作上冻结。未解决的选择保持 status: draft 并阻塞依赖工作。
产物与结构:产物写入 ~/.agents/artifacts/<workspace>/ 的绝对路径,<workspace> 取自仓库或工作目录 basename,sidecar 链接放在旁边;冲突或工作区不明确时给出可读名称选项;写入被阻止时提供授权重试、换用户目录或取消,绝不覆盖或回退到仓库、vendor 目录或临时路径。本地来源引用相对产物,绝对路径仅用于运行时交接。frontmatter 使用 type、id、title、status、owner、sources 等字段,sources 保持列表,SPEC- ID 唯一。必须有非空的 ## Intent 与 ## Requirements。每条需求含一个稳定的 ### AC-NNN ID、一个非空 - When: 条件(仅无条件不变量用 always)、一个非空 - Then: 可观察义务且恰好一个 MUST/MUST NOT/SHOULD/SHOULD NOT/MAY,以及一个具体 - Verify with: 方法,三项各一次且按此顺序,不添加其他需求正文行。
验证与输出:检查结构,仅在要求时修订;事实核验另行处理。要求 frontmatter 有效、ID 唯一、Intent 非空、每条需求一个义务,拒绝占位符、status: ready 下的阻塞问题、损坏来源和无可观察标准的模糊需求。仅检查模式只报告错误不编辑;写入/修订模式修复后重跑。交接前删去重复、软化、仪式和结构膨胀,不改契约、标识符、逐字来源、证据或行为。只返回规格与每个 sidecar 的可点击 Markdown 链接,标签用紧凑 ~/.agents/...,目标用完整绝对路径;只解释阻塞、创建失败、验证不完整或不可逆操作确认。完全处理且无下游步骤需要时,要求人工对产物及 sidecar 做一次处置:Delete、Leave 或 Promote。
限制:资料未提供具体安装命令、收费、价格、平台支持或效果数据。