方法库沉淀管家

要解决什么问题

业务迭代久了，同样的格式化、校验、转换和计算逻辑会在多个文件里复制粘贴。改一处漏一处，单元测试也难覆盖，签名和异常处理还各写各的。这个技能面向的是：把重复实现收敛成有边界、可测试的方法库，而不是再堆一个「工具箱」类。

技能如何工作

执行前需要你把重复代码片段及位置、适用边界（输入类型、异常行为、性能）、是否兼容旧签名、现有测试基线说清楚。技能会按流程：

1. 归类重复逻辑：格式化、校验、转换、业务计算。
2. 定签名与命名：名称表达业务语义，而不是实现细节。
3. 产出方法规格：依据 references/method-spec-template.md 写清方法清单（名、参数、返回值、副作用）。
4. 迁移与测试：给出调用替换建议、最小迁移步骤，以及正常路径、边界与异常输入的测试建议；示例调用至少 2 个。

每次输出都会包含适用范围、不适用范围，以及从旧逻辑迁到新方法的步骤。

边界与红线

• 不会产出职责模糊的「万能工具函数」。
• 不会静默吞异常而不说明处理策略。
• 不会省略边界约束；若某段逻辑不适合入库，会在不适用范围里写明原因。