SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场custom-skills-tool-overlap-analyzer

custom-skills-tool-overlap-analyzer

编程与开发

查看项目

更新于 10-16 02:03

技能介绍

用途

custom-skills-tool-overlap-analyzer 用于分析 AI 辅助开发项目中的工具重叠与优化机会。它面向项目工具生态的审计场景，比较对象包括智能体（agents）、技能（skills）、命令（commands）、钩子（hooks）与工作流（workflows）。其核心约束是：每种工具类型的比较只在该类型内部进行。

主要能力

该技能按照以下流程运行：

  1. 去重（Step 0）：许多项目会把相同工具分发到多个平台目录（如 agents/claude/、agents/opencode/、skills/agents/）。这些是有意的分发副本，并非冗余问题。去重时识别平台目录（/claude/、/opencode/、/gemini/ 视为平台专属，skills/agents/ 可能镜像 agents//），对跨平台的同名文件比较内容：内容相同或近似即视为单一工具，保留一个代表（优先 claude/ 或最先找到的）进行分析并记录去重结果。跨平台副本不视为重叠问题。

  2. 发现（Step 1）：按类型扫描项目中的工具。智能体搜索 .claude/agents/、agents/、skills/agents/；技能搜索 .claude/skills/、skills/、.agent/skills/；命令搜索 .claude/commands/、commands/；钩子搜索 .claude/settings*.json（hooks 部分）；工作流搜索 skills/workflows/、.agent/workflows/、**/*.workflow.yaml。每个工具记录文件路径、名称（来自文件名或 frontmatter）以及前 20 行。

  3. 粗筛（Step 2，仅同类型内）：对每一工具类型分别比较，依据名称相似度（如 git-commit 与 commit-standards）、前 20 行关键词提取、目的推断。满足以下条件即标记为“可能重叠”：名称相似度大于 60%（Levenshtein 或语义）、共享关键词大于 3 个、推断目的相似。

  4. 深度分析（Step 3）：对被标记的配对读取完整内容，判断重叠类别（重复、子集、互补、命名冲突），并按四维度加权比较：目的 40%、触发情境 20%、输出/动作 25%、依赖 15%。重叠分数计算公式为：Overlap Score = (Purpose × 0.4) + (Trigger × 0.2) + (Output × 0.25) + (Deps × 0.15)。分数解读：90-100% 为重复（建议合并或删除）、70-89% 为高度重叠（建议整合）、50-69% 为中度重叠（建议明确边界）、30-49% 为低度重叠（建议记录关系）、0-29% 为不重叠（无需处理）。

  5. 交叉引用分析（Step 3.5，优化前）：在建议合并或删除前，检查工具是否被其他文件引用。用 grep 搜索工具名（示例命令：grep -r "tool-name" --include=".md" --include=".yaml" --include="*.json"），关注直接链接、命令引用（/tool-name）、技能引用（skill: tool-name）、导入/参见（see: tool-name）等模式。引用类别包括：文档（README、指南）、工具引用（其他技能/命令）、配置（mapping.yaml、overlaps.yaml）、归档/历史（旧提案与报告，无需处理）。报告中为每条优化建议附上发现的交叉引用及所需更新的文件数量。

  6. 报告生成（Step 4）：在 docs/report/tool-overlap-analysis-{YYYY-MM-DD}.md 生成报告。报告结构包含：执行摘要（分析工具总数、发现的重叠问题数、优化机会数）、按工具类型分析（Agents、Skills、Commands、Hooks、Workflows 各自的发现）、详细发现（高优先级分数 ≥70%、中优先级 50-69%、低优先级 30-49%）、优化建议（合并候选、废弃候选、需要明确边界的工具、需要改进文档的工具），以及附录：工具清单。报告写作要求使用自然可读的散文体、清晰标题、结合语境解释发现、给出可执行建议并说明理由，用表格做比较、用散文做分析，保持专业且易读的语气。

使用方式

运行该分析时：确保处于项目根目录；调用“Analyze tool overlap”或“Run tooling audit”；然后在 docs/report/ 查看生成的报告。

适用场景

资料列出的使用场景包括：(1) 审计项目工具生态；(2) 识别重叠与优化机会。典型价值在于发现可合并或废弃的工具、梳理工具边界与文档关系。

限制

资料未提供关于收费、价格、支持平台范围或性能指标的信息；这些方面暂未提供。该技能的重叠判定依赖前述流程与加权评分规则，具体阈值与维度权重以资料描述为准。