SuperAPI AI 工具集

lore-init

写作与研究

查看项目

更新于 10-16 01:30

技能介绍

用途:当项目还没有 docs/lore/ 目录、或用户要求初始化/引导项目 lore 时,用 lore-init 搭建知识库骨架。执行前需先阅读 ${CLAUDE_PLUGIN_ROOT}/reference/lore-spec.md,模板位于 ${CLAUDE_PLUGIN_ROOT}/reference/templates/。

主要能力与流程:先检测 docs/lore/ 是否已存在;若存在则进入 augment 模式,只补充缺失的核心文件(README.md、某领域的 pitfalls.md / business-rules.md),绝不覆盖已有内容。随后推断项目类型(前端应用、后端服务、库或 CLI),据此判断是否值得生成 api-map.md;不确定时应询问用户,仍无法确定则只搭建核心文件,跳过 api-map.md 与 architecture/。再推断初始领域,查看代码库顶层域或子系统,提出一两个起始领域(如 payments/、auth/),必须经用户确认后才创建;同时询问哪个领域是项目核心,仅在明确确认后标记到 Areas 表的 Core 列。

创建内容:从模板生成 docs/lore/README.md,填入所选领域;为每个起始领域生成 pitfalls.md 与 business-rules.md,替换 <AREA> 占位符;仅在项目类型需要时可选生成 api-map.md 和 architecture/index.md。

术语表:不在初始化时搭建。若存在根 CONTEXT.md / CONTEXT-MAP.md,则报告其为项目规范术语表并跳过 lore-ul 建议;否则查找 docs/lore/glossary.md,按规范它由 lore-ul 在首个术语与用户确认时惰性创建,缺失时应在报告中说明并建议运行 lore:lore-ul,不要自行创建。

触发接线:可主动提出在项目 CLAUDE.md(或 AGENTS.md)中加入一行 lore 指引,经用户确认后添加;若用户拒绝,仅展示该行供其粘贴。

限制:该技能是幂等的,绝不覆盖已有内容;在已有 lore 的项目上运行只会补齐缺失核心文件并报告新增内容。所搭建的是通用结构而非真实知识,领域初始为空,需用户后续通过 lore-capture 填充。