P1tak4s/production-readiness-audit
GitHub: P1tak4s/production-readiness-audit
一个 Claude Code Agent Skill,通过零依赖静态扫描器和六维度深度检查清单,帮助团队在代码库上线前全面评估并加固生产就绪状态。
Stars: 0 | Forks: 0
# production-readiness-audit
一个 [Claude](https://claude.com/claude-code) **Agent Skill**,能将 Claude 变为生产就绪审查员。它可以针对代码库进行风险**扫描**,根据全面的标准对变更进行**审查**,并**创建**缺失的控制措施和工件——涵盖六个维度:
- 🔐 **安全** — 输入清理与注入、身份验证/授权与角色、会话与 token 过期、密钥管理、HTTPS/TLS 与证书轮换、速率限制与滥用预防、依赖项与供应链扫描、多租户与数据隔离、审计与防篡改日志,以及 CSRF/SSRF/安全标头/静态加密/最小权限。
- 🛡️ **可靠性** — 错误处理与优雅降级、带退避与幂等性的重试、断路器与降级方案、超时、并发与竞态条件预防、缓存与失效、背压、健康检查、优雅关闭。
- ✅ **测试与流程** — 单元/集成/E2E 测试、回归测试、负载/压力测试、混沌与弹性测试、CI 中的覆盖率阈值、代码审查标准与 CI 门禁、契约测试与变异测试。
- 📄 **数据与合规** — PII 处理、保留与删除、GDPR、HIPAA、PCI、同意授权、DSAR、加密与密钥管理、数据驻留。
- 🚀 **运维** — RTO/RPO、灾难恢复与备份、可观测性(日志/指标/链路追踪)、SLO 与告警、部署安全/回滚(金丝雀/蓝绿部署/功能开关)、值班与事件响应、成本护栏。
- 🏛️ **架构与可访问性** — 架构图 (C4)、ADR、WCAG 2.2 AA 可访问性、文档、i18n、依赖项许可证。
## 包含内容
```
production-readiness-audit/
├── SKILL.md # the skill: modes, workflows, reference map
├── scripts/
│ └── scan.py # stdlib-only static scanner (no dependencies)
├── references/ # deep checklists, loaded on demand
│ ├── security.md
│ ├── reliability.md
│ ├── testing.md
│ ├── data-and-compliance.md
│ ├── operations.md
│ └── architecture-and-accessibility.md
└── assets/ # fill-in templates the skill produces
├── audit-report-template.md
├── production-readiness-checklist.md
├── threat-model-template.md # STRIDE
├── disaster-recovery-plan-template.md # RTO/RPO, backups, failover
├── incident-runbook-template.md
└── adr-template.md
```
## 安装
克隆到你的 Claude Code skills 目录中:
```
git clone https://github.com/P1tak4s/production-readiness-audit.git \
~/.claude/skills/production-readiness-audit
```
Claude Code 会自动发现 `~/.claude/skills/` 中的 skills。安装完成后,要求 Claude 对项目进行“security-check”(安全检查)、“audit”(审计)或“assess production-readiness of”(评估生产就绪状态),该 skill 就会被激活。你也可以使用 `/production-readiness-audit` 显式调用它。
## 扫描器
`scripts/scan.py` 是一个快速、确定性的初步检查。它是**纯标准库**的,**不进行网络调用**,并且只写入你选择的报告文件,不创建任何其他内容。
```
# 项目的 Markdown + JSON 报告
python3 scripts/scan.py /path/to/project --md report.md --json report.json
# CI gate:如果存在任何 HIGH-severity 发现则以非零状态退出
python3 scripts/scan.py /path/to/project --strict --quiet
# 跳过外部工具(离线 / 快速)
python3 scripts/scan.py /path/to/project --no-tools
```
它会检测技术栈,使用 `file:line` 标记密钥/风险模式,检查预期的规范文件(lockfile、CI、测试、`.gitignore`、许可证……),并且——**仅当它们已经安装时**——以只读模式运行 `npm audit`、`pip-audit`、`govulncheck`、`cargo audit`、`gitleaks` 和 `bundler-audit`。
**扫描器只报告线索,而不是最终结论。** 正则启发式方法会产生误报并遗漏部分内容。真正的深度检查包含在参考清单中;请通过阅读引用的代码来确认每一项发现。
## 范围与道德规范
此 skill 是**防御性**的:用于保护并加固你拥有或被授权评估的系统。它不用于攻击第三方系统。合规性部分属于工程指导,而非法律建议——请与法律顾问/你的 DPO 确认监管义务。
## 许可证
[MIT](LICENSE)。
使用 [Claude Code](https://claude.com/claude-code) 及其 `skill-creator` skill 构建。
标签:DevSecOps, DNS 反向解析, Mr. Robot, 上游代理, 代码安全审计, 代码审查, 数据管道, 无线安全, 研发效能, 软件工程, 逆向工具, 防御加固