SuperAPI AI 工具集

lore-capture

写作与研究

查看项目

更新于 10-16 01:30

技能介绍

用途:当对话中出现代码本身无法揭示的知识时使用,例如用户解释的业务规则、规格、确认有意的行为、API 怪癖或决策背后的原因。SessionStart 钩子会在含 docs/lore/ 的仓库中提示该技能,但是否记录仍由使用者判断,也可随时主动调用。

主要能力与流程:先做边界检查,判断“有能力的工程师阅读当前代码能否自行恢复该知识”,能则不属于 lore,不记录。然后选择已有 <area>/ 或按模板新建区域(含 pitfalls.md 与 business-rules.md);坑点写入 pitfalls.md,规则或原因写入 business-rules.md,足够独立的话题可建 <topic>.md,新文件需带 file frontmatter(area: 与 kind:)。写入前先查重,若重叠则询问用户合并、取代或另立条目,未选择时默认另立并在正文注明重叠。条目以 ## 标题开头,紧跟一行 meta:code:(文件路径,可带 →)、updated:(当天日期)、status: active;若挂在术语下则加 term:。正文写清是什么、为什么、怎么做,尽量附具体示例,有可观察的“做对了”状态时也写明成功标准。新建区域或文件后更新 docs/lore/README.md 的 Areas 表。

限制:绝不记录代码已表达的内容,如结构、函数行为或 git 中已可见的修复,以免淹没真正的 lore。updated: 必须使用真实已知的当前日期或询问用户,不得编造或倒填。使用前应先阅读 ${CLAUDE_PLUGIN_ROOT}/reference/lore-spec.md,尤其是“What lore is / isn't”与 entry-meta 格式。