本文是整理,不是新实测。内容来自完整版 2026-10-01 的测试记录-D1:10 个中文 slash command 在测试床与本仓库真实 git 历史上各真实调用一遍,输出不符合输出格式或执行中需要靠猜的地方记为含糊点并回写。测试床为 /tmp/cmdtest/orders.py(刻意埋 3 个 bug:文件未关闭、o["level"] KeyError、浮点未舍入),测试环境为 pytest 9.1.1。
先说结论:3 条零修改通过
- /plan:给 orders.py 加 CSV 导出、按日期过滤,真实输出 5 个任务(含验收标准、依赖、涉及文件)+ 3 个 [待确认] + 风险 + 并行顺序,完全符合输出格式。
- /review:真实找出全部 3 个预埋 bug(文件未关闭、KeyError、浮点未舍入),分级 [必须改]/[建议改]/[可忽略] 正确,每条带“为什么 + 改法代码片段”。
- /onboard:对 /tmp/cmdtest 输出一句话定位 + 地图 + 关键路径(load→settle→summarize)+ 可复制的上手命令(真实跑通),第一刀定位到 orders.py:26(已知 bug 点,准确)。 这 3 条的共同点不是写得完美,而是步骤已经具体到不用猜:输入、输出格式、判定标准都齐全。
7 条各修 1 处:修的都是“执行中要靠猜”
- /debug:第一个假设命中后,剩下的还要不要走。实测复现 batch_settle 传入 level 缺失订单的 KeyError,H1 一次命中根因,但流程没说剩下的假设还要不要走,实测中被迫“为走流程而走流程”。修复:第 3 步加“若第一个假设验证即确认根因,剩余假设可标 [跳过] 并说明理由”。
- /test:测试文件放哪,没写。实测针对 calc_discount 列出 6 个用例,写 test_orders.py,真实跑 pytest 6 passed,但 prompt 没说测试文件放哪,实测中靠猜(放同目录)。修复:第 2 步加“有 tests/ 放 tests/,没有就跟被测文件同目录,命名 test_xxx.py”。
- /refactor:安全网基线是红的,流程没说怎么办。实测把 summarize 的统计和打印拆开,定契约(返回值与打印内容不变)→ 补安全网(2 passed,全绿才动手)→ 拆成 calc_total + print_summary → 跑测试 8 passed → 收尾三问。但如果安全网基线本来就是红的,带着红灯重构无法区分是谁的锅。修复:第 2 步加“安全网基线必须全绿;基线有失败先报出来,不要带着红灯重构”。
- /doc:API 类型列了,工作流没细化。实测给 orders.py 补注释,calc_discount 补“为什么”注释(折扣率业务依据不明,按诚实原则标 [待确认],不编造),batch_settle 补“缺失 level 默认 normal”的约定注释,改后 pytest 8 passed。但调用方式列了注释 / README / API 三种类型,工作流只细化了前两种,API 类型进来会不知道按什么步骤写。修复:第 1 步加 API 类型分支(方法 + 路径 + 参数表 + 返回示例 + 错误码表)。
- /commit:“相关 vs 不相关”全靠悟。实测本仓库真实执行,11 个新文件 staged,diff 混了 feat(10 commands)+ docs(选型),prompt 的“混了两种改动先提醒拆分”正确触发;经判断选型 doc 是 commands 的依据(同一目的),合为一次提交。修复:第 2 步加判断标准“是否为同一目的服务”,并给正反例子。
- /pr:目标分支是 master 还是 main,得靠猜。实测在分支 d1-tuning(5 个调优改动 vs master)真实生成 PR 描述,结构完整(一句话 / 背景 / 改动点 / 怎么测 / 风险 / 自检)。但“读当前分支与目标分支的 diff”里目标分支是 master 还是 main 得靠猜(本仓库是 master)。修复:第 1 步加“先看默认分支 master/main,不确定就问用户”。
- /release:grep TODO 会命中文档正文,容易误判。实测对本仓库做发版 dry-run,grep 查调试残留命中均为文档正文对 TODO 的说明,无裸 TODO,判通过;敏感信息无;测试不适用(纯文档仓,诚实标 N/A)。结论正确触发“有一项不过就叫停”:README 未写(D5 才写),暂缓发版。修复:检查清单加括号说明“命中文档正文对 TODO 的说明不算,数的是代码里的裸 TODO”。
汇总:没有为改而改。10 个文件全部真实调用一遍:3 个零修改通过,7 个各修 1 处含糊点,共 7 处回写。所有修复均为“执行中需要靠猜”的真实痛点。测试床保留 2 个未修复 bug(文件未关闭、浮点未舍入)+ 1 个已知约定,供后续复测继续用。一句话总结:命令初稿能不能卖,不看写了多少条,看每条在真实调用里有没有让人靠猜的地方——有,就改掉那一处再卖。
不用这套初稿实测方法的场景:命令还没写完、只想先看 Lite 版 3 条长什么样,直接按 Lite 版说明装,不用照搬这套全量实测;只是改了一处文案、没有改工作流步骤,不用重跑全部 10 条,跑改动的那条即可。
价格与链接:完整版中文 AI 编程 CLI 工作流包:早鸟 ¥9.90(限前 100 份),正式 ¥19.90。
