用途
add-concept 用于向 Runpod 概念图添加或修改节点。概念图中的每个节点是 plugins/runpod/skills/runpod-usage/concepts/（下文简称 concepts/）下的一个 YAML 文件。该技能描述的是操作流程，而非文件格式；格式、kind、关系类型和写作风格定义在 concepts/README.md 中，编写前应先阅读。
每个文件都是面向公众的，内容必须可以安全展示给客户，并且有公开来源支撑，校验器会强制检查这一点。
主要能力
- 在创建前检查概念是否已存在：通过 grep 搜索 id、名称和别名，并使用
pnpm query concept解析名称与别名、pnpm query search查找提及该概念的规则。 - 判断应新增节点还是修改已有文件：如果只是已有概念的一个事实，应添加规则；如果是已有资源的新字段或状态，应加入该文件的
fields或states；只有当某事物可被客户或智能体单独命名，或是一个跨概念的流程时，才创建新文件。 - 选择 kind：resource、component、catalog、capability、infrastructure、billing、limit、tool、external、process，并设置
is_a与part_of。 - 查找公开来源：REST v2 规范、公开文档、本仓库技能、只读的 live-probe 请求。
- 编写文件：填写 id、name、kind、summary、product、is_a、part_of、aliases、surfaces、fields、states、relations、rules；process 还需按顺序添加 steps。
- 校验与查看：运行
pnpm format、pnpm validate --strict、pnpm test、pnpm build:graph，并在图中检查节点链接与面板。 - 关联指南：每个概念必须至少被一个技能、参考文档或 golden path 覆盖，否则
pnpm check:guides会失败；需按 write-guide 技能扩展或新建文档。 - 提交：使用 Conventional Commits 消息提交概念文件及关联文件。
使用方式
按技能给出的步骤执行：先检查是否已存在，再选择 kind，查找公开来源，编写文件，校验并查看，关联指南，最后提交。常用命令包括：
grep -ril "<term>" plugins/runpod/skills/runpod-usage/concepts/
cd ontology/tools && pnpm build:sqlite && pnpm query concept "<term>"
pnpm query search "<term>"
校验命令：
cd ontology/tools
pnpm format
pnpm validate --strict
pnpm test
pnpm build:graph
适用场景
当被要求添加概念、为概念添加规则、记录某个 Runpod 流程如何运作，或修复节点时使用。也适用于需要按步骤解释某事物运作方式的 process 节点。
限制
- 只写公开来源支持的内容；没有公开来源支撑的声明应省略。
- 不得引用内部文档、内部 id 或私有仓库。
- 未经询问不得创建可计费资源来验证声明。
- 不要使用
#注释，因为pnpm format会从数据重写文件并拒绝带注释的文件；上下文应放在 evidence 的note中。 - 校验器常见错误包括：引用了不存在的概念、
applies_to指向未声明的字段、提及内部信息、内容受时间限制、YAML 解析失败等，需按技能给出的方式修复。 - 每个概念必须至少被一个技能、参考文档或 golden path 覆盖。
关于收费、价格、平台支持范围等具体信息，资料中暂未提供。