SuperAPI AI 工具集

plan-flow

设计与创作

查看项目

更新于 10-16 00:04

技能介绍

用途:当需要对代码库做深度架构审查或收敛规划时使用。它先分析仓库级的重复与冗余设计,再构建并执行可追踪的详细计划。该技能与具体仓库无关,定义的是分析与规划方法。

主要能力:

  1. 结构化冗余分析:建立架构锚点清单(领域模型与 schema、工厂/注册入口、HTTP/存储/缓存/日志抽象、路由/服务/提供者适配器),识别重复候选,如同一概念多个冲突定义、同一职责并行实现、已导出但未连接的模块、仍影响可读性的死代码/遗留路径。每项发现需记录确切文件与符号、调用路径或使用证据、变更风险。
  2. 计划生成:按影响/工作量/风险/置信度评分,分 P0/P1/P2 阶段排序,优先低风险高信号步骤,用模板创建或更新 plan/<task>.md,状态为 pending / in_progress / completed / blocked,且同一时间只允许一个 in_progress。
  3. 严格执行循环:只实现当前步骤且只改列出的文件,立即运行步骤级测试与项目健康检查,更新计划状态和执行日志后再进入下一步;失败时记录根因并修复。
  4. 收尾验证:运行阶段矩阵检查与最终回归集,报告残余风险、延后工作和覆盖缺口。

使用方式:技能包含参考文档 references/analysis-playbook.md、references/risk-impact-scoring.md、references/plan-template.md、references/plan-accomplishments.md,以及脚本 scripts/redundancy_scan.sh <target_dir>、scripts/findings_to_plan.py --target-dir src --output plan/<name>.md、scripts/plan_lint.py <plan/file.md>。触发场景包括“分析这个库有哪些重复设计/冗余设计”“做一个非常完整详细的 todolist/执行计划”“每改一处就测试并更新计划状态”“按步骤推进并可追踪”。

质量门禁:无文件级证据的发现不得进入计划;无测试命令证据不得标记步骤完成;未写计划状态/日志不得开始下一步;无法做完整回归时需记录确切原因与最接近的替代检查。

限制:资料未提供具体支持的编程语言、平台、安装方式、收费模式或性能数据;执行规则要求优先小步可逆改动,计划语言需具体到文件路径、符号和命令,避免把分析结论与未验证假设混在一起,若新证据与先前假设矛盾需先修订计划再编码。