Quality Audit Workflow 是一个用于对任意代码库执行系统性质量审计的技能，并可通过自动生成 PR 与 PM 优先级建议实现自动化修复。
用途
该技能用于编排系统化、并行的代码库质量审计，并通过 PR 生成和 PM 优先级建议实现自动修复。
激活时机
当用户提及以下内容时会自动加载：
- “quality audit”或“code audit”
- “codebase review”或“full code review”
- “refactoring opportunities”或“technical debt audit”
- “module quality check”或“architecture review”
- 与多个智能体相关的“parallel analysis”
主要能力
执行一个七阶段工作流：
- 熟悉项目（调查阶段）
- 使用并行智能体跨代码库分区进行审计
- 为每个发现的问题创建 GitHub Issue 3.5. 对照近期 PR 进行验证（防止误报）
- 在剩余 Issue 各自的并行 worktree 中生成 PR
- 由 PM 架构师审查 PR 以进行优先级排序
- 在 master issue 中报告合并后的建议
快速开始
用户：“Run a quality audit on this codebase” 技能：自动激活 “Beginning quality audit workflow...”
七个阶段
阶段 1：项目熟悉
- 对项目结构运行调查工作流
- 映射模块、依赖和入口点
- 理解现有模式与架构
阶段 2：并行质量审计
- 将代码库划分为逻辑区段
- 每个区段部署多种智能体类型（analyzer、reviewer、security、optimizer）
- 严格执行 PHILOSOPHY.md 标准
- 检查模块大小、复杂度、单一职责
阶段 3：Issue 汇总
- 为每个发现创建 GitHub Issue
- 包含严重性、位置、建议
- 打上合适的标签
- 添加唯一 ID、关键词和文件元数据
阶段 3.5：审计后验证 [新增]
- 扫描最近 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：主报告
- 创建 master GitHub Issue
- 链接所有相关 Issue 和 PR
- 提供带建议的优先级行动计划
哲学执行
该工作流严格执行以下标准：
- 极致简化：标记过度设计的模块
- 模块大小限制：目标每个模块 <300 LOC
- 单一职责：每块砖只有一个用途
- 零 BS：无桩代码、无 TODO、无死代码
导航指南
何时阅读支持文件
reference.md - 在需要以下内容时阅读：
- 详细的阶段执行步骤
- 智能体与阶段的映射
- 代码库划分策略
- Issue 模板格式
examples.md - 在需要以下内容时阅读：
- 可运行的审计示例
- 示例 Issue/PR 格式
- 真实使用模式
- 输出格式示例
配置
可通过环境变量或提示覆盖默认值：
核心设置：
- AUDIT_PARALLEL_LIMIT：最大并发工作树数（默认：8）
- AUDIT_SEVERITY_THRESHOLD：创建 Issue 的最低严重性（默认：medium）
- AUDIT_MODULE_LOC_LIMIT：标记超过此 LOC 的模块（默认：300）
阶段 3.5 验证设置 [新增]：
- AUDIT_PR_SCAN_DAYS：扫描近期 PR 的天数（默认：30）
- AUDIT_AUTO_CLOSE_THRESHOLD：自动关闭的置信度百分比（默认：90）
- AUDIT_TAG_THRESHOLD：标记的置信度百分比（默认：70）
- AUDIT_ENABLE_VALIDATION：启用阶段 3.5（默认：true）