关于 load-plain-reference
根据 `***plain` 编写任务选择相应语法规则和参考资料的 Skill。它会在会话首次调用时检查规则是否为最新,并避免加载无关指南。
主要功能
- 01按任务选择适用规则文件
- 02首次加载规则前检查版本
- 03跳过上下文中已有的规则
- 04按需加载集成指南
适用场景
- 01准备读取或编辑 `.plain` 文件
- 02查找特定编写任务的规则
- 03加载集成规格相关指南
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ plainlang/ plain-forge --skill load-plain-reference安装后在 Claude Code 中输入/load-plain-reference确认已加载。
详细介绍
加载 ***plain 参考
仅加载当前任务所需的规则和参考资料。与此 SKILL.md 同级的 rules/ 下的文件是 .plain 语法和编写约束的权威来源。不要重述或覆盖这些规则。
首先,确认即将加载的规则是最新的。 在本次会话中首次调用此技能时,先调用 check-forge-version,再加载任何规则文件。过时的 plain-forge 会附带过时的规则,因此下文的每项路由判断都受其检查结果影响。
如果该技能报告安装版本过时或无法确认,请明确告知用户,不建议在过时的 plain-forge 上进行编写,并请他们先运行 npx plain-forge update,然后再继续——下文路由到的规则可能与当前渲染器的预期不符。
请让他们自行选择,不要阻止他们继续:如果他们拒绝更新,就继续使用磁盘上的规则,并将过时的安装版本视为之后出现意外行为时的首要怀疑对象。
在本次会话的后续调用中跳过检查;网络不可用时也跳过检查。
1. 考虑已加载的规则
- 如果当前上下文中已包含某条规则的完整内容,则不要重新读取该规则。
- 否则,在检查或更改
.plain内容之前,先读取下方路由表中适用的文件。
2. 加载适用的编写规则
所有路径均相对于此 SKILL.md。
| 任务或内容 | 规则文件 |
|---|---|
| 新模块、文件骨架、章节位置或注释 | rules/module-structure.md |
在章节间移动事实(参见 resolve-section-ownership) | rules/module-structure.md,以及涉及的每个章节对应的规则文件 |
| 定义或概念用法 | rules/definitions.md |
| 功能规格 | rules/func-specs.md、rules/semantic-ids.md |
| 测试 plain 文件或场景 | rules/test-plain-files.md、rules/semantic-ids.md |
| 实现要求或单元测试 | rules/impl-reqs.md |
| 测试要求或一致性测试 | rules/test-reqs.md |
import 模块 | rules/import-modules.md |
requires 模块 | rules/requires-modules.md |
required_concepts | rules/required-concepts.md |
exported_concepts | rules/exported-concepts.md |
链接文件或 resources/ | rules/linked-resources.md |
| 定义、实现要求或测试要求的文本 | rules/bullet-continuation.md |
任何 .plain 文本或示例 | rules/concise-specs.md |
| 起草或精简规格措辞,或检查规格是否冗长 | rules/concise-specs-examples.md |
对于整文件审查或涉及多个章节的任务,加载适用规则文件的并集。不要默认加载所有规则。
3. 仅在集成任务中加载集成规则
对于集成规格,始终读取:
rules/integrations.md
然后读取与集成形式相匹配的规则:
- 嵌入式集成:
rules/integration-embedded.md - 独立集成:
rules/integration-standalone.md - 嵌入式集成测试脚本:
rules/integration-embedded-testing.md
起草或精简集成规格措辞时,还要读取 rules/concise-specs-integration-examples.md。
普通的非集成规格不要加载集成规则。
4. 仅在需要时加载操作参考资料
如果参考资料看起来与编写规则冲突,以编写规则为准。
| 需求 | 参考资料 |
|---|---|
| 项目布局、事实来源模型或模板包含方式 | references/project-model.md |
| 渲染顺序、生成的产物、一致性工作流或测试脚本 | references/rendering-and-testing.md |
5. 继续执行任务
加载适用材料后,返回调用此技能的技能或用户请求。生成的代码应保持只读,所有修正都应回到相应的 .plain 源文件中进行。