mcpField
L
load-plain-reference

load-plain-reference

github.com/plainlang开发8042 次安装今天更新
代码仓库

关于 load-plain-reference

根据 `***plain` 编写任务选择相应语法规则和参考资料的 Skill。它会在会话首次调用时检查规则是否为最新,并避免加载无关指南。

主要功能

  1. 01按任务选择适用规则文件
  2. 02首次加载规则前检查版本
  3. 03跳过上下文中已有的规则
  4. 04按需加载集成指南

适用场景

  1. 01准备读取或编辑 `.plain` 文件
  2. 02查找特定编写任务的规则
  3. 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_conceptsrules/required-concepts.md
exported_conceptsrules/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 源文件中进行。

评论

支持 Markdown