用途:在撰写或编辑任何 .allium 规格前加载本技能,配合 chalk:voice 的通用原则与 chalk:mindmap 的结构规则使用;allium:tend 决定规格应包含什么,allium check 校验语法。
主要能力与规则:
- 规范陈述目标,未陈述的内容即被排除,缺失本身即断言。未点名某位跟随者的规范,等于已声明不存在该跟随者。
- 不得通过与其不包含的设计对比来定义规范;义务不得以其“不是什么”命名(XNotY 同时指两件事却只约束一件),应直接命名系统所做的事。
- 若某义务的主语在规范别处未被命名,该义务必须删除而非改名;规范不得为自身设计与其他设计争辩,理由属于提交信息与 PR。
- 判断标准是语义而非语法:约束系统的否定是内容,应保留;无法用 grep 识别,需遮住名字读义务本身。
- 名称是引用面,正文是解释;命名义务而非满足它的机制;一条主张对应一条义务;理由不得写进名称。
- 需求关键词按 RFC 2119:大写 MUST、MUST NOT、SHOULD、SHOULD NOT、MAY 为受级关键词,小写为普通英语;义务本身不得被分级。Allium 以 @invariant、@guarantee 为规范性、@guidance 为非规范性,两者可组合。
- -- 注释是规范的说明载荷;首句为 tl;dr 且不得标注;标记为原始文本,用 - 与缩进、不用加粗;每行一句,便于按 git diff 审阅。
限制:资料未提供该技能的安装方式、平台、收费或效果信息,暂未提供。