SuperAPI AI 工具集

learn

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:当用户要求“从项目学习”“提取规则”“发现模式”“生成项目规则”时,该技能自动分析当前项目代码库,提取开发约定、架构决策与编码标准,生成 Claude Code 可遵循的规则文件。

主要能力:作为双智能体架构中的编排器,负责收集项目上下文、把深度分析委派给 learn-analyst 子智能体、过滤排序结果、向用户展示发现,并把获批规则写入 .claude/rules/。子智能体只读分析,不改动项目文件。分析结果按影响分排序,每条规则需有至少两个文件的证据,影响分低于 4 被丢弃,并与已有规则去重,最多展示前 3 条。

使用方式:先确认项目根目录(含 package.json、pom.xml、pyproject.toml、go.mod、.git/ 等标志),检查已有规则并评估项目规模;再通过 Task 工具调用 learn-analyst 同步返回 JSON 报告;然后校验、去重、排序;用 AskUserQuestion 让用户选择保存全部、逐条选择或取消;获批后用 mkdir -p .claude/rules 建目录并写入 kebab-case 命名的规则文件。

适用场景:加入新项目后固化现有约定、开始大型功能前确保遵循项目模式、定期随项目演进迭代规则。

限制:仅写入当前项目的 .claude/rules/,不写全局路径;绝不自动保存,必须用户确认;已有规则冲突时需用户决定覆盖、合并或跳过;大型 monorepo 分析较慢,仅扫描代表性样本;多语言项目按语言分别生成规则;已有完备规则时可能找不到新模式;只做静态代码分析,运行时模式(如中间件顺序)不在范围内;生成的规则是起点,可后续编辑并提交到版本控制。