用途:批量向 ***plain 规范文件的 functional specs 部分添加多条功能规范,属于 plainlang/plain-forge 技能集。未提供安装命令与收费信息。
主要能力与用法:先(若尚未加载)使用 load-plain-reference 获取 ***plain 语法规则。识别目标 .plain 文件;若含糊需询问用户。通读整个文件,理解既有定义、实现需求与所有现存功能规范(含通过 import / requires 可达者)。按应出现的先后顺序草拟全部规范,暂不插入。
随后逐条处理:先用 analyze-if-func-spec-too-complex 分析复杂度,若判为 TOO COMPLEX,调用 break-down-func-spec 拆分为更小规范并替换后重新分析;再以单一批量调用 analyze-func-specs,输入集合应包含新规范、文件中每条既有功能规范及其 requires 链、以及本批已插入的规范,一次性获取全部冲突对,对每个冲突对调用 resolve-spec-conflict 处理并重跑直至 COMPATIBLE。检查通过后才追加到 functional specs 末尾(若需插在更早位置则按正确位置插入),最后重读文件确认位置、顺序与语法。
规则要点:每条规范隐含代码改动不超过 200 行;按时间顺序排列,新规范只能引用其之前的规范;使用与语言无关的行为与领域逻辑描述;每行必须以 - 开头,禁止裸续行,每行不超过 120 字符;外部接口须显式(REST 路径与方法、CLI 名称与参数、文件格式、消息结构等);引用概念须在 definitions 中定义;如需验收测试,批量插入后按条使用 add-acceptance-test。
禁止事项:不得跳过逐条检查、不得退化为两两冲突分析、不得先全部插入再分析、不得因数量多而手工代写、不得用于单条规范。资料未提供具体示例输出与命令细节之外的信息。