用途:对“代码已经能跑”的实现做第二次改进性审查,问题设定是“若用现在掌握的信息重写,下一版会怎样”。明确不负责查缺陷,缺陷排查交给 candid-review,也不做风格格式化、不发明新功能。\n\n主要能力:三类信号——🧭 Approach/design(更简单的结构、不同拆分、复用本仓库已有工具/模式、过早抽象或缺失抽象);🔍 Clarity(命名误导、控制流隐藏意图、抽象层级混杂、注释取舍、魔法值);✨ Quality(符合语言/框架习惯、死代码、残留脚手架、可测试性摩擦、不牺牲清晰度的廉价性能收益)。输出强调质量优先,默认最多 maxOpportunities=7 条高信号机会。可附带极少量真缺陷(每行一条,最多3条,路由到 /candid-review),可用 --no-bugs 关闭。\n\n使用方式:在 git 仓库中运行,先读取 ./Technical.md(回退 ./.candid/Technical.md)。与 candid-review 不同,跳过暂存检查,审查未暂存改动(git diff --stat),无未暂存改动时回退到与合并目标分支的分支差异(git diff <branch>...HEAD,优先 main/stable/master,可用 --merge-target 或配置 mergeTargetBranches 指定)。差异超过500行会询问优先目录/文件。支持 CLI 与项目/用户配置:--focus approach|clarity|quality、--exclude、--no-bugs、improve.maxOpportunities、--auto-commit,配置优先级 CLI→.candid/config.json→~/.candid/config.json→默认;tone 可用 --harsh/--constructive 或交互选择。\n\n流程:收集上下文(完整读取改动文件、查已有导入/工具、关联测试、近期提交、同类模式)后,按三类清单识别机会,再按杠杆、复用信号、应用成本排序并截断。每条机会含文件行号、类别、置信度(Safe ✓ / Verify ⚡ / Careful ⚠️)、当前与建议代码、为何更好、权衡。随后强制进入修复选择:全部应用、仅应用 Safe、逐条确认(可选查看精确 diff)、或全部记为待办;确认后逐条应用并输出状态表,失败不中断批处理。启用 auto-commit 时将 modifiedFiles 提交,提交信息含 Co-authored-by: Claude Sonnet 4.5 noreply@anthropic.com;最后把机会状态写入 .candid/last-improve.json,字段含时间戳、commit、branch、skill 及每条机会的 id、file、line、category、confidence、title。\n\n适用场景:提交前对未暂存工作或整条分支增量做结构性、可读性与质量提升。限制:非 git 目录无法检测改动;无可审差异时建议改用 /candid-review 审查暂存改动;不涵盖缺陷、边界与安全检查,也不扩展功能范围。
candid-improve-implementation
编程与开发
更新于 10-16 09:52