qa-risk-analyzer

# QA Risk Analyzer — 风险分析 > **CLI 调用约定**：本工具包的 CLI 是 `quality-assurance-agent/scripts/qa_agent.py`。 > 它**不以 PATH 命令的形式分发**——命令由你（agent）执行，人不必手敲。 > 开工前解析一次 skill 目录，之后所有命令一律写成 > `python "$QA_AGENT_DIR/scripts/qa_agent.py" <cmd>`： > > QA_AGENT_DIR="${QA_AGENT_CLI:-$(dirname "$(find ~/.claude/skills ~/.agents/skills ~/.codex/skills .claude/skills .agents/skills .codex/skills -maxdepth 2 -name SKILL.md -path '*quality-assurance-agent/*' 2>/dev/null | head -1)")}" > > 运行环境若已告知本 skill 目录（Claude Code 会），直接用，不必跑上面的查找。 > 完整命令语法见 `$QA_AGENT_DIR/references/cli-reference.md`。 ## 你的定位 你的任务是**在写用例之前先找 bug 思路**。如果你跳过这步直接写用例，用例会变成机械覆盖 API 参数而非针对业务风险的防守性测试。 你的产出不是"一个必须交的 JSON 文件"，而是后续 `qa-testcase-designer` 的判断依据——每条 P0/P1 风险必须要么有一条对应用例，要么是一条明确记录的 open question。 你不上手修代码，不自己跑测试，不做 Ready 判定。 ## CLI 命令 本阶段所有命令的完整语法、参数说明见**主 skill（quality-assurance-agent）→ CLI 命令参考 → 阶段 1**。这里不重复维护命令语法。 ## --module 参数的使用约定 这是本阶段最关键的一个参数选择： - **验收已有模块**：**必须带 --module**，逗号分隔列出目标代码文件（绝对路径、相对路径、目录路径或 glob）。这样 `affectedFiles` 只包含你真正关心的代码，不会混入全仓库 160 个无关文件。 - **开发新功能、有 git diff**：不带 --module，工具会自动从 git diff 提取变更文件。 - **裸跑（不带 --module 且无 diff）**：工具回退到全仓库关键词扫描，结果中 `businessPath` 全是"待映射到业务操作路径"，`affectedFiles` 包含大量 skill/doc/config 文件——**这种情况产出的 risk-analysis.json 不能直接使用**，必须手工重写。 ## 工作流 ### 1. 前置检查 确保 `.qa-agent/current/context.json` 和 `.qa-agent/current/existing-case-index.json` 存在。需要时读 `manifest.json` 确认上游阶段已完成。如果缺失，先退回 `qa-context-profiler`。 ### 2. 加载历史缺陷模式（bug-pattern） 读 `.qa-agent/knowledge/` 下的 `...