Agent Skill

写代码不求人

开发总闸:改现有代码、修 bug、加功能、大改重构全流程把关——改前拷问+验收清单,大改加方案确认门与子agent独立审查,改后实跑验收、台账落盘变更.md、跨对话续验。触发说法:帮我改一下/修个 bug/修一下这个/升级功能/加个功能/改个需求/重构一下/大改一版/做个新功能/这单需求做了/开个新版本/上次改的没改好吧。排除区:一次性提示词走 prompt-forge;游戏界面手感美术标准走 game-forge;版本打包细节走 version-zip;值不值得做走 expert-team;skill 文件改动走 skill-smith。

开发编程·¥AYAN·来自 skill_hub·skillhub.cn ↗
skillhub install @indiv-ayan/code-review93
6 Stars·9.7万 综合热度·5,025 字文档·源站更新 2026-11-22

README 文档

5,025 字

dev-guard:改前拷问,改后验收,大改过关卡

定位一句话:接一切改代码/做功能的请求,先判级再动手——小改快走,大改过方案门和独立审查门,全流程台账落盘,防改坏、漏同步、假修。

血统与借鉴:自家 change-guard 两线合流——v1.1.0 纪律(2026-11-17 并入)+ v2.1.0 实战档案(2026-11-18 并入:形态闸门、验收硬化、6 篇坑档案);另借鉴 devflow(loopforge-cli,MIT)思想,对第三方零拷贝。

30秒速览

  • 核心流程:判级 → 清单门 →(UI/输出形态类加形态闸门)→(L3 加方案门)→ 小步改 →(L3 加独立审查)→ 实跑验收 → 闭单回填 变更.md →(构成交付版本走 version-zip)
  • 关键纪律:验收清单 2-5 条,用户过目才动手;台账只追加禁整写;「应该能跑」=没验
  • 高危门:L3 动手前先 zip 备份;独立审查没跑禁闭 L3 的单

判级(先判级再动手,结果说给用户听一句)

级判据走法
L0 零逻辑错字、注释、纯文案直接改 + node --check
L1 小改不碰 state、存档、函数签名、依赖报一句范围就改 + node --check,免拷问免清单;闭单台账加一行式留痕(格式见变更单节)
L2 标准改其余常规改动清单门 → 改 → 实跑验收 → 闭单
L3 大改碰 state/存档结构、多文件联动、新功能从零起、用户说「大改/重构」L2 全套 + 方案门 + 独立审查 + 回滚备份

拿不准往上报一级(L1 还是 L2 报 L2),判级存疑要明说。

能力边界

能做不能做(去哪)高危动作(须确认)
改代码/修 bug/加功能的流程把关与验收游戏界面文案、手感、美术标准(game-forge)L3 覆盖式重写(先 zip 备份)
L3 改动方案与子 agent 独立审查值不值得做的决策(expert-team)删文件、清存档、动数据结构(清单里点名+用户点头)
变更.md 台账与跨对话续验版本 zip 打包细节(version-zip)
skill 文件本身的改动(skill-smith)

核心流程(关卡式)

1 清单门(确认门 · L2/L3)

  1. 验收清单:改完怎么验,2-5 条,每条给能直接跑的命令;给用户过目,过目前禁动手;连同规格行一起写进工作区根 变更.md(格式见下——清单只在对话里,换个对话就丢)
  2. 规格行:要什么/不要什么各一行——「不要什么」写明排除的做法(并列控件?新增菜单?改老行为?);UI/交互/输出格式类必过形态闸门(见下)
  3. 拷问(一次问完,禁挤牙膏:L2 三问、L3 四问):
  • 牵连:哪些函数/界面会跟着坏?
  • 数据:老存档/老数据还认吗?
  • 同步:state 变了,UI 和存档哪要跟着动?
  • 回滚(仅 L3):先 zip 备份,包名写进变更单——L2 觉得该问回滚=判级升 L3

2 形态闸门(确认门 · 控件增删/布局/交互模式/输出结构类必过;纯样式微调——颜色/字号/间距/文案——走 L0/L1 不过此门)

  • 先给 2 个具体形态让用户点选,确认后才写代码;判据口诀:一个槽位、一个按钮切模式、默认态=老行为、老的多值能力原样保留
  • 同一诉求被提第二次 = 理解错了,禁答「已经改好了,你 F5 刷新一下」——停下实现,复述成 2 个候选形态让用户点选
  • 复述用动词级描述(「点一下这个按钮,同一块变成两个日期框,再点变回来」),不用「下拉/选择框」这类控件名词——同一名词在用户脑子里可能是另一种控件
  • 返工现场与形态判据表读 references/控件级改动-一个槽位切模式.md

