SuperAPI AI 工具集

improve-codebase-architecture-project

智能体与模型

查看项目

更新于 10-16 00:21

技能介绍

用途:在 CI 环境中无人值守地审查代码库架构,每次运行只挑选一个未被提出过的高杠杆“深化”重构机会,写成 PRD 形态的 GitHub issue 内容。用于提升可测试性与 AI 可导航性。

主要能力:先读取带 source:architecture-review 标签的历史 issue,记录已提出的模块与痛点;再阅读 GLOSSARY.md 与 docs/adr/,用 Explore 子代理遍历仓库,识别理解成本高、接口与实现同样复杂、缺少局部性、耦合外泄、难以测试等问题,并对疑似浅模块做“删除测试”。随后按松散去重规则过滤(触及相同模块或解决同一摩擦即视为重复),内部生成 3-5 个候选并按杠杆、局部性收益、测试面改善、成本收益排序,选出唯一一个。

使用方式:按 /to-prd-project 模板产出 Problem Statement、Solution、User Stories、Implementation Decisions、Testing Decisions、Out of Scope、Further Notes,并在顶部加 Architecture review 段(Files、Problem、Solution、Benefits、Before/After 的 mermaid 图、Recommendation strength)。不执行 gh issue create,由工作流以 --label "source:architecture-review" 原子创建。最后输出单个 <output> 块:成功时含 status、title、body、oneLineSummary、candidatesConsidered;全部候选均已提出时输出 status 为 skipped 及 reason。

限制:全程只读,不做提交、不修改 GLOSSARY.md/ADR/源码、不创建或编辑 issue;每次仅一个提案;无用户交互、不提问。术语需严格使用资料给出的 Glossary 词汇。