安全审计

<!-- @include templates/prompts/iron-law-tool.md（已内联于下方，无需另读） -->

⛔ IRON LAW · 不可违反的硬门禁（工具型命令）

本命令不是主链路上的阶段：不追加 history，不改 current_stage / next_step / last_phase_result，也不为此分配功能ID。以下规则不可协商：

1. 文件必须落盘：正文要求创建的文件必须作为实际文件写入磁盘，不可仅在对话中输出（只要求在对话里输出的，照正文办）。
2. 自检必须执行：产出后按本命令的自检项逐项核对，不得以"已经很好了"为由跳过。
3. 防循环：修复只做一次，不递归。修不了的问题记进报告，继续往下走。

违反任一条 = 立即中止当前命令，输出违规详情，等待人工介入。

<!-- @include-end templates/prompts/iron-law-tool.md -->

对指定服务或应用进行安全审计，检查常见安全漏洞。

审计范围

1. OWASP Top 10 检查

   • SQL 注入
   • XSS（跨站脚本）
   • CSRF（跨站请求伪造）
   • 不安全的直接对象引用
   • 安全配置错误
   • 敏感数据泄露
   • 缺失的访问控制
   • 不安全的反序列化
   • 使用含已知漏洞的组件
   • 日志记录和监控不足

2. 认证与授权

   • 密码存储方式（是否加盐哈希）
   • Token 生成与验证
   • 接口权限控制
   • 会话管理

3. 数据安全

   • 敏感信息是否加密存储
   • 环境变量中是否有硬编码密钥
   • 日志中是否打印敏感数据
   • API 响应中是否泄露内部信息

4. 依赖安全：交给下面「工作流程」第 2 步的扫描工具判定，不凭记忆断言某个版本有没有漏洞

工作流程

1. 确定范围：本次审计的服务 / 模块 / 功能，及其技术栈（看清单文件：package.json、requirements*.txt / pyproject.toml、Cargo.toml、go.mod、Gemfile、pom.xml / build.gradle）

2. 先跑真实扫描工具（客观结果，先于人工判断）。按技术栈挑本机已安装的工具，每条记录命令原文、退出码、发现数：

   类别	技术栈	命令
   依赖漏洞	Node	npm audit --json / pnpm audit --json / yarn npm audit --json
   依赖漏洞	Python	pip-audit
   依赖漏洞	Rust	cargo audit
   依赖漏洞	Go	govulncheck ./...
   依赖漏洞	Ruby	bundle audit check
   依赖漏洞	Java	项目已配的 OWASP dependency-check 插件任务
   密钥泄露	任意	gitleaks detect --no-banner（看工作树用 --no-git）
   静态分析	任意	项目已配置的 semgrep / bandit / gosec 等（有配置才跑）

   • 工具没装 → 该行写 「未扫描（工具缺失）」，并给出安装命令供用户自行决定；不要替用户安装，更不能写成「无漏洞」
   • 退出码非 0 不等于失败：多数扫描器「发现问题」就返回非 0，以输出里的发现数为准

3. 人工审阅：按上方审计范围 1–3 读代码，补工具查不到的部分（鉴权逻辑、越权、敏感数据流向）

4. 写报告：工具结果与人工发现分两节，结论里写明哪些维度有工具证据、哪些只有人工判断

输出格式

⚠️ 必须创建文件，不可仅在对话中输出。

【必须创建文件】 在 docs/04_testing/security/ 下创建安全审计报告：

• 文件名: <功能ID>-audit.md（不针对具体功能时用 YYYYMMDD-<服务名>-audit.md）
• 文档顶部包含 PDLC 追溯头：

  <!-- PDLC-TRACE -->
  <!-- 功能名称: <服务名> -->
  <!-- 阶段: 安全审计 -->
  <!-- 创建时间: <ISO 8601> -->
  

• 第一节「工具扫描结果」：每个工具一行——命令原文、退出码、发现数（或「未扫描（工具缺失）」）
• 第二节「代码审阅发现」：按严重程度分级：紧急 / 高危 / 中危 / 低危 / 信息
• 每个问题包含：位置、描述、风险、修复建议、参考链接
• 创建后验证：确认文件已存在于 docs/04_testing/security/ 目录
• 在对话中输出报告摘要，但完整报告必须在文件中

要求

<!-- @include templates/prompts/output-language.md（已内联于下方，无需另读） -->

🌐 Output language for generated artifacts

All generated artifacts (PRDs, design docs, code comments, review reports, test plans, deployment manuals, changelog entries, etc.) follow this policy:

1. Default — match the conversation language exactly:

   • 用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告
   • User talks to Claude in English → produce English artifacts
   • User talks in another language → produce artifacts in that language
   • Never silently default to a fixed language regardless of the user's input.

2. Explicit override always wins: when the user specifies a language for an artifact (e.g. "write the PRD in English", "用英文写 API 设计文档", "output the deploy doc in Japanese"), use that language for that artifact, regardless of conversation language.

3. Mixed-language requirements: if the user wants some artifacts in one language and others in a different language (common: Chinese PRD + English API docs for partners), honour each per-artifact instruction.

4. Uncertain: if you cannot reliably detect the conversation language, ask once before producing the first artifact.

This policy applies to content (prose, comments, headings). It does not override technical conventions like English variable names, English git commit subjects, or English error codes when the project's conventions require them.

<!-- @include-end templates/prompts/output-language.md -->

• 给出具体的代码位置和修复代码示例
• 关键漏洞标注修复优先级

审计目标: $ARGUMENTS

<!-- @include templates/prompts/handoff.md（已内联于下方，无需另读） -->

段四：交接（Handoff）

命令完成后必须输出以下格式的最终消息：

✅ <阶段名> 完成：<主要产出物路径>
📊 自检：<通过数>/<总数> 通过（若有未通过，附要点）
📦 状态快照：docs/.pdlc-state/<feature-id>.json
👉 下一步：/pdlc-<next_step>
   （如果有分叉）或 /pdlc-<alt>（条件：<选择依据>）

规则：

• 主流程命令（写状态机的命令；下一跳见正文里「本命令的状态机取值」）必须显式输出"下一步"，不可省略
• 工具型命令（Layer 3）可以没有 next_step，此时输出 👉 下一步：（本次流程结束，无后续）
• 分叉场景必须说明选择条件，例如"若需补充测试用例 → /pdlc-tdd；若测试已齐 → /pdlc-review"<!-- @include-end templates/prompts/handoff.md -->

本命令的 handoff 输出：

✅ 安全审计报告 完成
📦 产出：docs/04_testing/security/<feature-id>-audit.md
👉 下一步：（本次流程结束，无后续）