3 方案门(确认门 · 仅 L3)

  • 改动方案 ≤1 屏:动哪些文件、什么顺序、每步怎么自验;用户拍板前禁改代码
  • 用户说「先给方案不改代码」的,到此暂停等确认

4 改(L2/L3 通用)

只动清单内的,不顺手动别的。L3 按方案拆 ≤3 步,每步改完都能跑,炸了只回退那一步。走偏念头冒出来按下表打住:

念头现实
顺手把这个也改了不在清单内=记进变更单留给下一单,别混进这单
仓库太大,抽查几个文件就行要么声明没扫的范围,要么分模块逐个来
两次结果不一致,挑个像对的证据不足亲验再定,禁凭印象二选一

新写的代码:

  • 禁静默降级:except:pass、吞错返默认值,必须打日志或带质量标记
  • 假修先过三问:补判空——这值本来该是什么?加重试——操作能重复吗?吞异常——这个错归谁管?删校验/固定返回值/清缓存/加长延时=压症状,不是默认选项
  • 新加抽象/封装过删除测试:删掉它用户能感觉到吗?感觉不到就别加

5 独立审查门(仅 L3)

  • 开 1 个子 agent 干净上下文审这次改动,派发模板读 references/review-dispatch.md
  • 审查报告整段回填变更单;「建议修」修完对应验收项重跑;「可缓/不必」单列 Quick wins
  • 主线程不同意某条:变更单里写反驳理由,禁静默丢弃
  • 审查没跑 = L3 禁闭单

6 验收(质检门 · L2/L3)

  • 清单逐条实跑 + state/UI/存档三处一致
  • 验证顺序别跳:语法 → 全量测试连跑 2 次(第一次过第二次挂=有残留状态;仓库有测试设施才跑,没有就跳过此步,真链路+证据命令顶上,禁硬造测试凑流程)→ 真链路(夹具全绿≠真环境绿,用真实数据跑出能反算的数字)→ 清旧 grep(旧行为/旧文件名/旧版本号,活引用 0 命中,命中分类汇报禁只报一个 0)→ 一条固定证据命令(可回放,输出 PASS n/FAIL n+关键数字,数字能和源表/真页面对上,同一条命令重跑结果一致才算数)
  • 证据配改动,「没报错」不算验过:文案/配置=打开文件核对;逻辑/脚本=真跑一次+边界值;页面/游戏=真开到目标页操作一遍
  • 验证到哪层就写哪层:已改未运行/止于静态检查(node --check)/实际运行——前两层禁写成「验过」
  • 新用的 API/配置项跑一遍,「看起来存在」不算(防幻觉)
  • 全过才算完,「应该能跑/大概」=没验,禁当结论
  • 修 bug:先复现 → 定位根因 → 才改;修完重跑清单,再用反例证伪一次(空值/空集合/极值/跨日),推翻不了才算修好;偶发不再出现≠修好,收尾说清是根因修复还是暂时缓解
  • 验收撞上老 bug:先分清这次引入的还是原有的,别让它背锅、也别拿它遮新问题;已改还失败:先确认跑的是新代码/新包
  • 新增/调整的分支必须人为制造那个条件让它真跑一次(状态导航回起始态/超时压到必触发/喂必然失败的输入),贴那次真实日志行——走不到的代码等于没验
  • 别打断在跑的东西:跨进程共享资源(同一调试端口/库文件/锁)要么 dry-run 跳过后半段,要么先记兄弟进程 PID 验完核对它还活着;测完清测试对象,前后数量回原值
  • 验收坑位合集读 references/验收坑位.md

7 闭单与沉淀(L2/L3)

  • 回填 变更.md:结果贴输出摘要、勾清单、写三档结论、未验范围点名(别让人以为全覆盖);≤5 分钟能修的小问题单列 Quick wins 别混进验收项
  • 踩的坑当场追加 references/lessons-ledger.md
  • 这单构成交付版本 → 走 version-zip skill 当天压包(版本链规矩在它那)

变更单(落盘格式)

工作区根建 变更.md,一次改动追加一节在文件末尾(台账式,不每变开目录)。只追加、禁整文件重写:新增节用文件末尾唯一锚点 patch 进去,回填只改最后一节;多会话并行写同一份台账时,写完回读一眼文件尾部有没有别人的新章节被顶掉(2026-11-16 血案:整文件重写把并行会话 100+ 行台账冲成 20 行)。误覆盖后怎么捞原文读 references/台账误覆盖与恢复.md。没走完全流程收工时,这文件就是下个对话续验的锚点:

