quality-audit-workflow

质量审计工作流

用途

通过生成 PR 和按 PM 优先级排序的建议，协调对任意代码库进行系统化并行质量审计，并自动修复问题。

何时激活

当你提到以下内容时，我会自动加载：

• “质量审计”或“代码审计”
• “代码库审查”或“全面代码审查”
• “重构机会”或“技术债务审计”
• “模块质量检查”或“架构审查”
• 涉及多个 Agent 的“并行分析”

我会做什么

执行包含 7 个阶段的工作流：

1. 熟悉项目（调查阶段）
2. 审计代码库各个分区，并行调度 Agent
3. 为发现的每个问题创建 GitHub issue 3.5. 根据近期 PR 进行验证（防止误报）
4. 针对其余问题，在并行工作树中生成 PR
5. 由 PM 架构师审查 PR 并确定优先级
6. 在主 issue 中汇总建议

快速开始

User: "Run a quality audit on this codebase"
Skill: *activates automatically*
       "Beginning quality audit workflow..."

7 个阶段

阶段 1：熟悉项目

• 根据项目结构运行调查工作流
• 梳理模块、依赖项和入口点
• 了解现有模式和架构

阶段 2：并行质量审计

• 将代码库划分为逻辑区块
• 为每个区块调度多种类型的 Agent（分析器、审查员、安全审查员、优化器）
• 严格执行 PHILOSOPHY.md 标准
• 检查模块大小、复杂度和单一职责

阶段 3：整理 issue

• 为每项发现创建 GitHub issue
• 包含严重性、位置和建议
• 添加适当的标签
• 添加唯一 ID、关键词和文件元数据

阶段 3.5：审计后验证 [NEW]

• 扫描过去 30 天内合并的 PR（可配置）
• 计算 PR 与 issue 匹配的置信度评分
• 自动关闭高置信度匹配项（≥90%）
• 标记中等置信度匹配项（70-89%）以供验证
• 在 issue 和 PR 之间添加双向交叉引用
• 目标：误报率低于 5%

阶段 4：并行生成 PR

• 为每个仍未关闭的 issue 创建一个工作树（worktrees/fix-issue-XXX）
• 在每个工作树中运行 DEFAULT_WORKFLOW.md
• 针对每个已确认且仍未关闭的 issue 生成修复 PR

阶段 5：PM 审查

• 调用 pm-architect 技能
• 按类别和优先级对 PR 分组
• 确定修复之间的依赖关系

阶段 6：主报告

• 创建主 GitHub issue
• 链接所有相关 issue 和 PR
• 提供包含建议的优先级行动计划

执行理念

此工作流严格贯彻以下原则：

• 极致简洁：标记过度设计的模块
• 模块大小限制：每个模块目标为少于 300 行代码
• 单一职责：每个构件只承担一项职责
• 零废话：不留存根、不留 TODO、不留死代码

导航指南

何时阅读辅助文件

reference.md——在需要以下内容时阅读：

• 各阶段的详细执行步骤
• Agent 与阶段的对应关系
• 代码库划分策略
• issue 模板格式

examples.md——在需要以下内容时阅读：

• 可用的审计示例
• issue/PR 格式示例
• 真实使用模式
• 输出格式示例

配置

通过环境变量或提示词覆盖默认值：

核心设置：

• AUDIT_PARALLEL_LIMIT：并发工作树上限（默认值：8）
• AUDIT_SEVERITY_THRESHOLD：创建 issue 的最低严重性（默认值：medium）
• AUDIT_MODULE_LOC_LIMIT：标记超过此行数的模块（默认值：300）

阶段 3.5 验证设置 [NEW]：

• AUDIT_PR_SCAN_DAYS：扫描近期 PR 的天数（默认值：30）
• AUDIT_AUTO_CLOSE_THRESHOLD：自动关闭的置信度百分比（默认值：90）
• AUDIT_TAG_THRESHOLD：添加标签的置信度百分比（默认值：70）
• AUDIT_ENABLE_VALIDATION：启用阶段 3.5（默认值：true）