Skip to content
This repository was archived by the owner on Sep 28, 2026. It is now read-only.

flow:流程 skill——改动落地的路线,判为改动落地才读(#108) - #110

Merged
Eridanus117 merged 10 commits into
mainfrom
Eridanus117/desk142-flow-skill
Sep 16, 2026
Merged

Eridanus117 merged 10 commits into
mainfrom
Eridanus117/desk142-flow-skill

Conversation

@Eridanus117

@Eridanus117 Eridanus117 commented Sep 16, 2026 •

Copy link
Copy Markdown
Owner

做了什么

  • 新增插件 plugins/flow(0.1.0):流程 skill,改动落地的路线。路由 skill、自动调用(frontmatter 只有 name 与 description,Claude 侧 name-only 进上线待办)。正文五节:什么时候用、步骤(开场后的可撤动作、九段表——门、产物、每段点名的步、门口那条消息的形状、可选步、停靠记录、会话绑定、结束时)、产出、出口、为什么在哪;151 行。desk#140 四步未建之前,表里写「按这句手做」。
  • 八个 claude plugin eval 用例,每个都带一份 mock 的规则(常驻规则的分拣块与说话规矩四条,用 append_system_prompt 注入):三条判路线(票开场列可选步、停靠记录四栏、从第 4 段进),一条判分拣句加路线(机会 issue 开场),四条判分拣句与说话规矩(小改动、两可句、想建 X、带选项面的问题)。基线观察与实跑记录在 evals/README.md;results/2026-09-16-baseline/、results/2026-09-16-gate/ 与三条重跑的 results/2026-09-16-gate-rerun/<用例>/ 各一份 aggregate-result.json。
  • 词汇表 plugins/CONTEXT.md 加两节:「主人开口之后」(来往、要答案、小改动、改动落地)、「进了段之后」(段、门、步、可选步、停靠记录)。
  • ADR-0005「来往判法常驻提示词,路线放在流程 skill 里、判为改动落地才读」(accepted,2026-09-16 grill 结论);目录加行。
  • 登记:.claude-plugin/marketplace.json、profiles/daily/manifest.json、profiles/all/manifest.json 各一条;目录页重生成;plugins/README.md 插件数改十一;AGENTS.md「Agent skills」节加一条指向 flow 的入口(spec 外,低风险)。

为什么

Closes #108,Closes #107。方案对齐记录在 desk#142。私人机上只要一套工作模式:三种来往(要答案、小改动、改动落地),只有第三种走段;路线此前散在共用规则(常驻提示词,每场都背)、workcoding 壳和已关闭的 Superpowers 四格之间。本 PR 把路线收进一条 skill,判为改动落地才读;分拣与说话规矩留在常驻规则(取舍见 ADR-0005)。

判两件事(按 skill-authoring):是路由 skill——它决定所有 skill 什么时候被用,所以先走了第 2 段(#108、ADR-0005)才在第 5 段回来做;是自动调用——常驻规则一句「判为改动落地先读 flow」点名,agent 自己读,不加 disable-model-invocation。

与 spec 的偏离:无。spec 里的接缝 2(分拣块当 mock 的规则)用 append_system_prompt 实现,诊断用例确认该字段生效。

怎么验证的

  • claude plugin validate plugins/flow:通过。
  • node plugins/tests/skills.test.ts:通过(11 个 Plugin、19 个 Skill,目录页一致)。
  • 基线(SKILL.md 占位,每用例 1 次,两组):路线类用例两组都是 0,分拣与说话规矩类在对照组已基本成立;观察写在 evals/README.md,用例按观察修过一轮(提示词加「仓库不在这里」、三条 grader 放宽为「最多一个要主人定的问题」)。
  • 有 skill 组对对照组(claude plugin eval plugins/flow -j 4 --judge-model sonnet,每用例 3 次):路线类四条差值 +0.92 到 +1.0(opening-issue 1.0 对 0、ticket-optional-steps 0.92 对 0、docking-record 1.0 对 0.08、enter-at-segment-4 1.0 对 0);分拣与说话规矩类四条两组同分(1.0 对 1.0 三条,opening-small-change 0.89 对 0.89),是 mock 规则在起作用,只作回归守卫;平均差值 +0.48。两条没到 1.0 的都是判官对合规回复的单次抖动(细节在 evals/README.md 实跑记录),未按硬线重跑,由负责人在第 6 段的门上定。结果在 results/2026-09-16-gate/ 与 results/2026-09-16-gate-rerun/<用例>/。
  • 两份结果 JSON 都跑过 scrub-eval-results.ts,没有本机用户名。
  • 公共面门禁 assess-public-tree --rev HEAD:allowed(scanned 1427)。contracts validate、三方审阅验证器测试、skill-evaluation.test.ts、联邦入口静态合同、entry_sync check --scope repository:都通过。
  • /code-review 两轴审查过一轮,已修:Spec 轴——第 1、2 段缺「一轮一题、先例后问、说平语」;起始段映射「需求 issue → 第 4 段」与表里第 1 段产物自相矛盾(改为机会 issue → 第 2 段、spec issue 或票 → 第 4 段);第 7 段抄了常驻规则的「不 push、不合并」;第 9 段漏工作日志。Standards 轴——llm grader 一条判三件事(拆成 19 条各判一件事);regex 与 llm 判同一件事(删);词汇表与正文重句、缺「段」「停靠记录」;AGENTS.md 缺 ADR 链接。判断题保留并说明:SKILL.md 里保留 orca worktree 的选择器写法(绑定靠它,写「去查」反而要每次翻帮助);八份 prompt 的 mock 规则逐字相同(工具没有共享位,README 声明副本关系)。

怎么回退

revert 本 PR。manifest、marketplace 条目、目录页随 revert 一起回去;本 PR 不改 agent-config,共用规则的改法、可见档、wiki 三处由上线待办(agent-config#53)驱动,revert 后无需清理外部状态。

🤖 Generated with Claude Code

zaurakworks and others added 10 commits September 16, 2026 15:31
- ADR-0005:来往判法常驻提示词,路线放在流程 skill 里、判为改动落地才读(accepted,2026-09-16 grill 结论)
- plugins/CONTEXT.md:加「主人开口之后」(来往、要答案、小改动、改动落地)与「进了段之后」(门、步、可选步)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- plugins/flow:plugin.json 0.1.0、SKILL.md 占位(正文等基线跑完再写)
- 八个 claude plugin eval 用例:五条判开场那一句与说话规矩(带 mock 的分拣块),三条判路线
- marketplace、daily/all manifest 各一条;目录页重生成;plugins/README 插件数改十一

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- SKILL.md:开场后的可撤动作、九段表(门、产物、点名的步)、门口那条消息的形状、可选步、停靠记录、会话绑定、结束时
- 用例:mock 规则里自由文本改成「先不动手」;提示词加「仓库不在这里」;三条 grader 放宽为「最多一个要主人定的问题」;no-flow-read 改为指示器
- evals/README.md 基线观察;results/2026-09-16-baseline(已 scrub 用户名)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- 小改动、票开场、想建 X、带选项面的问题四条 grader 改写:要材料不算另一问、门口请主人说行是预期
- 去掉两条数问题的 grader:裁判模型把「先给例子」的问句也数成一问,判不稳;「一轮一题」留给真实会话的反馈守,README 写明
- README 用例构成表同步

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- SKILL.md:起始段映射改为「机会 issue → 第 2 段;spec issue 或票 → 第 4 段」,第 1 段产物改机会 issue;第 7 段去掉与常驻规则重复的 push/合并句;第 9 段加工作日志;规矩里加第 1、2 段一轮一题先例后问说平语;「未建」四格精简
- CONTEXT.md:加「段」「停靠记录」,步/可选步只留定义
- AGENTS.md:Flow 一节加 ADR-0005 链接
- evals:9 条多面 llm grader 拆成 19 条各判一件事;去掉与 llm 重复的 regex(只留停靠记录标题)

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- SKILL.md:issue/票/PR 开场先说开场那一句再做可撤动作(门评测里有一次漏说)
- stops-at-gate:门口预告本段要收口的题不算「在问设计问题」
- no-segments-no-edit:不再数问题
- gate-message-approval:请主人说行、请主人把会话挪到目标仓、请主人贴不可用命令的输出,都算门口的合法收尾
- 目录页重生成

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- route-actions:会话不在 Orca worktree 里而跳过绑定,按正文是对的,不判 FAIL
- no-segments-no-edit:只判「说已经改了文件」和「进段」,贴改好的文本不算改
- gate-message-approval:问目标仓在哪、要工具可用,都算门口的合法收尾

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- results/2026-09-16-gate:完整一轮,五条用例的最终数字
- results/2026-09-16-gate-rerun/<用例>:三条按判官反馈改 grader 后的重跑
- README 实跑记录:八条数字、两条 0.89/0.92 的判官抖动说明、迭代过程;结果已 scrub 用户名

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

2 participants