## <日期> <主题>
级别:L2 / L3
规格:要什么 / 不要什么(各一行)
范围:<动哪个文件哪几个函数>
验收:
- [ ] <怎么验,每条给能直接跑的命令>
拷问:牵连… / 数据… / 同步…(L3 另加回滚<zip 名>)
方案:<L3 必填,≤1 屏,已拍板/待拍板>
审查:<L3 必填,贴报告或写「未跑,原因」>
结果:<改完回填,每条贴命令输出摘要,勾掉对应项>
结论:全过 / 部分过(哪条没过、为什么)/ 没过
  • 结论三档,只有「全过」才算完
  • 没验完就收工:结果栏写「待验:<哪几条>」,别留空白让人以为验过
  • L2 空栏直接不写(拷问压成一行结论;方案/审查栏 L3 才有),禁写「无」占位
  • L1 不开节,台账末尾加一行:## <日期> <主题>|L1|<范围一行>|<结果一行>

跨对话续验

用户给了工作区路径后:先跑 node <本skill>/scripts/change-log-check.js <工作区>/变更.md 列未闭单,读对应节按没勾的清单接着跑——不靠对话记忆,也不翻没给过的路径。

纪律可触线表

场景上限到顶后动作
澄清追问同一需求至多 2 轮第 3 轮用默认假设继续,变更单顶部声明「基于假设X」
拷问一次问完:L2 ≤3 问、L3 ≤4 问禁拆成多轮挤牙膏;L2 想问回滚=升 L3
验收清单2-5 条超了合并砍条;验不动=判级错了,回判级重切
方案≤1 屏超了=没想清,先砍需求范围再写
独立审查派发1 单首派 1 次 + 修后复核重派 1 次两轮后仍冲突,问题写进变更单交用户拍板
L3 改动步进按方案拆 ≤3 步,每步改完即 node --check炸了只回退那一步;步骤走偏停下回方案门
台账写入只追加、只回填最后一节想整文件重写=停手,先读 references/台账误覆盖与恢复.md

诚实状态

  • 证据标签:[已验证](贴输出摘要)/[推断](说依据)/[待核实](说缺什么)
  • 验收跑不了(环境缺、账号没登)→ 结论写「待验:缺什么」,禁跳过、禁冒充验过
  • 禁静默降级:判级拿不准往上报一级并明说;审查结论与主线程判断冲突时不私了

预期管理

  • 负面承诺:不替用户拍需求做不做(expert-team 的事);不做领域质量标准(game-forge);不管打包细节(version-zip);独立审查只报问题不当场改代码,修不修回主线程走档位
  • 效果承诺:设计目标=改坏、漏同步、假修在门上被拦住;不承诺=零 bug、性能最优;可验证指标=闭单时验收清单实跑率 100%、L3 独立审查覆盖 100%、审查报出主线程漏掉的问题数记入变更单

自检清单(证据制)

□ 首包机检 exit 0 —— 贴汇总行 □ change-guard v1.1.0 纪律逐条有落点 —— 对照表见本包 变更.md 建包节 □ change-log-check.js 拿真台账跑通 —— 建包节贴两次输出(未回填=未闭,回填=已闭) □ change-guard v2.1.0 吸收逐项有落点 —— 对照表见本包 变更.md v1.1.0 节 □ 竞品对标 6 条(吸收 2/淘汰 4)逐条有落点 —— 对照表见本包 变更.md v1.2.0 节

参考文件索引

文件一句话职责(什么任务读它)
references/review-dispatch.mdL3 独立审查派发模板(大改审查门时读)
references/lessons-ledger.md现场坑账本(开工先读,踩坑当场追加)
references/控件级改动-一个槽位切模式.mdUI 控件类形态判据与四次返工现场(形态闸门时读)
references/验收坑位.md验收骗过自己的坑位合集(真链路/UI 验收、修完复验时读)
references/台账误覆盖与恢复.md台账被整写覆盖后捞原文的配方(误覆盖后读)
references/打包与批量改动.md批量改/重打包的机器纪律(多文件改动、打包时读)
references/术语与目录改名.md改目录名/术语的封闭清单替换法与 grep 分类口径(改名时读)
references/检查器误报治理.md加/改检查项前必读:假绿vs误报、换信号、反向测试
scripts/change-log-check.js扫变更.md 列未闭单(跨对话续验第一步)

免责声明

  • 现状提供:本 skill 与随附文档按「现状」提供;基于 MIT 许可可自由使用、修改、再分发,MIT 许可证全文折入本声明、不单独附 LICENSE 文件
  • 不担保:不对适销性、特定用途适用性、准确性、不侵权作任何明示或默示担保,使用效果因项目与环境而异
  • 不担责:对因使用或无法使用本 skill 造成的任何损失(含数据丢失、业务中断)不承担责任
  • 血统借鉴:机制借鉴 devflow(loopforge-cli,MIT)思想,对第三方零拷贝;change-guard v1.1.0/v2.1.0 为作者本人旧作,本包为两线合流
  • 台账与坑账本为作者真实使用记录,已脱敏,不含个人身份与内部项目信息

同分类其他技能

查看全部 ›