code-deduplication

code-deduplication 技能概览

code-deduplication 技能帮助 Claude 避免在现有函数、模块或模式已经能解决同一问题时，继续创建新代码。它非常适合那些不断加入“很小的辅助函数”、共享工具和重构补丁、最后却慢慢演变成重复行为的团队。如果你的目标是用于 Refactoring 的 code-deduplication，这个技能会推动模型先检查已有实现，再去扩展或复用，而不是重新造轮子。

这个技能实际会做什么

这个技能的核心是一个能力索引，通常是 CODE_INDEX.md，让模型在动手写代码之前，先推理代码库已经具备哪些能力。这样一来，它在需要更少重叠辅助函数、更清晰的共享抽象、以及减少那些用不同方式解决同一问题的文件之间漂移时，尤其有用。

最适合的使用场景

当你要新增工具函数、整合业务逻辑，或清理仓库中重复的实现细节时，使用 code-deduplication 技能最合适。它尤其适用于那种会触及多个文件的重构，而且你希望模型优先选择扩展现有能力，而不是复制一份新实现的场景。

它的不同之处

和泛泛的“重构这段代码”提示不同，这个技能加入了“先检查、再写入”的纪律，以及改动后的维护闭环。它不只是为了少写代码；更重要的是保留已有能力、把这些能力清晰地映射出来，并让新增代码证明自己确实有必要。

如何使用 code-deduplication 技能

在工作流中安装并启用它

先通过你的技能管理器走 code-deduplication install 这条路径，然后在让模型编写新的共享代码或执行重构之前应用它。仓库的 frontmatter 已经把它标记为不可由用户直接调用，所以要把它当作一个后台工作流技能：它服务于 Claude 的规划和写作过程，而不是你直接运行的独立命令。

先给模型正确的项目上下文

在发起提示前，把当前功能目标、相关文件，以及如果有的话现有的索引一起给模型。这个技能最有效的前提，是它能把预期行为和现有实现做对照。如果你只给出“把它整理得更清爽”这种模糊请求，模型就缺少足够信息，难以可靠地识别重叠部分。

效果更好的提示写法

一个好的 code-deduplication usage 提示，会明确写出你要的能力、涉及的文件，以及重复的风险。例如：“重构 payment summary 流程。先检查 CODE_INDEX.md 是否已经覆盖格式化、四舍五入和税费计算。能复用现有 helper 就直接复用；只有在能力确实不存在时才新增函数。” 这样给模型的是一条决策规则，而不只是一个任务。

先读这些文件

先从 SKILL.md 开始，再查看项目级的 CODE_INDEX.md 或同类架构说明。如果仓库里已经有工具映射、依赖指南或重构规范，也要在改代码之前先读一遍。这个技能的价值，取决于能否尽早发现复用机会，而不是等实现已经推进到一半才回头找。

code-deduplication 技能 FAQ

这只适合大型代码库吗？

不是。小型仓库同样受益，尤其是早期重复一旦形成，后面会更难收拾。这个技能最有价值的场景，是那种一个“顺手加的 helper”很容易继续长出三个功能几乎一样的 helper 的地方。

它和普通的重构提示有什么不同？

普通提示可能会改善风格，但不一定能防止重叠。code-deduplication 技能增加了结构性检查：识别现有能力、比较意图、优先复用或扩展，并在写完后更新索引。相比泛泛的重写请求，它更适合用于 Refactoring 里的 code-deduplication。

初学者也需要这个技能吗？

需要，尤其是在他们经常因为找不到已有代码而重新写一份的时候。这个技能通过强制加入“搜索并决定”的步骤，可以减少无意中的重复创建。若仓库没有清晰结构，或者没有维护能力索引的意愿，它的作用就会小很多。

什么时候不该用它？

当你需要一次性实验、临时 spike，或者一个现实中几乎不可能与现有实现重叠的新能力时，就不要依赖它。在这些情况下，“先检查、再写入”的流程可能会拖慢进度，却不会带来更好的结果。

如何改进 code-deduplication 技能

给模型设定能力层面的目标

你能做的最佳改进，是描述要完成的工作，而不是你想要的文件形状。与其说“加一个 helper”，不如说“统一 reports 里的日期解析”。这样 code-deduplication 技能才能比较目的，而这正是它判断是否能够复用的依据。

尽早暴露已有重叠

把那些看起来过于相似的函数、相邻模块，或重复出现的分支示例提供出来。如果你已经知道两个实现很接近，就把两者都点出来，并要求模型只保留一个明确的归属。这能降低第一次输出就误造出一个新重复实现的概率。

明确要求做复用决策

一个高质量的 code-deduplication guide 请求，应该同时问三件事：哪些现有代码可以复用、哪些地方应该扩展、哪些地方确实需要新代码。这样输出才会以决策为中心，而不是单纯生成一段新实现。

第一轮之后，结合索引继续迭代

模型写完代码后，要求它更新或起草能力索引，这样下一次改动时就能有更好的地图。这个技能最主要的失败模式，并不是实现质量差，而是重构之后复用信号丢失。把索引保持最新，才是让 code-deduplication 真正可持续的关键。