阿拉丁·代码质量领航员

为什么要把审查、修复、测试和提交串起来

在日常开发里，代码写完之后的收尾工作往往散落在多个工具之间。code-reviewer 只能出审查报告，不会生成修复补丁；gen-test 只负责补单测，不管代码本身有没有安全问题；commit-message-writer 只管提交信息，不会回头看审查结论。这意味着每完成一次交付，开发者要在几个技能之间来回切换，手动把审查结果、修复代码、测试用例和提交信息拼到一起。

aladin-code-pilot 把这条链路收口成一条本地流水线。它不替代任何一个单点工具，而是把审查、修复、单测、提交和门禁报告串成一个连贯的过程，让智能体一次性产出完整的交付物。

它如何工作

这条流水线的核心是先聚焦改动，再逐层展开。

• 变更聚焦：通过 code_diff.py 提取 git diff（包括已暂存和未提交的改动），只审查本次改动涉及的代码，避免全量扫描浪费 token。没有 git 仓库时，自动退化为两个目录的对比。
• 五维审查：按照规范、Bug、安全、性能、可维护性五个维度做静态审查，覆盖 18+ 种语言，统一严重度口径。审查清单和语言惯例来自 references/review-dimensions.md。
• 自动修复补丁：对高风险问题生成标准 unified diff 格式的补丁，用户确认后可以用 git apply 直接应用。修复模式遵循 references/fix-patterns.md，只解决质量缺陷，不改变函数的既定行为。
• 单元测试生成：为被标记的函数生成独立可跑的单测，覆盖边界条件和异常路径，支持 pytest、jest、JUnit、go test 等框架。
• 规范化提交 + CHANGELOG：基于审查结论生成 Conventional Commits 风格的提交信息和变更说明。
• 质量门禁报告：code_report.py 把结论渲染成 report.html（评分环 + 严重度分布 + 问题清单 + 补丁 + 单测 + 提交）和 report.md（贴 PR 或读屏用），支持设置门禁阈值（如 score < 70 打回）。

整个流程的脚本只依赖 Python 标准库，不联网、不上传、不装包。

适用边界

这条流水线适合写完代码之后的质量收口，但不是万能的：

• 它做的是静态审查，不做运行时压测、渗透测试或动态污点分析。
• 生成的补丁和单测需要用户确认后才落盘，技能本身不会自动 git apply、git push 或提交。
• 它不替代人工架构评审和最终技术决策，跨文件的设计问题仍需开发者自己判断。
• 审查覆盖率受上下文和可见代码范围限制，不能保证发现所有缺陷。
• 规则库内置在 references 目录中，离线可用，但不会联网抓取最新的外部规则。

如果你只是要一句提交信息，直接用 commit-message-writer 更轻量；如果你要运行并调试代码直到通过，用 code-run-auto-fix 更合适。但如果你希望审查、修复、测试、提交一次到位，并且留一份可追溯的门禁报告，这条流水线值得试一下。