flow：流程 skill——改动落地的路线，判为改动落地才读（#108）

.claude-plugin/marketplace.json

@@ -55,6 +55,11 @@
       "name": "skill-authoring",
       "version": "0.1.0",
       "source": "./plugins/skill-authoring"
+    },
+    {
+      "name": "flow",
+      "version": "0.1.0",
+      "source": "./plugins/flow"
     }
   ]
 }

AGENTS.md

@@ -61,6 +61,10 @@ Issue 与 spec 记在本仓的 GitHub Issues，用 `gh` CLI 操作。见 [`docs/
 
 写一条自建 skill 或改既有自建 skill，用 `skill-authoring`（`plugins/skill-authoring`）：判是不是路由 skill、手动还是自动调用，先写评测用例跑基线再动笔，出口是 PR 加上线待办。退役不在它的范围。
 
+### Flow
+
+改动落地的路线在 `flow`（`plugins/flow`）：九段的门与产物、每段点名的步、可选步、会话绑定、停靠记录。哪种来往、开场那一句由使用方仓的常驻规则定，判为改动落地才读它（取舍见 [ADR-0005](./docs/adr/0005-来往判法常驻提示词路线放在流程skill.md)）。
+
 ### Domain docs
 
 多 context：仓根 `CONTEXT-MAP.md` 指向每个包各自的 `CONTEXT.md`；跨包决定沿用既有的 `docs/adr/`（MADR，2026-09-04 裁定）。

docs/adr/0005-来往判法常驻提示词路线放在流程skill.md

@@ -0,0 +1,63 @@
+---
+status: accepted
+date: 2026-09-16
+decision-makers: 负责人
+---
+
+# 来往判法常驻提示词，路线放在流程 skill 里、判为改动落地才读
+
+## 背景与问题（Context and Problem Statement）
+
+- 2026-09-14 负责人定（desk#142）：私人机上只有一套工作模式，由一个流程 skill 承载；它是所有 skill 的唯一入口，其他 skill 只在它点名或主人敲 `/名` 时才用；路线真源从共用规则挪到流程 skill（desk#141 作废）。
+- 现状：九段路线、每段点名谁、「怎么开始、怎么结束」都写在 agent-config 的共用规则里，由 `deploy.ts` 编译进三个客户端的上下文文件（CLAUDE.md／AGENTS.md），每场每轮常驻，约占 120 行里的 45 行。
+- 主人与 agent 的来往只有三种：要答案、小改动、改动落地（定义见 `plugins/CONTEXT.md`）。只有第三种会用到段；前两种会话背着九段的规程没有用处。
+- 2026-09-16 方案对齐时负责人问：如果流程 skill 每场必读，它和提示词有什么区别？
+
+请负责人定的一件事：路线放哪——全放 skill、全放提示词，还是分开；分开的话线画在哪。
+
+## 决策驱动因素（Decision Drivers）
+
+- 一个真源：同一句话只在一处（desk#141 的诉求）。
+- 改得勤的东西要便宜改、能测、能回退：负责人定「直接装、用中改」；#140 四步落地、`workcoding` 退役、用中记的反馈都会改路线。
+- 第一句回复之前就要知道的东西不能靠 agent 自己去读，必须常驻。
+- 提示词越长，每条被遵守的概率越低；前两种会话不该背第三种的规程。
+- 三个客户端行为一致。
+
+## 考虑过的方案（Considered Options）
+
+| 方案 | 做法 | 适用场景 | 代价 |
+|---|---|---|---|
+| A 全进 skill | 共用规则只留一句「开场一律先读流程 skill」；分拣与路线都在 skill 里 | 三个客户端都能可靠地在第一轮读 skill | 每场都要读，等于提示词换了个装法；每场都多一个漏读点；前两种会话白背 100 行 |
+| B 全进提示词 | 不建流程 skill，路线留在共用规则 | 路线基本定型、不再改 | 改一次要 PR 加 `deploy.ts sync`；没有对照组 eval；三个客户端的提示词各多约 60 行常驻 |
+| C 分开 | 共用规则留十来行：三种来往怎么分、开场那一句与等不等、说话的规矩，加一句「判为改动落地就读流程 skill」；流程 skill 装九段的顺序、门、回退、跳段、从任一段进、每段点名的步、可选步、会话绑定、停靠与挂起物 | 既有定下来基本不动的规矩，又有会反复改的规程 | 流程分在两个文件；Codex 与 OMP 在第三种会话里读不读 skill 要上线时验证 |
+
+## 决定结果（Decision Outcome）
+
+选 **C**。分界线不是「提示词还是 skill」，是「第一句回复之前就得知道的」和「进了段才需要的」：前者是主人与 agent 的说话规矩，定下来基本不动，该常驻；后者是会被反复改的规程，放在便宜、能测、能回退的地方。
+
+不选 A：每场必读就是提示词，还多一个失败点。不选 B：路线要改得勤，PR 加 sync 太重，且没有 eval 可跑。
+
+接入顺序（每步可单独退）：
+
+1. 本仓建 `plugins/flow`，正文只装路线部分；在 Claude 侧 `name-only`（自动调用，按 ADR-0004）。
+2. agent-config 共用规则：删九段路线与「怎么开始、怎么结束」整节，换成分拣块（十来行）与一句「判为改动落地、或主人敲了段里的 skill，先读 `flow`」；「我在哪」表只留读写边界句。
+3. 上线待办里在 Codex、OMP 各开一个「issue N」会话，验证 agent 第一步读 `flow`；读不动就在 AGENTS.md 那一句里写死路径。
+
+### 后果（Consequences）
+
+- 好的：路线改一行只要合并 PR，投影是 junction，不用 sync；路线有 `claude plugin eval` 的对照组守着；要答案和小改动的会话不再背九段。
+- 坏的或要承担的：流程分在两个文件，改「三种来往」的判法仍要走 agent-config；第三种会话多一次读 skill 的动作，Codex 与 OMP 的可靠性要靠上线验证。
+- 回退：revert 引入本 ADR 的 PR，共用规则的路线段随 agent-config 侧的 revert 回来；`plugins/flow` 从 manifest 摘掉即可。
+
+### 确认（Confirmation）
+
+- 共用规则编译出的 CLAUDE.md／AGENTS.md 里没有段名和门，只有分拣块与读 `flow` 那一句。
+- `plugins/flow` 的评测：issue 开场的用例里出现读 `flow` 的动作；自由文本小改动的用例里没有。
+- 三个客户端各开一个「issue N」的会话，agent 的第一步都是读 `flow`。
+- 落地后回来补实际结果。
+
+## 更多信息（More Information）
+
+- desk#142（流程 skill 方案对齐，2026-09-16 grill 结论）；本仓镜像 issue #107；desk#140、#141。
+- ADR-0004（自建 skill 靠入口路由、按手动／自动调用分两档）。
+- `plugins/CONTEXT.md` 定义了「来往」「要答案」「小改动」「改动落地」。

docs/adr/README.md

@@ -30,3 +30,4 @@
 | [0002](./0002-公共面门禁扫最终tree并显式豁免.md) | 公共面门禁扫最终 git tree、allowlist 优先，既有违规逐条显式豁免 | accepted |
 | [0003](./0003-证据里的本机用户名换成占位符不改写历史.md) | 证据与记录里的本机用户名换成 `<user>` 占位，不改写 git 历史 | accepted |
 | [0004](./0004-自建skill靠入口路由并按手动自动调用分两档.md) | 自建 skill 靠入口路由、不靠描述触发，并按手动调用／自动调用分两档 | accepted |
+| [0005](./0005-来往判法常驻提示词路线放在流程skill.md) | 来往判法常驻提示词，路线放在流程 skill 里、判为改动落地才读 | accepted |

plugins/CONTEXT.md

@@ -4,6 +4,40 @@
 
 ## Language
 
+### 主人开口之后
+
+**来往**（interaction）:
+主人开口到拿回东西的一次往返。只有三种，按「要拿回什么」分；停下、交接、换机器不是第四种，是三种都能被打断。
+
+**要答案**（answer）:
+问、查、看，不动文件。
+
+**小改动**（small change）:
+只有一种改法、改完一眼能验的改动。直接做，贴证据，不进任何段。
+_Avoid_: 小修（旧规则里的说法）、快速修复
+
+**改动落地**（change delivery）:
+要在做法之间选，或改的是合同（规则、接口、路由、数据格式）的改动。走段，每段的门等主人说行，能从任一段进。九段的定义在流程 skill `flow` 的正文；为什么分九段见 wiki《vibeCoding 改动流转》。
+_Avoid_: 大改动（分的依据不是体量）、需求
+
+### 进了段之后
+
+**门**（gate）:
+一段结束时停下等主人说行的那一下。哪一段有门、门上判什么，写在流程 skill `flow` 的正文。
+
+**段**（segment）:
+改动落地被切成的九个阶段之一，每段有门和产物；顺序、门、产物在 `flow` 正文的九段表。
+
+**步**（step）:
+一段里被点名的一件事，由一条 skill 或一段手做承担。
+
+**可选步**（optional step）:
+只在改旧代码时才开的步（先录旧行为、先看影响这类）；开哪几步在第 4 段的门口定。
+
+**停靠记录**（docking record，自造）:
+一件事停下时写在它 issue 下的固定四栏评论（做成了、停在、下一步、等你），最后一条就是现状。
+_Avoid_: 交接记录（那是第 9 段 `/handoff` 的产物，给换机器或换人用）
+
 ### 决定走多长的路线
 
 **路由 skill**（router）:

plugins/README.md

@@ -33,7 +33,7 @@
 以下发布记录保留迁移前编号以便仓库维护者溯源；其中私有链接对公共协作者不可用，只是可选历史来源。当前行为、贡献要求和验收必须在本仓公开内容中自足表达。
 `adaptive-problem-solving` `0.2.14` 随 2026-09-01 负责人裁定的 bmad 整组退库清理引用：description 与方法登记面 INDEX 的「与装配内其他 Skill 的分界」表不再列 bmad-* 执行流程承载者（仅保留 `grilling`），失效条款同步；行为合同与方法卡内容不变。
 
-仓库目前包含十个可安装 Plugin：`self-improvement` `0.1.7`、`skill-maintenance` `0.1.1`、`knowledge-maintenance` `0.1.3`、`orchestrated-collaboration` `0.2.7`、`adaptive-problem-solving` `0.2.14`、`skill-appraisal` `0.2.0`、`clarify` `0.1.0`、`note` `0.1.0`、`workcoding` `0.1.0`（含 8 个规程 Skill）、`skill-authoring` `0.1.0`。Matt 的 25 个 promoted Skill 与 Superpowers 的 14 个 Skill 由 daily profile 从 `vendor/` 固定来源装配，不属于本仓 Plugin 目录。以 `docs/skills-overview.md`（自动生成）为准。
+仓库目前包含十一个可安装 Plugin：`self-improvement` `0.1.7`、`skill-maintenance` `0.1.1`、`knowledge-maintenance` `0.1.3`、`orchestrated-collaboration` `0.2.7`、`adaptive-problem-solving` `0.2.14`、`skill-appraisal` `0.2.0`、`clarify` `0.1.0`、`note` `0.1.0`、`workcoding` `0.1.0`（含 8 个规程 Skill）、`skill-authoring` `0.1.0`、`flow` `0.1.0`。Matt 的 25 个 promoted Skill 与 Superpowers 的 14 个 Skill 由 daily profile 从 `vendor/` 固定来源装配，不属于本仓 Plugin 目录。以 `docs/skills-overview.md`（自动生成）为准。
 
 **2026-09-02 负责人裁定退库两组**：`github-collaboration`（六个 Skill）与 `resource-observability`。理由见下方「已退库」。此前写进符合性门禁的「GitHub 协作 Plugin 必须作为可发布资产保留」一条同时作废，已从 `plugins/tests/workflow-routing.test.ts` 移除。
 

plugins/docs/skills-overview.md

@@ -4,12 +4,13 @@
 
 一个 skill 一个目录：`plugins/<plugin>/skills/<skill>/SKILL.md`，旁边可放 `evals/evals.json`；插件级 `evals/` 下的 `claude plugin eval` 用例也算有 evals。装配用 `sk`（源码 `packages/sk`；profile 的 manifest.json 是声明，junction 是投影）。
 
-共 18 个 Skill，10 个 Plugin。
+共 19 个 Skill，11 个 Plugin。
 
 | Skill | Plugin | 版本 | L2 字节 | evals | description |
 |---|---|---|---|---|---|
 | `adaptive-problem-solving` | adaptive-problem-solving | 0.2.14 | 9389 | 无 | 用于问题含糊、关键路径选择、波次／里程碑反思、高成本或难回退动作、范围／成本变化、停滞、恢复／交接／验收／长期收口，或检查方向、方法、ROI、模型、上下文、工具、环境与 Agent 组合。恢复原问题和主瓶颈，比较普通路径与方法后组合、换路或… |
 | `clarify` | clarify | 0.1.0 | 4241 | 有 | 主人冒出「想建 X／要不要搞一个／这个流程好烦」一类念头时，把「解」翻回「问题」，判断该不该做；只产出三行结论。不建则建一条 issue 写理由后以 wontfix 关闭，建则挂机会 issue。Turn an itch phrased a… |
+| `flow` | flow | 0.1.0 | 11057 | 有 | 判为改动落地、或主人开场直接敲了段里的 skill 时读：改动落地的路线——九段的门与产物、每段点名的步、可选步、会话绑定、停靠记录。The route for a change delivery: nine segments with t… |
 | `knowledge-maintenance` | knowledge-maintenance | 0.1.3 | 6488 | 无 | 用于多来源调研、可重复实验、会影响权威／Agent 配置／重要决定的研究，或用户要求复用、复核、更新当前知识时：先找已认可知识和失效条件，只补变化、冲突与缺口，再经价值门和可信门更新。不用于低成本一次性事实、原始材料／研发过程留存、私域结构… |
 | `note` | note | 0.1.0 | 2696 | 无 | 把成熟结论沉淀进本地 Markdown 知识库，或找回以前记过的结论。当用户说「沉淀到知识库」「记到 KB」「/note」「以前记过」「找回笔记」时使用。 |
 | `orchestrated-collaboration` | orchestrated-collaboration | 0.2.7 | 21795 | 无 | 当用户明确要求多 Agent／多 Session／跨 Provider 协作、任务已授权委派，或活动 Session 发生共享写入碰撞时，建立目标来源、排他所有权、可追踪交付、独立验收与综合；按共享资源和 Issue 子树确定唯一协调者，只… |

plugins/flow/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "flow",
+  "version": "0.1.0",
+  "description": "改动落地的路线：九段的门与产物、每段点名的步、可选步、会话绑定、停靠记录；判为改动落地时读。",
+  "author": {
+    "name": "Eridanus117"
+  },
+  "repository": "https://github.com/Eridanus117/agent-system",
+  "license": "MIT",
+  "skills": "./skills/"
+}