用途
该技能只回答一个问题:这个仓库反复在做哪些事情,做成一个技能后能帮助 Claude 把它们做对。它只产出一份报告,不生成技能文件,也不改动代码。
主要能力
- 仓库勘察:统计文件数量与语言分布,读取依赖清单以识别框架与工具链,梳理目录树前两层,定位测试、CI、构建与部署脚本、迁移、代码生成输入和文档,并记录已有的 linter/formatter 配置。
- 采样策略:大仓库不逐文件通读,每种语言采样约 50 个文件,分布在各顶层目录,并偏向改动最频繁的文件;CI 文件、脚本和文档则完整阅读。报告中必须写明采样了什么、跳过了什么。
- 模式发现:依据 references/pattern-catalogue.md 寻找重复出现的多步流程(例如新增一个后台任务需要依次改动多个位置),记录模式定义、步骤与文件变动顺序、出现次数(用 grep/glob 实际计数并说明计数方法)、2–3 个具体路径证据,以及跳过或偏离步骤的不一致实例。允许从 git 历史重建流程,提交信息可作证据,PR 讨论不算。
- 覆盖检查:阅读 .claude/skills、.claude/rules、.claude/commands、.claude/agents、CLAUDE.md、AGENTS.md 及可访问的全局技能,判断每个候选是已被完全覆盖、部分覆盖(标记为扩展某个技能并指出缺失步骤),还是尚未覆盖。已有指导与代码实际做法矛盾时,只在“限制”中记录,不做修正。
- 分类判定:为每个模式指定唯一归属——技能、CLAUDE.md/规则条目、linter/formatter 配置、脚本或钩子。判定为技能需同时满足:三步以上或涉及三个以上文件;至少一步需要脚本无法做出的判断;写成规则会超过一小段。只有“技能”判定才作为推荐,其余归入“属于别处”并逐条列出。
- 评分:从出现频率、复杂度、易错性、未来频率四个维度各打 1–3 分,满分 12 分;低于 7 分或无法用至少两个真实实例支撑的候选被剔除;保留的候选标注置信度(高/中/低),低置信度只进“其他候选”,不进顶部推荐。
- 报告撰写:在仓库根目录写 skill-candidates-report.md,包含仓库摘要、顶部推荐(2–3 个)、其他候选(总计最多约 7 个)、属于别处、已被覆盖、限制等部分;每节没有内容时写“None found.”,表明已检查过。最后在对话中简要汇总推荐及分数、各节数量和报告路径,不主动提出代写技能。
使用方式
资料未提供具体安装命令或调用步骤。从描述看,它以技能形式运行于 Claude Code 环境,针对指定代码库执行上述审查流程;结束前要求 git status 显示仅 skill-candidates-report.md 为新增或变更,所有推荐引用的路径真实存在,所有出现次数来自实际计数,且不依赖会话历史或记忆。
适用场景
- 希望判断某个仓库是否值得沉淀仓库级 Claude Code 技能时。
- 需要基于代码事实而非主观印象,评估现有技能与规则覆盖缺口时。
- 需要把格式规范、脚本化流程与真正需要判断力的多步流程区分开时。
限制
- 只写一份报告,不生成技能草稿、模板或脚手架,也不修改代码、配置、CLAUDE.md 等。
- 证据只来自代码:源码、目录结构、测试、CI 配置、构建部署脚本、文档和已有 .claude/ 设置;不读取会话记录、对话历史、memory 文件等。
- 只关注代码中可见的模式;只在对话或纠正中出现的模式不在范围内。
- 不提供通用建议,每个候选都必须引用本仓库真实文件路径。
- 若仓库的模式只是格式约定,产出很少或没有技能推荐属于正确结果,不做凑数。
- 资料未提供具体安装命令、运行入口、收费或平台支持信息。