用途:指导创建新的 .plain 模块,通过 requires 声明对构建链中另一模块的依赖。requires 用于建立模块间的构建顺序,被依赖模块先构建;它不必然表示当前模块扩展或依赖对方代码,也可能只是同项目内需按序构建的独立部分。
主要能力与机制:渲染时,被依赖模块生成的代码(plain_modules/<required_module>)会被复制作为起点;其功能规格(functional specs)会作为“先前功能规格”可见;仅被依赖模块的 exported_concepts 可用,而非其全部定义。若只需要共享定义与需求(无功能规格、无生成代码),应改用 import。requires 与 import 可同时使用:requires 指向其他根级模块,import 从默认 template/ 目录解析(无需前缀)。
使用方式:先确定新模块所依赖且已存在、可渲染的模块。在仓库根目录创建 .plain 文件(含功能规格的模块位于根目录,而非 template/),在 YAML frontmatter 中写入 requires 列表,例如 requires 下列出 base_module 路径。随后查看被依赖模块的功能规格(将作为先前需求,新规格不得与之冲突)与 exported_concepts;补充本模块特有的定义、实现需求、测试需求与功能规格,并检查冲突。示例结构:--- 中写 requires 与 description,正文分 definitions 与 functional specs。
限制与检查项:被依赖模块通过 exported_concepts 控制可见概念,其他概念均视为内部;仅 exported_concepts 可被引用。模块应位于仓库根目录,被依赖模块须存在且可渲染,新功能规格不得与被依赖模块冲突,模块至少含一条功能规格与一条实现需求,并注意 requires 与 import 不可混用。资料未提供该技能的安装命令、收费与价格信息。