Method Library Keeper
目标
把项目中的重复逻辑提炼为稳定的方法库,提升可复用性、可测试性和可维护性。
输入信息采集
- 现有重复代码片段及出现位置。
- 方法适用边界(输入类型、异常行为、性能要求)。
- 是否需要向后兼容旧签名。
- 是否已有单元测试基线。
执行流程
- 识别重复逻辑并归类:格式化、校验、转换、业务计算。
- 定义方法签名和命名,优先表达业务语义而非实现细节。
- 依据
references/method-spec-template.md 产出方法规格文档。 - 给出调用替换建议和最小迁移步骤。
- 设计测试建议:正常路径、边界输入、异常输入。
输出要求
每次输出必须包含:
- 方法清单(方法名、参数、返回值、副作用)。
- 适用范围和不适用范围。
- 迁移建议(如何从旧逻辑迁移到新方法)。
- 示例调用(最少 2 个)。
质量红线
- 不允许输出“万能工具函数”导致职责模糊。
- 不允许吞掉异常而不说明策略。
- 不允许缺少边界约束说明。