CodeHealth — 全栈代码健康检查与上线评估
CodeHealth — 全栈代码健康检查与上线评估
🦝 参加商汤小浣熊 OPC 能力挑战赛 · 赛道二 | 商汤小浣熊 × Datawhale
开发背景：当下 AI 开发工具已经全面普及，人人都能借助 AI 快速生成代码，但 AI 产出的代码缺少天然的边界约束与统一规范，很容易堆积成难以维护的技术屎山，还潜藏各类安全漏洞，这类代码完全不具备直接上线的条件。
一方面，AI 生成的代码必须经过完整的安全风控扫描、上线风险评估，确认无漏洞、合规无风险后，才能投产；
另一方面，若项目没有一套严格统一的代码质量规范，不同开发人员、不同 AI 生成逻辑会各自遵循一套编码标准，多人协作时项目架构、代码风格完全不可控，长期下来会大幅提升维护成本。
面向开发团队的全栈代码质量工具。上传项目 ZIP，自动多维度扫描，一份投入三份产出：体检报告 PPT + 上线评估 PPT + 逐行整改 Excel。一个人 + AI，完成团队级代码审查。
核心亮点
- 🔍全维度扫描— 八维覆盖，从命名规范到技术栈老化，一次性完整体检
- 🚦上线评估— 三道门禁（安全/质量/合规），安全项一票否决
- ⏱️精准工时— 公式
基准 × 规模 × 耦合 × 风险，精确到 0.1h，团队排期直接可用 - ⚙️标准可配置— 行业基线打底，企业可收紧阈值、增加门禁、添加禁止/强制规则
- 🌐全栈覆盖— 前端 Vue/React，后端 Java/Go/PHP，标准文件可插拔扩展
- 🦝十模块串联— 知识库→数据分析→文案→theme-factory→canvas-design→html-templates→pptx→xlsx→artifacts-builder→webapp-testing，全链路在小浣熊体系内闭环，零外部依赖
四种模式
| 模式 | 耗时 | 适用场景 |
|---|---|---|
| A. 快速扫描 | 5min | 紧急上线前安全卡点 |
| B. 标准体检 ★ | 15min | 日常技术 review、项目交接 |
| C. 严格审查 | 20min | 行业标准 + 企业规则，核心项目审查 |
| D. 上线评估 | 20min | 三道门禁，AI 代码质量把关 |
三份产出
| 产出 | 格式 | 生成方式 | 回答的问题 |
|---|---|---|---|
| ① 代码健康体检报告 | PPT | pptx | “项目现在什么状态？” |
| ② 上线安全评估报告 | PPT | pptx | “代码能不能上线？” |
| ③ 逐行代码整改方案 | Excel | xlsx | “怎么改？谁改？改多久？” |
Excel 内嵌公式（自动汇总工时/按优先级统计/按负责人统计），开发人员可直接筛选排序、标完成状态。
小浣熊能力全链路
扫描引擎：知识库 → 数据分析 → 文案 │ 视觉层：theme-factory → canvas-design → html-templates │ 产出层：pptx（①②PPT） + xlsx（③Excel） + artifacts-builder（交互看板·可选） │ 验证层：webapp-testing（运行时验证·可选）十个内置能力，零外部 API Token。
支持语言
| 类别 | 语言/框架 | 标准文件 |
|---|---|---|
| 前端 | Vue 2/3、React、TypeScript、JavaScript | references/vue-style-guide.md |
| 后端 | Java (Spring Boot) | references/java-style-guide.md |
| 后端 | Go | references/go-style-guide.md |
| 后端 | PHP (Laravel) | references/php-style-guide.md |
标准文件可插拔，新增语言只需添加对应规则文件。
效率提升
| 人工 Code Review | CodeHealth | 提效 |
|---|---|---|
| 14-21 小时 | ~15 分钟 | ~60x |
安装与使用
1. 安装 Skill
在办公小浣熊中安装本目录为 skill。
依赖：全部使用小浣熊内置能力（pptx / xlsx / html-templates / canvas-design / theme-factory / webapp-testing / artifacts-builder），无需额外配置。
2. 触发使用
上传项目 ZIP，然后说：
- “帮我做一次标准体检” → 模式 B，八维全量扫描
- “帮我看看能不能上线” → 模式 D，三道门禁评估
- “帮我检查代码质量” → AI 会让你选模式
3. 报告生成
扫描完成后，自动串联内置 skill 生成三份报告——PPT 用于上会，Excel 用于开发。
项目结构
codeHealth/ ├── SKILL.md # Skill 定义（AI 行为指令） ├── README.md # 本文件 ├── agents/openai.yaml # AI Agent 配置 ├── scripts/main.py # PPT API 调用脚本（备用） ├── references/ # 规则与标准库 │ ├── vue-style-guide.md # Vue 前端代码标准 │ ├── java-style-guide.md # Java 后端代码标准 │ ├── go-style-guide.md # Go 后端代码标准 │ ├── php-style-guide.md # PHP 后端代码标准 │ ├── check-dimensions.md # 八维检查维度定义 + 工时基准 │ ├── work-hours-estimate.md # 精准工时计算公式（45+ 条基准） │ ├── standards-config.md # 标准配置体系（三层四模式） │ ├── launch-checklist.md # 上线评估体系（三道门禁 + 企业叠加） │ ├── remediation-plan-template.md # 整改方案模板 │ ├── ppt-generation-prompt.md # PPT 生成 Prompt │ ├── API_REFERENCE.md # 小浣熊 PPT API 参考 │ └── CHEATSHEET.md # 小浣熊 PPT API 速查 ├── demo/ # 演示与示例 │ ├── 演示操作手册-从头到尾.md # 评委演示完整剧本 │ ├── 演示全流程脚本.md # 详细对话示例 │ ├── 示例报告-健康体检.md # 健康体检报告示例 │ ├── 示例报告-上线评估.md # 上线评估报告示例 │ ├── company-standard-example.json # 企业代码标准示例 │ ├── company-launch-standard-example.json # 企业上线标准示例 │ └── shiwo-mobile-demo.zip # 测试用 Vue 项目 ├── docs/ # 背景文档 │ ├── 产品介绍-CodeHealth.html # 产品介绍页面 │ ├── 产品介绍PPT-CodeHealth.html # 产品介绍 PPT（11页，可打印PDF） │ ├── 作品简介-提交.md # 作品简介源稿 │ ├── 作品说明文档-提交.md # 作品说明文档源稿 │ ├── 作品提交文档-完整版.md # 完整版源稿 │ ├── 作品方案-前端代码健康检查工具.md # 作品方案文档 │ ├── 小红书文案.md # 社媒发布文案 │ └── PRD-*.md # PRD 背景文档 ├── output/ # 示例产出报告 │ ├── ①-代码健康体检报告.md # 体检报告示例（58分 🟡） │ ├── ②-上线安全评估报告.md # 上线评估示例（⚠️ 有条件通过） │ └── ③-代码逐行整改方案.md # 整改方案示例（15项 55.4h） ├── submission/ # 比赛提交文件（命名合规） │ ├── CodeHealth-大卓-作品简介.md │ ├── CodeHealth-大卓-作品说明文档.md │ ├── CodeHealth-大卓-完整版.md │ └── CodeHealth-大卓-产品介绍.html └── shiwo-mobile-demo.zip # 测试用例skill源码工具地址
https://gitee.com/dazhuo-team/code-health
🦝 基于商汤办公小浣熊 · 十个内置能力全链路串联 · 零外部依赖