SuperAPI AI 工具集

capture-rule

智能体与模型

查看项目

更新于 10-15 19:58

技能介绍

用途:把调查或实现中得到的持久知识,路由到合适的规则存放位置,使其在下次相关时自动注入。

主要能力与流程:

  1. 资格判断:只捕获可复用且无法从代码、git 历史或现有说明文件中直接看出的知识,如坑点、构建/工具怪癖、设计不变量、约定、决策背后的原因。若只是本次任务的一次性事实、仓库已有文档或读代码即可得出,则跳过并说明原因。需先确定洞察所属的目标仓库,不明确时从本次会话触及的文件推断并与用户确认。
  2. 路由到唯一存放位置:目标仓库自身代码/工具相关,写入该仓库的 .claude/rules/<slug>.md;涉及目标仓库文件但规则需放在 harness 工作区,写入 harness 的 .claude/rules-ex/<slug>.md;harness 自身机制写入 harness 的 .claude/rules/<slug>.md(常扩充 harness-internals.md);个人/跨项目偏好、反馈或本机事实则归入 auto-memory(MEMORY.md + memory/),此时不写规则,告知用户应放入 memory 并停止。
  3. 去重:在选定目录搜索同主题规则,已存在则更新而非新建,一个主题一个文件。
  4. 写入规则:使用 kebab-case slug,frontmatter 之下的正文即注入内容,需聚焦且用祈使句。.claude/rules 中 paths 可选,省略则对该仓库所有触及文件注入,可加仓库相对 glob 限定范围,匹配较宽松(隐式尝试前导 /),如 src/ 也匹配嵌套路径。.claude/rules-ex 中 paths 必填,缺失则规则被跳过;glob 相对工作区,可用 .. 指向同级仓库,匹配严格且锚定根目录(无隐式 /),用 ** 表示任意深度, 也可作为仓库名段,用于适用于任意同级仓库的洞察。跨仓库示例:paths 为 ../*/.github/workflows/*。若 harness 存在 .claude/rules/rules-ex-authoring.md 或 harness-internals.md,写入前应查阅其完整机制。
  5. 收尾:报告写入或更新的文件路径,建议提交(Conventional Commits:docs: 或 chore:)。不涉及插件版本号变更,规则与 memory 属于内容而非插件代码。

限制:不捕获一次性事实、已有文档或可直接从代码推导的内容;auto-memory 场景不写规则;rules-ex 的 paths 必填且匹配严格。