用途:生成或修订需求、设计、任务计划、测试计划及相关规格报告,让读者无需猜测系统行为或输出去向即可跟进流程。
主要能力:提供两套契约。writing-rules* 定义流程描述、受众分离、推理和序列图方面的通用 SW-* 规则;abstract-verbs* 提供稳定的 AV-* 候选模式及每处用法所需的证据。
使用方式:先判断输出属于需求、设计、任务计划、测试计划还是修订,并识别各节读者;再按语言规则加载写作契约——英文读 writing-rules.md 与 abstract-verbs.md,日文读 writing-rules.ja.md 与 abstract-verbs.ja.md,自动检测输出语言,显式语言覆盖优先,且只加载一对语言规则,不跨对混用。撰写流程描述时,应在同一句、列表项、段落或相邻序列图消息中可追溯四个要素:执行者、触发条件、可观察动作、结果去向。随后应用所选参考中的 SW-* 规则及语言特定规则,说明因果主张背后的机制,去除无依据的确定性、模糊措辞、强调词、预览、摘要和泛泛赞美。序列图中每条消息应命名数据,并显示接收方的下一步可观察动作。交付前按抽象动词表逐项自检。
适用场景:规格类文档的撰写与修订。
限制:所选参考文件缺失时应指出缺失文件并停止;抽象动词表列缺失或 ID 重复时,仅应用可用写作规则并报告无法自检,不推断替代行;源资料未确定四个流程要素之一时,用占位符或未决决定保留不确定性,不得编造。来源未提供收费、价格、平台等信息。