SuperAPI AI 工具集

pflow-refactor

编程与开发

查看项目

更新于 10-16 08:04

技能介绍

用途:对一个用户指定的代码、组件或子系统做基于证据的重构研究,产出 As Is(现状)分析与最小且有理由的 To Be(目标)方案。从对话推断目标与深度,只对无法从上下文解决的决策提问。

主要能力:检查适用的项目规则、架构文档、实现、测试、调用方和相关历史;必要时查阅当前框架或语言指南;忽略无关代码。读取 .agents/skills/pflow-refactor/references/clean-code.md 与 .agents/skills/pflow-refactor/references/solid.md,用其中的坏味道识别问题、用其修复方式论证 To Be,并引用具体原则而非泛泛谈整洁。

分析内容:职责、归属、依赖、变更与事件边界、不变量、公共 API、测试、重复、命名、变更频率以及具体规模或耦合指标;区分事实与推断。设计方案时选择能解决已观察问题的最小架构,优先组合与现有扩展点,保持行为、降低耦合、明确归属与原子变更边界并解释命名。对推测性抽象和过早优化予以拒绝;仅当现有证据要求时才引入 manager、repository、接口、基类、事件总线或通用机制。

报告结构:先给结论,再呈现 As Is、To Be、理由与权衡、安全的迁移顺序、风险和明确的非目标;尽量使用精确路径与符号;未解决的决策应标注而非编造需求。

限制:除非另行明确要求,不编辑文件、不实现、不提交,也不把研究转成任务计划;当增量迁移可保持行为时不建议重写;不为减少行数或表面重复而提取抽象;无测量不优化。