SuperAPI AI 工具集

load-plain-reference

编程与开发

查看项目

更新于 10-16 09:51

技能介绍

用途:该技能把 ***plain 语言完整参考 PLAIN_REFERENCE.md 载入上下文,用于编写和维护规格驱动的 .plain 规格文件。资料显示 ***plain 是一种由 AI 驱动的规格语言,从 .plain 规格文件生成生产可用代码,.plain 文件是事实来源,生成的代码为只读产物。

主要内容:.plain 文件由 YAML frontmatter 与 section name 标记的标准章节组成,包含四类章节:definitions(声明概念)、implementation reqs(如何构建,含单元测试说明)、test reqs(一致性测试要求)、functional specs(软件应做什么)。每个源文件至少需一个 functional spec 及一个 implementation req。概念写作 :ConceptName:,须先在 definitions 中定义且全局唯一、不得循环引用。资料还列出预定义概念,如 :plainDefinitions:、:plainFunctionality:、:Implementation:、:UnitTests:、:ConformanceTests: 等。

用法与要点:frontmatter 支持 import(仅含定义、实现要求与测试要求,不得含功能规格,默认目录 template/)、requires、description、required_concepts、exported_concepts。功能规格按顺序增量渲染,越靠后的规格对已渲染部分不可见;单条规格复杂度过高会返回“Functional spec too complex!”。acceptance tests 嵌套在功能规格下,仅在一致性测试启用时运行。链接资源仅支持同目录及子目录中的单个文本文件,禁止链接目录、URL 与二进制文件,URL 与文件夹路径也不得出现在 .plain 内容中(运行时代码自用的配置值除外)。结构化协议产物(如 JSON Schema、OpenAPI、GraphQL SDL、Protobuf 等)应作为资源文件链接,不应转写为散文。

限制:本次资料未提供该技能的具体安装命令、收费、平台支持或运行步骤,暂未提供。