用途:按 FPF 方法论对代码库做系统化、多维度的架构审查,取代重型工具,采用聚焦分析。
三个视角:功能视角关注系统做什么,包括功能完整性、能力覆盖、行为正确性与集成点;实践视角关注系统运行如何,包括性能、可用性、运维与可扩展性;基础视角关注系统构建基础,包括架构模式、设计原则、代码质量与技术债。
使用方式:执行 /fpf-review 进行完整审查;可用 /fpf-review --perspective functional、--perspective practical、--perspective foundation 指定单一视角;用 /fpf-review --scope plugins/sanctum 限定范围。审查后运行 make lint && make test 验证无回归。
工作流分五阶段:发现(扫描结构、映射依赖、识别入口)、功能分析、实践分析、基础分析、综合(交叉比对、排优先级、生成报告),对应五个 TodoWrite 条目。输出为 Markdown 报告,含执行摘要、三视角分析、建议与行动项。
配置:.fpf-review.yaml 可设置 scope 的 include/exclude、各视角的 enabled 与 depth(full/summary)、输出的 format、create_issues 与 severity_threshold。
限制:资料标注为骨架实现,尚需详细分析算法、模式识别逻辑与报告生成模板;Guardrails 要求遵守范围边界、基于证据、输出可执行且视角均衡。