用途
Product Audit 用于对整个产品做一次广泛的健康检查,而不是审查单个变更(review-change)或单个 PR(audit-pr)。它覆盖代码、质量、流程、文档、路线图和工具链等维度,并负责仓库级的缺陷排查、安全研究和损坏版本调查。适合周期性使用(每几个功能一次)或产品就绪里程碑时使用,以获得关于质量、安全、债务、文档和路线图的诚实全貌。
主要能力
- 覆盖整个代码库及其过程产物:源代码、测试、文档树、路线图、修复索引、开放 issue,以及每个功能文件夹的规划文档。
- 接受可选的路径/区域参数,用于聚焦部分审计;会说明范围,并在抽样而非穷尽某维度时明确说明抽样内容,不会暗示未完成的完整覆盖。
- 输出固定格式的 PRODUCT AUDIT 报告,包含:按维度的健康状态(✓ healthy / ⚠ concerns / ✗ at risk / n-a)、按严重度排序的 F 编号发现项、四条提案流(待开 issue、路线图新增、路线图移除/修订、工具注册/重设计)、与上一次审计的 Delta 对比、人工验证清单。
- 发现项编号为 F1、F2……每次审计一个序列,按严重度排序;持久化后编号冻结,后续审计使用新的审计 id,不会重编号旧文件。
- 报告同时写入 docs/audits/<n>-<YYYY-MM-DD>.md(增量审计 id)并提交,文件是持久交付物,聊天打印是副本。
使用方式
- 第 0 步:发现项目。按照 agent 指南的工作流约定和文档地图,读取路线图、修复索引、功能文件夹布局和验证门禁,判断产品性质(web / mobile / console / library / backend / infra)。
- 渐进加载:按顺序加载两个参考资源——审计维度(标记每个维度适用或 n-a 并说明原因,说明抽样情况)和审计流程(执行全部十个步骤,然后返回固定报告)。缺失资源会停止审计,绝不凭记忆重建。
- 执行审计并输出固定格式报告。
- 报告持久化并提交为 docs/audits/<id>-<YYYY-MM-DD>.md,同时在聊天中打印。
- 结尾打印 → Next: 块,通常建议批量 /triage-issue <id> F<k> … 对提议的 issue 进行分类,然后对接受的工作使用 /unit-lane。
适用场景
- 周期性(每几个功能)或产品就绪里程碑时。
- 需要广泛、诚实的全貌——质量、安全、债务、文档和路线图——而非单个变更或 PR 的审查时。
- 仓库级、开放式的缺陷排查、安全研究和损坏版本调查。
限制
- 绝不自动修复、绝不打开 issue、绝不编辑路线图。输出是报告加提案,每个动作由用户决定。
- 该技能唯一写入的文件是自己的报告(docs/audits/ 下,外加 mkdir -p docs/audits),不触碰仓库中其他任何内容。
- 绝不注册工具或编辑 AGENTS.md;工具扫描会提议注册某个 skill/MCP,但由用户(或路由的 /unit-lane <slug> 运行)执行编辑。
- 平台自适应:只运行适用的轴,始终列出跳过什么及原因。
- 无静默上限:如果对某维度进行了抽样、优先级排序或时间限制,会说明,绝不把部分覆盖呈现为穷尽。
- 发现项和提案按严重度排序并去重,每个发现/提案引用 file:line/metric/doc/issue 来源,不确定处标记 verify。
- 可移植性:工作流是契约,Claude Code 功能是便利。在缺少某功能的 agent 上应用回退方案,绝不跳过该功能所启用的步骤。
- 关于 ultracode(研究预览版 Claude Code 会话设置,任何技能都无法声明):用户可开启它使扫描跨并行子代理展开;未开启时按顺序扫描各维度,仅影响墙钟时间,不影响覆盖。
与其他技能的关系
product-audit 比 review-change(单个变更)和 audit-pr(单个 PR)更广,并将 audit-docs 的一致性检查作为其维度之一。它不会自动交接任何内容——只做推荐,规划/修复/分类技能仅在用户选择时执行。