code-cure
📖 技能介绍
name: code-cure description: 审查与修复互补型代码质量技能。当需要用 WorkBuddy 平台代码审查专家做全面审查后落实修复，或在调用其他专家产出代码后充当审查闸门时使用。内置任务复杂度评估(S/M/L)与按节点归档、单节点可回滚、结构化交接协议。效果依赖配置专业代码模型 KEY(如 Qwen3-Coder)；属进阶型技能，需理解审查-执行分离工作流。 version: 1.0.0 type: user agent_created: true
code-cure · 代码修缮闭环
0. 这是什么（请先读这一段）
code-cure 是 WorkBuddy 平台「代码审查专家」的功能互补技能，不是它的替代品。
- 平台「代码审查专家」：只审不改，产出 blocker / suggestion / nit 三级评论。
code-cure补齐两块它不做的：「改」（Mode X 执行者） 与 「档」（按节点归档 / 单节点可回滚）；并在召唤其他专家干活时，顶上 「审」（Mode R 审查者） 的角色。
两者配合形成 「审 → 改 → 档 → 复检」闭环：
其他专家产出代码 ──(Mode R 审查)──▶ 标准 issue 报告
平台代码审查专家全面审查 ──issue list──▶ (Mode X 执行) 逐条修复 + 按节点归档
│ │
└──────────── 每节点自动回交复检 ◀────────────────────────┘
⚠️ 进阶提示：本技能默认不内置任何模型密钥。审查与修改质量取决于你配置的专业代码模型 KEY（强烈建议
Qwen3-Coder类代码专用模型，而非通用模型qwen-plus/deepseek-chat）。未配 KEY 时仅能跑规则兜底，效果有限。配置方法见 §6。
1. 何时使用（触发逻辑）
| 场景 | 模式 | 动作 |
|---|---|---|
| 召唤其他专家/技能产出代码后，说「审一下 / 质量闸门」 | Mode R | 以 5 维 + 三级标记审查其产物，不改代码，产出标准报告 |
| 用平台代码审查专家全面审查完，拿到 issue list，说「按意见改 / 落实修复」 | Mode X | 逐条把 issue 落成代码，每步进节点归档 |
| 任务较复杂、怕改错扩散，说「先评估复杂度 / 建节点骨架」 | Scaffold | 复杂度评估 + 生成节点目录 + manifest |
负面触发（不要用本技能）：纯文档写作、与代码无关的通用问答、替代平台代码审查专家做"只审"——那是专家本职。
2. Mode R（审查者）
- 加载
references/review-format.md拿到 5 维 + 三级标记 规范。 - 收集待审代码：节点 diff + 相关文件上下文（禁止只看孤立行，上下文越全误报越低）。
- 调引擎（
scripts/engine.py）按 5 维逐条产出 issue，格式严格遵守 §4 结构化交接协议。 - 输出标准审查报告（含每维小结 + blocker 总数），不修改任何文件。
3. Mode X（执行者）
- 读取专家/Mode R 产出的 issue list（结构化格式见 §4）。
- 调
scripts/scaffold.py建立/定位节点目录，manifest.json进入fixing。 - 逐节点把 issue 落成代码，严格约束在本节点边界内（禁止越界改其他节点文件，从源头防「拆东墙补西墙」）。
- 每节点改完 → 自动把该节点 diff 回交代码审查专家复检；专家不可调度时降级为
scripts/engine.py同 prompt 复检。 - 复检若仍有
blocker→ 在该节点内迭代（防抖：同节点最多 2 轮）；全部通过才进入下一节点；状态机落manifest.json（pending → reviewing → fixing → passed）。
4. 结构化交接协议（专家 ↔ 本技能共用）
专家产出、Mode X 消费的 issue 统一格式：
小葱技能站7w4.net，专业的AI技能分享平台。
[blocker] src/order.py:142 — 未处理 None 导致空指针 — 建议：增加空值守卫
[suggestion] src/pay.py:30 — 重复校验逻辑 — 建议：抽取为 validate()
[nit] src/util.py:8 — 变量名 x 语义不清 — 建议：改为 retryCount
- 三级：
blocker(必须改) /suggestion(建议改) /nit(可选)。 - 严重级别默认沿用专家 3 级保交接；可选升级为阿里 4 级（BLOCKER/CRITICAL/MAJOR/MINOR，更细），落地时与专家实际口径一并确认。
- 5 维定义见
references/review-format.md。
5. 文件分档 / 节点归档（核心新颖点）
复杂度评估（S/M/L）规则见 references/complexity-rubric.md（规则关键词优先定档 + 可选 LLM 一句话估算兜底）。归档机制：
- 推荐：每个 task 初始化一个 git repo，每个 node 作为一个 commit → 天然支持单节点回滚（
git revert <node-commit>）。 - 降级：无 git 时 → 纯文件快照
node-XX/diff/<node>.patch+ 反向 patch 回滚。 - 目录结构（归档根目录默认用户级
~/.workbuddy/code-cure-workspace/，可经环境变量CODE_CURE_WORKSPACE覆盖，例如指向你的 D 盘根据地）：
<task-slug>/
manifest.json # 任务元信息 + 节点图 + 状态机
README.md # 任务总览
node-01-<slug>/
plan.md # 本节点目标 / 接口 / 验收
code/ # 本节点产出或修改的文件
diff/ # 本节点 diff 快照
review.md # 本节点审查记录
notes.md # 踩坑 / 决策
node-02-<slug>/...
每个 node 的 diff 独立快照，支持「只回滚某个节点」，从根本上避免错改扩散。
6. 引擎抽象层（BYOK，关键）
审/改引擎做成可插拔，默认用户自带密钥（BYOK）：
| 环境变量 | 含义 | 默认 |
|---|---|---|
CODE_REVIEW_MODEL |
使用的代码模型名 | qwen3-coder |
CODE_MODEL_KEY |
你的 dashscope KEY（BYOK） | 空（必填才能跑模型） |
CODE_MODEL_BASE_URL |
兼容 OpenAI 的 endpoint | https://dashscope.aliyuncs.com/compatible-mode/v1 |
CODE_ENGINE_ENDPOINT |
可选：托管代理地址（第二阶段付费形态） | 空 |
CODE_CURE_WORKSPACE |
节点归档根目录 | ~/.workbuddy/code-cure-workspace/（可用环境变量指向 D 盘） |
降级链（永不因单一模型不可用而中断交付）：
Qwen3-Coder（主）→ deepseek-chat（备，需 DEEPSEEK_API_KEY）→ 规则评分（兜底）。
为何强调专业模型：
Qwen3-Coder是通义灵码同款代码专用模型，经万级企业实测（缺陷识别 ~80%、评审覆盖率 +30%）。通用模型做代码审查/修改明显偏弱。详见references/engine-layer.md。
7. 与调研大师 / 多AI协作的关系
- 调研大师·增强版：复杂任务动手前先验性跑调研做领域/竞品/可行性调研。
- 多AI协作交付：需「生成完整交付物」时把节点生成交给它，本技能负责把产物纳入 node 归档 + Mode R 审查。
8. 脚本入口
scripts/scaffold.py <task-slug> [--desc "..."] [--llm]— 复杂度评估 + 生成节点骨架 + manifest。scripts/review.py --diff <file> --context <dir>— Mode R 审查，输出结构化 issue。scripts/fix.py --issue <file> --node <node-dir>— Mode X 单节点修复。scripts/engine.py— 可插拔模型客户端（被 review/fix 调用，一般不直接跑）。
所有脚本用 Python 标准库（urllib/json/argparse），无第三方依赖，开箱即跑。
🤖 AI 评测
这个技能做得相当用心，工作流设计完整，节点归档和回滚机制很有新意，能有效防止越改越乱。文档结构清晰，脚本无依赖配置简单。不足是规则检查比较基础，复杂代码场景下可能需要依赖外部模型。整体而言是个好用的进阶工具，适合需要频繁做代码审查和修复的开发者。
