openfeel 1.1.6 → 1.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/README.en.md +13 -2
  2. package/README.md +10 -1
  3. package/README.zh-CN.md +13 -2
  4. package/dist/commands/config.d.ts.map +1 -1
  5. package/dist/commands/config.js +66 -4
  6. package/dist/commands/config.js.map +1 -1
  7. package/dist/commands/flow.d.ts +8 -0
  8. package/dist/commands/flow.d.ts.map +1 -1
  9. package/dist/commands/flow.js +169 -10
  10. package/dist/commands/flow.js.map +1 -1
  11. package/dist/commands/plan.d.ts.map +1 -1
  12. package/dist/commands/plan.js +59 -2
  13. package/dist/commands/plan.js.map +1 -1
  14. package/dist/commands/stage.d.ts.map +1 -1
  15. package/dist/commands/stage.js +56 -2
  16. package/dist/commands/stage.js.map +1 -1
  17. package/dist/core/config.d.ts +17 -2
  18. package/dist/core/config.d.ts.map +1 -1
  19. package/dist/core/config.js +21 -6
  20. package/dist/core/config.js.map +1 -1
  21. package/dist/core/flow-manager.d.ts +71 -14
  22. package/dist/core/flow-manager.d.ts.map +1 -1
  23. package/dist/core/flow-manager.js +266 -51
  24. package/dist/core/flow-manager.js.map +1 -1
  25. package/dist/core/i18n-data/en.d.ts.map +1 -1
  26. package/dist/core/i18n-data/en.js +25 -3
  27. package/dist/core/i18n-data/en.js.map +1 -1
  28. package/dist/core/i18n-data/zh-CN.d.ts.map +1 -1
  29. package/dist/core/i18n-data/zh-CN.js +26 -3
  30. package/dist/core/i18n-data/zh-CN.js.map +1 -1
  31. package/dist/core/pipeline-schema.d.ts +5 -0
  32. package/dist/core/pipeline-schema.d.ts.map +1 -1
  33. package/dist/core/pipeline-schema.js +5 -0
  34. package/dist/core/pipeline-schema.js.map +1 -1
  35. package/dist/core/plan/scheme.d.ts +22 -0
  36. package/dist/core/plan/scheme.d.ts.map +1 -1
  37. package/dist/core/plan/scheme.js +71 -2
  38. package/dist/core/plan/scheme.js.map +1 -1
  39. package/dist/core/plan/stage.d.ts +2 -0
  40. package/dist/core/plan/stage.d.ts.map +1 -1
  41. package/dist/core/plan/stage.js +8 -0
  42. package/dist/core/plan/stage.js.map +1 -1
  43. package/dist/core/template-loader.d.ts.map +1 -1
  44. package/dist/core/template-loader.js +353 -62
  45. package/dist/core/template-loader.js.map +1 -1
  46. package/dist/core/update.d.ts.map +1 -1
  47. package/dist/core/update.js +45 -12
  48. package/dist/core/update.js.map +1 -1
  49. package/package.json +1 -1
@@ -218,6 +218,21 @@ When a stage enters \`plan_passed\` and the project's \`auto_advance\` is set to
218
218
  3. **User declines**: Feel keeps \`auto_advance=disabled\` and requires user confirmation before each stage advance (manual execution mode).
219
219
  4. **No silent advancement**: When \`auto_advance=disabled\`, Feel must not advance the pipeline without asking the user.
220
220
 
221
+ #### Workflow Mode (workflow_mode)
222
+
223
+ Before dispatching, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`; when the field is absent, fall back per the cascade). Two modes:
224
+
225
+ - **full (complete flow)**: planner → plan_review (reviewer) → schemer → executor → reviewer → tester → archiver.
226
+ - **fast (Workflow Fast Line)**: planner (lightweight) → plan_review (**single mandatory plan review**) → executor → reviewer (single round) → archiver (lightweight); **does not dispatch openfeel-schemer / openfeel-feel-tester**.
227
+
228
+ Fast-mode discipline:
229
+
230
+ 1. **The quality floor cannot be skipped**: under fast the reviewer **runs twice** — ① \`plan_review\` plan review (**mandatory single round**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (single round); the \`review_failed\` loop allows re-review or returning to exec for fixes; failures are recorded as usual (REV entries unchanged).
231
+ 2. **Lightweight**: planner / archiver produce lightweight output (**must not** omit the task table / dependencies / acceptance points, or the state record / knowledge-staging decision).
232
+ 3. **Phase semantics**: under fast, reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`); the **legal phase enumeration remains at 15** (6 phases are unreachable under fast: \`scheme_*\` / \`test_*\`).
233
+ 4. **Full skeletons unchanged**: fast trims no on-disk structure; it only reduces agent relay steps.
234
+ 5. **Terminology disambiguation**: the flow mode is called the **Workflow Fast Line** (\`workflow_mode=fast\`); the review-depth downgrade is called **Fast Track (FAST-PASS)** — they are different mechanisms and must not be cross-referenced or conflated.
235
+
221
236
  ## Threshold for Small Changes vs. Large-Scale Planning
222
237
 
223
238
  Choose the appropriate process path based on the change scale:
@@ -285,7 +300,7 @@ A shared log entry (\`.openfeel/log/yyyy-mm-dd-feel-NNN.md\`) must be created wh
285
300
 
286
301
  ### Skeleton File Note
287
302
 
288
- During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory. Feel does not need to manually create log files; simply fill in the content when you see a skeleton file.
303
+ During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory (under the fast Workflow Fast Line, \`test_pending\` remains a legal phase but is unreachable (no inbound edge), so its skeleton is no longer produced; all other skeleton rules are unchanged). Feel does not need to manually create log files; simply fill in the content when you see a skeleton file.
289
304
 
290
305
  ### Log Entry Format
291
306
 
@@ -547,6 +562,15 @@ After archiving is complete, the stage's pipeline phase must be set to one of th
547
562
 
548
563
  > ⚠️ Note: After archiving is complete, the stage status must be set to \`"done"\`, **do not** use non-standard values like \`"completed"\`. \`"completed"\` does not exist in \`VALID_TRANSITIONS\`.
549
564
 
565
+ > **Under the fast Workflow Fast Line**: the 15-phase enumeration above is **unchanged** (reachable ≠ legal); reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`).
566
+
567
+ ## Workflow Mode Awareness (fast lightweight archiving)
568
+
569
+ Before archiving, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
570
+
571
+ - **full**: full archiving checklist (unchanged).
572
+ - **fast (Workflow Fast Line)**: **lightweight archiving** — the state record and the knowledge-staging decision (including the dedup lookup) **must not be omitted**; checklist process narrative may be merged and condensed. (Lightweight scope: keep the state record / knowledge-staging decision / kb index quick overview / manual update decision / shared log summary; summary process narrative may be merged into bullet points.)
573
+
550
574
  ## Model Selection
551
575
 
552
576
  openfeel-archiver is driven by a **reasoning model** (such as DeepSeek V4 Pro), responsible for understanding context and extracting valuable experience.
@@ -556,7 +580,7 @@ description: openfeel-executor Agent, fast model, implements code according to o
556
580
  mode: subagent
557
581
  model: deepseek/deepseek-flash
558
582
  reasoning_effort: medium
559
- color: "#D94A4A"
583
+ color: "#4CAF50"
560
584
  permission:
561
585
  bash: "allow"
562
586
  read: "allow"
@@ -622,9 +646,10 @@ Confirm that the following 6 required fields are present. If any is missing, ret
622
646
 
623
647
  ### Step 2: Phase Legitimacy Check
624
648
 
625
- 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid.
649
+ 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid. (under the fast Workflow Fast Line, reachable phases are the fast-line chain; the legal phase enumeration remains at 15 — reachable ≠ legal)
626
650
  2. Confirm \`pipeline.current.op\` matches the current op-id; refuse to execute if mismatched.
627
651
  3. When the current phase is not \`exec_running\`: if Feel explicitly instructs execution, it may proceed but must note the phase deviation; otherwise, refuse to execute.
652
+ 4. **Fast-mode phase paths**: \`plan_pending → plan_review → plan_passed → exec_running\` (the plan review is a mandatory single round; the step is entered only after it passes); the \`review_failed → exec_running\` loop (review failure returns to exec for fixes; the \`review_failed → review_pending\` re-review exit is retained).
628
653
 
629
654
  ### Step 3: FlowManager Transition Legitimacy Check
630
655
 
@@ -765,7 +790,7 @@ Delegable targets: openfeel-vision (analyze screenshots), openfeel-reviewer (pre
765
790
  description: openfeel-feel-tester Agent, reasoning model, responsible for formal testing and acceptance in the pipeline.
766
791
  mode: subagent
767
792
  reasoning_effort: medium
768
- color: "#E8A838"
793
+ color: "#22D3EE"
769
794
  permission:
770
795
  bash: "allow"
771
796
  read: "allow"
@@ -864,6 +889,7 @@ Write regression verification results into the Bug file's "Acceptance Record" ta
864
889
  - When issues are found, notify openfeel-schemer to formulate a revision
865
890
  - Re-test after fixes until passing
866
891
  - When tests pass, notify Feel to enter the archiving phase
892
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the formal test step is skipped per \`status.md\` "Workflow Mode"; the \`test_*\` phases are unreachable); the role definition is unchanged.
867
893
 
868
894
  ## Model Selection
869
895
 
@@ -978,6 +1004,13 @@ This step ensures openfeel-planner absorbs existing project knowledge before mak
978
1004
  - Does not directly code or execute tests
979
1005
  - openfeel-planner and openfeel-schemer responsibility boundary: openfeel-planner is responsible for "what" (what) and "when" (when), openfeel-schemer is responsible for "how" (how)
980
1006
 
1007
+ ## Workflow Mode Awareness (fast)
1008
+
1009
+ Before planning, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
1010
+
1011
+ - **full**: the output goes through openfeel-reviewer plan review (\`plan_review\`) before openfeel-schemer (unchanged).
1012
+ - **fast (Workflow Fast Line)**: **this agent's output must pass openfeel-reviewer's plan review (\`plan_review\`, single round; pass → \`plan_passed\`, issues returned → \`plan_pending\`; only then does it enter exec)**; produce a lightweight plan — the task table / dependencies / acceptance points **must not be omitted**; other process narrative may be trimmed. (Lightweight scope: keep goals / dependencies / task table / acceptance points / constraints / KB retrieval / change-point list / risks; background evidence details and revision history may be condensed.)
1013
+
981
1014
  ## Model Selection
982
1015
 
983
1016
  openfeel-planner is driven by a **reasoning model** (such as DeepSeek V4 Pro). In the Feel system design, openfeel-planner duties can be concurrently handled by Feel, but exist as an independent agent definition to support flexible scheduling strategies.
@@ -990,7 +1023,7 @@ description: openfeel-reviewer Agent, heterogenous reasoning model, responsible
990
1023
  mode: subagent
991
1024
  model: zhipuai/glm-5.3-flash
992
1025
  reasoning_effort: medium
993
- color: "#D4A017"
1026
+ color: "#EC4899"
994
1027
  permission:
995
1028
  bash: "allow"
996
1029
  read: "allow"
@@ -1057,6 +1090,15 @@ When **all three** of the following conditions are met, openfeel-reviewer enters
1057
1090
 
1058
1091
  If any condition is not met, skip fast track and execute full review process.
1059
1092
 
1093
+ ## Workflow Mode Awareness (fast single round)
1094
+
1095
+ Before reviewing, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
1096
+
1097
+ - **full**: plan review + code review (multiple points, unchanged).
1098
+ - **fast (Workflow Fast Line)**: **single round ×2, both mandatory** — ① \`plan_review\` **plan review (mandatory under fast**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (the \`review_failed\` loop allows re-review / returning to exec for fixes); the **quality floor is unchanged** (issues are still recorded and blockers still raised; REV entries as usual).
1099
+
1100
+ > **Terminology disambiguation**: the **Workflow Fast Line** (\`workflow_mode=fast\`, the flow mode) and **Fast Track (FAST-PASS)** (the review-depth downgrade mechanism defined in this template) are **different mechanisms** with similar names — do not cross-reference or conflate them.
1101
+
1060
1102
  ## REV Template Specification
1061
1103
 
1062
1104
  \`\`\`yaml
@@ -1098,7 +1140,7 @@ openfeel-reviewer must be driven by a **heterogenous reasoning model** (such as
1098
1140
  | Requires judgment (default blocking) | Serious coding convention violations / Cross-module consistency issues | \`true\` |
1099
1141
  | Non-blocking | Naming suggestions / Comment improvements / Style tweaks / Optimization suggestions | \`false\` |
1100
1142
 
1101
- > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities).
1143
+ > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities). This mechanism is unrelated to the Workflow Fast Line — see "Workflow Mode Awareness".
1102
1144
 
1103
1145
  ## blocking and Pipeline Behavior
1104
1146
 
@@ -1218,6 +1260,7 @@ When third-party dependencies are involved:
1218
1260
 
1219
1261
  - Receives dispatch from Feel to start, outputs are reviewed by openfeel-reviewer before being handed to openfeel-executor
1220
1262
  - When review fails, re-formulate the scheme based on openfeel-reviewer feedback
1263
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the scheme step is skipped per \`status.md\` "Workflow Mode"); the role definition is unchanged.
1221
1264
 
1222
1265
  ## Notes
1223
1266
 
@@ -1575,6 +1618,21 @@ Agent 模型需求对照:
1575
1618
  3. **用户拒绝**:Feel 保持 \`auto_advance=disabled\`,每次阶段推进前均需向用户确认(手动执行模式)。
1576
1619
  4. **禁止静默推进**:\`auto_advance=disabled\` 时禁止 Feel 不询问用户直接推进流水线。
1577
1620
 
1621
+ #### 工作流模式(workflow_mode)
1622
+
1623
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询:\`openfeel flow mode [--stage <id>]\`;字段缺失时按级联口径回落)。两种模式:
1624
+
1625
+ - **full(完整流程)**:planner → plan_review(reviewer)→ schemer → executor → reviewer → tester → archiver。
1626
+ - **fast(工作流快线)**:planner(轻量)→ plan_review(**计划审查单轮,必经**)→ executor → reviewer(单轮)→ archiver(轻量);**不派发 schemer / tester**。
1627
+
1628
+ fast 调度纪律:
1629
+
1630
+ 1. **质量底线不可跳**:reviewer 在 fast 下**必跑两处**——① \`plan_review\` 计划审查(**必经单轮**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(单轮);\`review_failed\` 回环可重审或回执行修复;失败留痕照常(REV 条目照常)。
1631
+ 2. **轻量化**:planner / archiver 轻量产出(**不得**省略任务表 / 依赖 / 验收要点与状态记录 / 知识暂存判定)。
1632
+ 3. **相位口径**:fast 下可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`);**合法相位枚举 15 项不变**(fast 下 6 项不可达:\`scheme_*\` / \`test_*\`)。
1633
+ 4. **骨架全量不变**:fast 不裁剪任何落盘结构,仅减少 Agent 接力环节。
1634
+ 5. **术语消歧**:流程模式称「**工作流快线**」(\`workflow_mode=fast\`);审查深度降级称「**快速通道 / fast track(FAST-PASS)**」——二者为不同机制,不得互相引用 / 混用。
1635
+
1578
1636
  ## 小改 vs 大规模规划的阈值
1579
1637
 
1580
1638
  根据变更规模选择适当的流程路径:
@@ -1642,7 +1700,7 @@ Agent 模型需求对照:
1642
1700
 
1643
1701
  ### 骨架文件提示
1644
1702
 
1645
- 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件。Feel 无需手动创建日志文件,看到骨架文件时填充内容即可。
1703
+ 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件(fast 工作流快线下 \`test_pending\` 仍为合法相位、仅不可达(无入边),该相位骨架不再产生;其余骨架规则全量不变)。Feel 无需手动创建日志文件,看到骨架文件时填充内容即可。
1646
1704
 
1647
1705
  ### 日志条目格式
1648
1706
 
@@ -1903,6 +1961,15 @@ openfeel-feel-tester 通过 → Feel 触发归档 → openfeel-archiver 整理
1903
1961
 
1904
1962
  > ⚠️ 注意:归档完成后的阶段状态必须设为 \`"done"\`,**不得**使用 \`"completed"\` 等非标准值。\`VALID_TRANSITIONS\` 中不存在 \`"completed"\`。
1905
1963
 
1964
+ > **fast 工作流快线下**:上表 15 项相位枚举**不变**(可达 ≠ 合法);可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`)。
1965
+
1966
+ ## 工作流模式感知(fast 轻量归档)
1967
+
1968
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
1969
+
1970
+ - **full**:归档全量清单(现状不变)。
1971
+ - **fast(工作流快线)**:**轻量归档**——状态记录与知识暂存判定(含去重检索)**不得省略**;清单过程性叙述可合并精简。(轻量口径:保留 状态记录 / 知识暂存判定 / 知识库快速概览 / 模块手册判定 / 公共日志摘要;总结过程性叙述可合并为要点。)
1972
+
1906
1973
  ## 模型选择
1907
1974
 
1908
1975
  openfeel-archiver 由**推理模型**(如 DeepSeek V4 Pro)驱动,负责理解上下文并提取有价值的经验。
@@ -1912,7 +1979,7 @@ description: openfeel-executor 执行官 Agent,快速模型,按操作方案
1912
1979
  mode: subagent
1913
1980
  model: deepseek/deepseek-flash
1914
1981
  reasoning_effort: medium
1915
- color: "#D94A4A"
1982
+ color: "#4CAF50"
1916
1983
  permission:
1917
1984
  bash: "allow"
1918
1985
  read: "allow"
@@ -1978,9 +2045,10 @@ permission:
1978
2045
 
1979
2046
  ### 步骤 2:Phase 合法性校验
1980
2047
 
1981
- 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。
2048
+ 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。(fast 工作流快线下可达相位为快线链;合法相位枚举 15 项不变——可达 ≠ 合法)
1982
2049
  2. 确认 \`pipeline.current.op\` 与当前 op-id 匹配,不匹配则拒绝执行。
1983
2050
  3. 当前 phase 不是 \`exec_running\` 时:若 Feel 已明确指示执行可继续但需注明 phase 偏差;否则拒绝执行。
2051
+ 4. **fast 工作流快线下相位路径**:\`plan_pending → plan_review → plan_passed → exec_running\`(计划审查为必经单轮:通过后进入本环节);\`review_failed → exec_running\` 回环(审查不通过时回执行修复;\`review_failed → review_pending\` 重审出口保留)。
1984
2052
 
1985
2053
  ### 步骤 3:FlowManager 流转合法性校验
1986
2054
 
@@ -2121,7 +2189,7 @@ openfeel-executor 由**快速模型**(如 DeepSeek V4 Flash)驱动,编码
2121
2189
  description: openfeel-feel-tester 测试官 Agent,推理模型驱动,负责流水线中的正式测试验收。
2122
2190
  mode: subagent
2123
2191
  reasoning_effort: medium
2124
- color: "#E8A838"
2192
+ color: "#22D3EE"
2125
2193
  permission:
2126
2194
  bash: "allow"
2127
2195
  read: "allow"
@@ -2220,6 +2288,7 @@ high 优先级 Bug 修复后,推荐执行全量测试套件。
2220
2288
  - 发现问题后通知 openfeel-schemer 制定修复方案
2221
2289
  - 修复后重新测试直到通过
2222
2290
  - 测试通过后通知 Feel 进入归档阶段
2291
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过正式测试环节,\`test_*\` 相位不可达);职责定义不变。
2223
2292
 
2224
2293
  ## 模型选择
2225
2294
 
@@ -2334,6 +2403,13 @@ openfeel-planner 作为独立子 Agent 由 Feel 按需唤起。Feel 根据规划
2334
2403
  - 不直接编码,不执行测试
2335
2404
  - openfeel-planner 与 openfeel-schemer 的职责边界:openfeel-planner 负责"做什么"(what)和"何时做"(when),openfeel-schemer 负责"怎么做"(how)
2336
2405
 
2406
+ ## 工作流模式感知(fast 快线)
2407
+
2408
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
2409
+
2410
+ - **full**:产出经 openfeel-reviewer 计划审查(\`plan_review\`)后进入 openfeel-schemer(现状不变)。
2411
+ - **fast(工作流快线)**:**本 Agent 产出后必经 openfeel-reviewer 的计划审查(\`plan_review\` 单轮;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`;此后进入 exec)**;产出为轻量计划——任务表 / 依赖声明 / 验收要点**不得省略**,其余过程性描述可精简。(轻量口径:保留 目标 / 依赖 / 任务表 / 验收要点 / 约束 / KB 检索 / 变更点清单 / 风险;背景实测证据明细与修订记录过程可收敛为结论。)
2412
+
2337
2413
  ## 模型选择
2338
2414
 
2339
2415
  openfeel-planner 由**推理模型**(如 DeepSeek V4 Pro)驱动。在 Feel 体系设计中,openfeel-planner 职责可由 Feel 兼任,但作为独立 Agent 定义存在以支持灵活的调度策略。
@@ -2346,7 +2422,7 @@ description: openfeel-reviewer 审查官 Agent,异种推理模型,负责交
2346
2422
  mode: subagent
2347
2423
  model: zhipuai/glm-5.3-flash
2348
2424
  reasoning_effort: medium
2349
- color: "#D4A017"
2425
+ color: "#EC4899"
2350
2426
  permission:
2351
2427
  bash: "allow"
2352
2428
  read: "allow"
@@ -2413,6 +2489,15 @@ permission:
2413
2489
 
2414
2490
  若任一条件不满足,跳过快速通道,执行完整审查流程。
2415
2491
 
2492
+ ## 工作流模式感知(fast 单轮)
2493
+
2494
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
2495
+
2496
+ - **full**:计划审查 + 代码审查(多轮位点,现状不变)。
2497
+ - **fast(工作流快线)**:**单轮 ×2,两处均必跑**——① \`plan_review\` **计划审查(fast 下必经**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(\`review_failed\` 回环可重审 / 回执行修复);**质量底线不变**(问题照记、阻断照留,REV 条目照常)。
2498
+
2499
+ > **术语消歧**:本节的「**工作流快线**」(\`workflow_mode=fast\`,流程模式)与本模板「**快速通道 / fast track(FAST-PASS)**」(审查深度降级机制)为**不同机制**、同名异义——不得互相引用 / 混用。
2500
+
2416
2501
  ## REV 模板规范
2417
2502
 
2418
2503
  \`\`\`yaml
@@ -2454,7 +2539,7 @@ openfeel-reviewer 必须由**异种推理模型**(如 GLM / Qwen)驱动,
2454
2539
  | 需判定(默认阻塞) | 编码规范严重违反 / 跨模块一致性问题 | \`true\` |
2455
2540
  | 非阻塞 | 命名建议 / 注释完善 / 风格微调 / 优化建议 | \`false\` |
2456
2541
 
2457
- > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。
2542
+ > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。该机制与「工作流快线」无关——见「工作流模式感知」节。
2458
2543
 
2459
2544
  ## blocking 与流水线行为
2460
2545
 
@@ -2574,6 +2659,7 @@ permission:
2574
2659
 
2575
2660
  - 接收 Feel 调度启动,产出方案经 openfeel-reviewer 审查后交 openfeel-executor 执行
2576
2661
  - 审查不通过时,根据 openfeel-reviewer 反馈重新制定方案
2662
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过方案环节);职责定义不变。
2577
2663
 
2578
2664
  ## 注意事项
2579
2665
 
@@ -2740,7 +2826,7 @@ Not all tasks must go through the full pipeline. Non-coding tasks and coding tas
2740
2826
  | Task Type | Handling Path | Notes |
2741
2827
  |-----------|---------------|-------|
2742
2828
  | Research/exploration (reading code, consulting references, locating issues) | Feel → research (general / explore Agent) | Read-only exploration, no source code changes; flow.json need not spin up for this |
2743
- | Coding implementation (adding/modifying source code) | Full pipeline (openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) | Involves source changes, must go through the full audit chain |
2829
+ | Coding implementation (adding/modifying source code) | Full pipeline (openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) (full); in fast mode: planner → plan review (reviewer, single mandatory round) → executor → code review (reviewer) → archiver (see status.md "Workflow Mode" / openfeel flow mode) | Involves source changes, must go through the full audit chain (fast-line audit chain in fast mode) |
2744
2830
  | Selection discussion (settling a technical approach / design trade-off) | Feel + \`question\` tool | Conversational decision, produces a conclusion, no plan.md |
2745
2831
 
2746
2832
  > Non-coding tasks (research, selection discussion) do not require creating a plan or advancing the pipeline; the pipeline is engaged only when source changes or a formal plan document is produced.
@@ -2803,7 +2889,7 @@ When encountering technical issues, **the first action MUST be to consult the kn
2803
2889
  - openfeel-utility Agent performs mechanical file operations, does not participate in design decisions
2804
2890
  - openfeel-archiver archives and distills knowledge, does not modify source code; does not write flow.json directly (written via Feel)
2805
2891
 
2806
- 3. **Feel orchestration constraint**: Feel, as the overall commander, uniformly orchestrates downstream Agents (openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / openfeel-utility Agent / openfeel-vision / openfeel-archiver), advancing serially via the \`task\` tool according to pipeline phases (plan → scheme → execute → review → test → archive). Each Agent operates only within its own responsibility boundary and must not start other Agents beyond its scope or modify flow.json state on its own.
2892
+ 3. **Feel orchestration constraint**: Feel, as the overall commander, uniformly orchestrates downstream Agents (openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / openfeel-utility Agent / openfeel-vision / openfeel-archiver), advancing serially via the \`task\` tool according to pipeline phases (plan → scheme → execute → review → test → archive) (full); in fast mode: plan → plan review → execute → code review → archive (see status.md "Workflow Mode" / openfeel flow mode). Each Agent operates only within its own responsibility boundary and must not start other Agents beyond its scope or modify flow.json state on its own.
2807
2893
 
2808
2894
  4. **Lightweight decision boundary**: Conversational selections (Feel and the user settle a technical direction or design trade-off via the \`question\` tool, producing a conclusion but no plan.md) are handled by Feel directly, without delegating to openfeel-planner; only when a **formal plan document** (plan.md, including stage division, task table, constraint table) is needed, or the planning scale threshold is reached, should openfeel-planner be delegated. Avoid the extremes of "handle everything personally" or "delegate everything".
2809
2895
 
@@ -2856,7 +2942,7 @@ Version progression must be prudent, using the four-level X.Y.Z.W version number
2856
2942
  | Level 4 (W) | Feature detail | Independently committed feature or submodule |
2857
2943
 
2858
2944
  When Feel starts a new version, it defaults to incrementing the fourth level (W+1), unless the user explicitly specifies otherwise.
2859
- The OpenFeel framework has released the official v1.0.x (currently v1.1.6). After deploying the global constraints via openfeel setup, new projects set their own starting version number as needed.
2945
+ The OpenFeel framework has released the official v1.0.x (currently v1.1.7). After deploying the global constraints via openfeel setup, new projects set their own starting version number as needed.
2860
2946
 
2861
2947
  ### Module Manuals
2862
2948
 
@@ -3249,7 +3335,7 @@ AI Agent 行为约束与编码规范。本文件为永久性约束,适用于
3249
3335
  | 任务类型 | 处理路径 | 说明 |
3250
3336
  |----------|----------|------|
3251
3337
  | 调研/探索(读代码、查资料、定位问题) | Feel → research(general / explore Agent) | 只读探索,不产出源码变更,flow.json 不必为此空转 |
3252
- | 编码实现(新增/修改源码) | 完整流水线(openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) | 有源码变更,须走完整审计链 |
3338
+ | 编码实现(新增/修改源码) | 完整流水线(openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester)(full);fast 工作流快线(workflow_mode=fast)下为 planner → 计划审查(reviewer,单轮必经)→ executor → 代码审查(reviewer)→ archiver——见 status.md「工作流模式」 / openfeel flow mode | 有源码变更,须走完整审计链(fast 走快线审计链) |
3253
3339
  | 选型讨论(敲定技术方案/设计取舍) | Feel + \`question\` 工具 | 对话式决策,产出结论,不产出 plan.md |
3254
3340
 
3255
3341
  > 非编码任务(调研、选型讨论)不强制创建计划或推进流水线;仅当产生源码变更或正式计划文档时才接入流水线。
@@ -3312,7 +3398,7 @@ AI Agent 行为约束与编码规范。本文件为永久性约束,适用于
3312
3398
  - 事务官 执行文件机械操作,不参与设计决策
3313
3399
  - openfeel-archiver 归档和沉淀知识,不修改源码;不直写 flow.json(通过 Feel 写入)
3314
3400
 
3315
- 3. **Feel 调度约束**:Feel 总统领统一调度下游 Agent(openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / 事务官 / openfeel-vision / openfeel-archiver),通过 \`task\` 工具按流水线阶段(计划→方案→执行→审查→测试→归档)串行推进。各 Agent 仅在自己的职责边界内操作,不得越界启动其他 Agent 或自行修改 flow.json 状态。
3401
+ 3. **Feel 调度约束**:Feel 总统领统一调度下游 Agent(openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / 事务官 / openfeel-vision / openfeel-archiver),通过 \`task\` 工具按流水线阶段(计划→方案→执行→审查→测试→归档)串行推进(full);fast 工作流快线下为 计划 → 计划审查 → 执行 → 代码审查 → 归档(见 status.md「工作流模式」 / openfeel flow mode)。各 Agent 仅在自己的职责边界内操作,不得越界启动其他 Agent 或自行修改 flow.json 状态。
3316
3402
 
3317
3403
  4. **轻量决策边界**:对话式选型(Feel 与用户通过 \`question\` 工具敲定技术方向/设计取舍,产出结论不产出 plan.md)由 Feel 直接处理,不委托 openfeel-planner;仅当需要**产出正式计划文档**(plan.md,含阶段划分、任务表、约束表)或达到规划规模阈值时,才委托 openfeel-planner。避免"要么全亲为、要么全委托"的极端。
3318
3404
 
@@ -3365,7 +3451,7 @@ AI Agent 行为约束与编码规范。本文件为永久性约束,适用于
3365
3451
  | 四级(W) | 功能细节 | 独立提交的功能或子模块 |
3366
3452
 
3367
3453
  Feel 启动新版本时默认使用四级版本递增(W+1),除非用户明确指定。
3368
- OpenFeel 框架已发布正式版 v1.0.x(当前 v1.1.6)。新项目经 openfeel setup 部署全局约束后,按自身需求设定起始版本号。
3454
+ OpenFeel 框架已发布正式版 v1.0.x(当前 v1.1.7)。新项目经 openfeel setup 部署全局约束后,按自身需求设定起始版本号。
3369
3455
 
3370
3456
  ### 模块手册
3371
3457
 
@@ -3986,6 +4072,21 @@ When a stage enters \`plan_passed\` and the project's \`auto_advance\` is set to
3986
4072
  3. **User declines**: Feel keeps \`auto_advance=disabled\` and requires user confirmation before each stage advance (manual execution mode).
3987
4073
  4. **No silent advancement**: When \`auto_advance=disabled\`, Feel must not advance the pipeline without asking the user.
3988
4074
 
4075
+ #### Workflow Mode (workflow_mode)
4076
+
4077
+ Before dispatching, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`; when the field is absent, fall back per the cascade). Two modes:
4078
+
4079
+ - **full (complete flow)**: planner → plan_review (reviewer) → schemer → executor → reviewer → tester → archiver.
4080
+ - **fast (Workflow Fast Line)**: planner (lightweight) → plan_review (**single mandatory plan review**) → executor → reviewer (single round) → archiver (lightweight); **does not dispatch openfeel-schemer / openfeel-feel-tester**.
4081
+
4082
+ Fast-mode discipline:
4083
+
4084
+ 1. **The quality floor cannot be skipped**: under fast the reviewer **runs twice** — ① \`plan_review\` plan review (**mandatory single round**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (single round); the \`review_failed\` loop allows re-review or returning to exec for fixes; failures are recorded as usual (REV entries unchanged).
4085
+ 2. **Lightweight**: planner / archiver produce lightweight output (**must not** omit the task table / dependencies / acceptance points, or the state record / knowledge-staging decision).
4086
+ 3. **Phase semantics**: under fast, reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`); the **legal phase enumeration remains at 15** (6 phases are unreachable under fast: \`scheme_*\` / \`test_*\`).
4087
+ 4. **Full skeletons unchanged**: fast trims no on-disk structure; it only reduces agent relay steps.
4088
+ 5. **Terminology disambiguation**: the flow mode is called the **Workflow Fast Line** (\`workflow_mode=fast\`); the review-depth downgrade is called **Fast Track (FAST-PASS)** — they are different mechanisms and must not be cross-referenced or conflated.
4089
+
3989
4090
  ## Threshold for Small Changes vs. Large-Scale Planning
3990
4091
 
3991
4092
  Choose the appropriate process path based on the change scale:
@@ -4053,7 +4154,7 @@ A shared log entry (\`.openfeel/log/yyyy-mm-dd-feel-NNN.md\`) must be created wh
4053
4154
 
4054
4155
  ### Skeleton File Note
4055
4156
 
4056
- During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory. Feel does not need to manually create log files; simply fill in the content when you see a skeleton file.
4157
+ During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory (under the fast Workflow Fast Line, \`test_pending\` remains a legal phase but is unreachable (no inbound edge), so its skeleton is no longer produced; all other skeleton rules are unchanged). Feel does not need to manually create log files; simply fill in the content when you see a skeleton file.
4057
4158
 
4058
4159
  ### Log Entry Format
4059
4160
 
@@ -4315,6 +4416,15 @@ After archiving is complete, the stage's pipeline phase must be set to one of th
4315
4416
 
4316
4417
  > ⚠️ Note: After archiving is complete, the stage status must be set to \`"done"\`, **do not** use non-standard values like \`"completed"\`. \`"completed"\` does not exist in \`VALID_TRANSITIONS\`.
4317
4418
 
4419
+ > **Under the fast Workflow Fast Line**: the 15-phase enumeration above is **unchanged** (reachable ≠ legal); reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`).
4420
+
4421
+ ## Workflow Mode Awareness (fast lightweight archiving)
4422
+
4423
+ Before archiving, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
4424
+
4425
+ - **full**: full archiving checklist (unchanged).
4426
+ - **fast (Workflow Fast Line)**: **lightweight archiving** — the state record and the knowledge-staging decision (including the dedup lookup) **must not be omitted**; checklist process narrative may be merged and condensed. (Lightweight scope: keep the state record / knowledge-staging decision / kb index quick overview / manual update decision / shared log summary; summary process narrative may be merged into bullet points.)
4427
+
4318
4428
  ## Model Selection
4319
4429
 
4320
4430
  openfeel-archiver is driven by a **reasoning model** (such as DeepSeek V4 Pro), responsible for understanding context and extracting valuable experience.
@@ -4324,7 +4434,7 @@ description: openfeel-executor Agent, fast model, implements code according to o
4324
4434
  mode: subagent
4325
4435
  model: deepseek/deepseek-flash
4326
4436
  reasoning_effort: medium
4327
- color: "#D94A4A"
4437
+ color: "#4CAF50"
4328
4438
  permission:
4329
4439
  bash: "allow"
4330
4440
  read: "allow"
@@ -4390,9 +4500,10 @@ Confirm that the following 6 required fields are present. If any is missing, ret
4390
4500
 
4391
4501
  ### Step 2: Phase Legitimacy Check
4392
4502
 
4393
- 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid.
4503
+ 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid. (under the fast Workflow Fast Line, reachable phases are the fast-line chain; the legal phase enumeration remains at 15 — reachable ≠ legal)
4394
4504
  2. Confirm \`pipeline.current.op\` matches the current op-id; refuse to execute if mismatched.
4395
4505
  3. When the current phase is not \`exec_running\`: if Feel explicitly instructs execution, it may proceed but must note the phase deviation; otherwise, refuse to execute.
4506
+ 4. **Fast-mode phase paths**: \`plan_pending → plan_review → plan_passed → exec_running\` (the plan review is a mandatory single round; the step is entered only after it passes); the \`review_failed → exec_running\` loop (review failure returns to exec for fixes; the \`review_failed → review_pending\` re-review exit is retained).
4396
4507
 
4397
4508
  ### Step 3: FlowManager Transition Legitimacy Check
4398
4509
 
@@ -4533,7 +4644,7 @@ Delegable targets: openfeel-vision (analyze screenshots), openfeel-reviewer (pre
4533
4644
  description: openfeel-feel-tester Agent, reasoning model, responsible for formal testing and acceptance in the pipeline.
4534
4645
  mode: subagent
4535
4646
  reasoning_effort: medium
4536
- color: "#E8A838"
4647
+ color: "#22D3EE"
4537
4648
  permission:
4538
4649
  bash: "allow"
4539
4650
  read: "allow"
@@ -4632,6 +4743,7 @@ Write regression verification results into the Bug file's "Acceptance Record" ta
4632
4743
  - When issues are found, notify openfeel-schemer to formulate a revision
4633
4744
  - Re-test after fixes until passing
4634
4745
  - When tests pass, notify Feel to enter the archiving phase
4746
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the formal test step is skipped per \`status.md\` "Workflow Mode"; the \`test_*\` phases are unreachable); the role definition is unchanged.
4635
4747
 
4636
4748
  ## Model Selection
4637
4749
 
@@ -4746,6 +4858,13 @@ This step ensures openfeel-planner absorbs existing project knowledge before mak
4746
4858
  - Does not directly code or execute tests
4747
4859
  - openfeel-planner and openfeel-schemer responsibility boundary: openfeel-planner is responsible for "what" (what) and "when" (when), openfeel-schemer is responsible for "how" (how)
4748
4860
 
4861
+ ## Workflow Mode Awareness (fast)
4862
+
4863
+ Before planning, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
4864
+
4865
+ - **full**: the output goes through openfeel-reviewer plan review (\`plan_review\`) before openfeel-schemer (unchanged).
4866
+ - **fast (Workflow Fast Line)**: **this agent's output must pass openfeel-reviewer's plan review (\`plan_review\`, single round; pass → \`plan_passed\`, issues returned → \`plan_pending\`; only then does it enter exec)**; produce a lightweight plan — the task table / dependencies / acceptance points **must not be omitted**; other process narrative may be trimmed. (Lightweight scope: keep goals / dependencies / task table / acceptance points / constraints / KB retrieval / change-point list / risks; background evidence details and revision history may be condensed.)
4867
+
4749
4868
  ## Model Selection
4750
4869
 
4751
4870
  openfeel-planner is driven by a **reasoning model** (such as DeepSeek V4 Pro). In the Feel system design, openfeel-planner duties can be concurrently handled by Feel, but exist as an independent agent definition to support flexible scheduling strategies.
@@ -4758,7 +4877,7 @@ description: openfeel-reviewer Agent, heterogenous reasoning model, responsible
4758
4877
  mode: subagent
4759
4878
  model: zhipuai/glm-5.3-flash
4760
4879
  reasoning_effort: medium
4761
- color: "#D4A017"
4880
+ color: "#EC4899"
4762
4881
  permission:
4763
4882
  bash: "allow"
4764
4883
  read: "allow"
@@ -4825,6 +4944,15 @@ When **all three** of the following conditions are met, openfeel-reviewer enters
4825
4944
 
4826
4945
  If any condition is not met, skip fast track and execute full review process.
4827
4946
 
4947
+ ## Workflow Mode Awareness (fast single round)
4948
+
4949
+ Before reviewing, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
4950
+
4951
+ - **full**: plan review + code review (multiple points, unchanged).
4952
+ - **fast (Workflow Fast Line)**: **single round ×2, both mandatory** — ① \`plan_review\` **plan review (mandatory under fast**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (the \`review_failed\` loop allows re-review / returning to exec for fixes); the **quality floor is unchanged** (issues are still recorded and blockers still raised; REV entries as usual).
4953
+
4954
+ > **Terminology disambiguation**: the **Workflow Fast Line** (\`workflow_mode=fast\`, the flow mode) and **Fast Track (FAST-PASS)** (the review-depth downgrade mechanism defined in this template) are **different mechanisms** with similar names — do not cross-reference or conflate them.
4955
+
4828
4956
  ## REV Template Specification
4829
4957
 
4830
4958
  \`\`\`yaml
@@ -4866,7 +4994,7 @@ openfeel-reviewer must be driven by a **heterogenous reasoning model** (such as
4866
4994
  | Requires judgment (default blocking) | Serious coding convention violations / Cross-module consistency issues | \`true\` |
4867
4995
  | Non-blocking | Naming suggestions / Comment improvements / Style tweaks / Optimization suggestions | \`false\` |
4868
4996
 
4869
- > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities).
4997
+ > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities). This mechanism is unrelated to the Workflow Fast Line — see "Workflow Mode Awareness".
4870
4998
 
4871
4999
  ## blocking and Pipeline Behavior
4872
5000
 
@@ -4986,6 +5114,7 @@ When third-party dependencies are involved:
4986
5114
 
4987
5115
  - Receives dispatch from Feel to start, outputs are reviewed by openfeel-reviewer before being handed to openfeel-executor
4988
5116
  - When review fails, re-formulate the scheme based on openfeel-reviewer feedback
5117
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the scheme step is skipped per \`status.md\` "Workflow Mode"); the role definition is unchanged.
4989
5118
 
4990
5119
  ## Notes
4991
5120
 
@@ -5343,6 +5472,21 @@ Agent 模型需求对照:
5343
5472
  3. **用户拒绝**:Feel 保持 \`auto_advance=disabled\`,每次阶段推进前均需向用户确认(手动执行模式)。
5344
5473
  4. **禁止静默推进**:\`auto_advance=disabled\` 时禁止 Feel 不询问用户直接推进流水线。
5345
5474
 
5475
+ #### 工作流模式(workflow_mode)
5476
+
5477
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询:\`openfeel flow mode [--stage <id>]\`;字段缺失时按级联口径回落)。两种模式:
5478
+
5479
+ - **full(完整流程)**:planner → plan_review(reviewer)→ schemer → executor → reviewer → tester → archiver。
5480
+ - **fast(工作流快线)**:planner(轻量)→ plan_review(**计划审查单轮,必经**)→ executor → reviewer(单轮)→ archiver(轻量);**不派发 schemer / tester**。
5481
+
5482
+ fast 调度纪律:
5483
+
5484
+ 1. **质量底线不可跳**:reviewer 在 fast 下**必跑两处**——① \`plan_review\` 计划审查(**必经单轮**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(单轮);\`review_failed\` 回环可重审或回执行修复;失败留痕照常(REV 条目照常)。
5485
+ 2. **轻量化**:planner / archiver 轻量产出(**不得**省略任务表 / 依赖 / 验收要点与状态记录 / 知识暂存判定)。
5486
+ 3. **相位口径**:fast 下可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`);**合法相位枚举 15 项不变**(fast 下 6 项不可达:\`scheme_*\` / \`test_*\`)。
5487
+ 4. **骨架全量不变**:fast 不裁剪任何落盘结构,仅减少 Agent 接力环节。
5488
+ 5. **术语消歧**:流程模式称「**工作流快线**」(\`workflow_mode=fast\`);审查深度降级称「**快速通道 / fast track(FAST-PASS)**」——二者为不同机制,不得互相引用 / 混用。
5489
+
5346
5490
  ## 小改 vs 大规模规划的阈值
5347
5491
 
5348
5492
  根据变更规模选择适当的流程路径:
@@ -5410,7 +5554,7 @@ Agent 模型需求对照:
5410
5554
 
5411
5555
  ### 骨架文件提示
5412
5556
 
5413
- 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件。Feel 无需手动创建日志文件,看到骨架文件时填充内容即可。
5557
+ 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件(fast 工作流快线下 \`test_pending\` 仍为合法相位、仅不可达(无入边),该相位骨架不再产生;其余骨架规则全量不变)。Feel 无需手动创建日志文件,看到骨架文件时填充内容即可。
5414
5558
 
5415
5559
  ### 日志条目格式
5416
5560
 
@@ -5671,6 +5815,15 @@ openfeel-feel-tester 通过 → Feel 触发归档 → openfeel-archiver 整理
5671
5815
 
5672
5816
  > ⚠️ 注意:归档完成后的阶段状态必须设为 \`"done"\`,**不得**使用 \`"completed"\` 等非标准值。\`VALID_TRANSITIONS\` 中不存在 \`"completed"\`。
5673
5817
 
5818
+ > **fast 工作流快线下**:上表 15 项相位枚举**不变**(可达 ≠ 合法);可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`)。
5819
+
5820
+ ## 工作流模式感知(fast 轻量归档)
5821
+
5822
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
5823
+
5824
+ - **full**:归档全量清单(现状不变)。
5825
+ - **fast(工作流快线)**:**轻量归档**——状态记录与知识暂存判定(含去重检索)**不得省略**;清单过程性叙述可合并精简。(轻量口径:保留 状态记录 / 知识暂存判定 / 知识库快速概览 / 模块手册判定 / 公共日志摘要;总结过程性叙述可合并为要点。)
5826
+
5674
5827
  ## 模型选择
5675
5828
 
5676
5829
  openfeel-archiver 由**推理模型**(如 DeepSeek V4 Pro)驱动,负责理解上下文并提取有价值的经验。
@@ -5680,7 +5833,7 @@ description: openfeel-executor 执行官 Agent,快速模型,按操作方案
5680
5833
  mode: subagent
5681
5834
  model: deepseek/deepseek-flash
5682
5835
  reasoning_effort: medium
5683
- color: "#D94A4A"
5836
+ color: "#4CAF50"
5684
5837
  permission:
5685
5838
  bash: "allow"
5686
5839
  read: "allow"
@@ -5746,9 +5899,10 @@ permission:
5746
5899
 
5747
5900
  ### 步骤 2:Phase 合法性校验
5748
5901
 
5749
- 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。
5902
+ 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。(fast 工作流快线下可达相位为快线链;合法相位枚举 15 项不变——可达 ≠ 合法)
5750
5903
  2. 确认 \`pipeline.current.op\` 与当前 op-id 匹配,不匹配则拒绝执行。
5751
5904
  3. 当前 phase 不是 \`exec_running\` 时:若 Feel 已明确指示执行可继续但需注明 phase 偏差;否则拒绝执行。
5905
+ 4. **fast 工作流快线下相位路径**:\`plan_pending → plan_review → plan_passed → exec_running\`(计划审查为必经单轮:通过后进入本环节);\`review_failed → exec_running\` 回环(审查不通过时回执行修复;\`review_failed → review_pending\` 重审出口保留)。
5752
5906
 
5753
5907
  ### 步骤 3:FlowManager 流转合法性校验
5754
5908
 
@@ -5889,7 +6043,7 @@ openfeel-executor 由**快速模型**(如 DeepSeek V4 Flash)驱动,编码
5889
6043
  description: openfeel-feel-tester 测试官 Agent,推理模型驱动,负责流水线中的正式测试验收。
5890
6044
  mode: subagent
5891
6045
  reasoning_effort: medium
5892
- color: "#E8A838"
6046
+ color: "#22D3EE"
5893
6047
  permission:
5894
6048
  bash: "allow"
5895
6049
  read: "allow"
@@ -5988,6 +6142,7 @@ high 优先级 Bug 修复后,推荐执行全量测试套件。
5988
6142
  - 发现问题后通知 openfeel-schemer 制定修复方案
5989
6143
  - 修复后重新测试直到通过
5990
6144
  - 测试通过后通知 Feel 进入归档阶段
6145
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过正式测试环节,\`test_*\` 相位不可达);职责定义不变。
5991
6146
 
5992
6147
  ## 模型选择
5993
6148
 
@@ -6102,6 +6257,13 @@ openfeel-planner 作为独立子 Agent 由 Feel 按需唤起。Feel 根据规划
6102
6257
  - 不直接编码,不执行测试
6103
6258
  - openfeel-planner 与 openfeel-schemer 的职责边界:openfeel-planner 负责"做什么"(what)和"何时做"(when),openfeel-schemer 负责"怎么做"(how)
6104
6259
 
6260
+ ## 工作流模式感知(fast 快线)
6261
+
6262
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
6263
+
6264
+ - **full**:产出经 openfeel-reviewer 计划审查(\`plan_review\`)后进入 openfeel-schemer(现状不变)。
6265
+ - **fast(工作流快线)**:**本 Agent 产出后必经 openfeel-reviewer 的计划审查(\`plan_review\` 单轮;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`;此后进入 exec)**;产出为轻量计划——任务表 / 依赖声明 / 验收要点**不得省略**,其余过程性描述可精简。(轻量口径:保留 目标 / 依赖 / 任务表 / 验收要点 / 约束 / KB 检索 / 变更点清单 / 风险;背景实测证据明细与修订记录过程可收敛为结论。)
6266
+
6105
6267
  ## 模型选择
6106
6268
 
6107
6269
  openfeel-planner 由**推理模型**(如 DeepSeek V4 Pro)驱动。在 Feel 体系设计中,openfeel-planner 职责可由 Feel 兼任,但作为独立 Agent 定义存在以支持灵活的调度策略。
@@ -6114,7 +6276,7 @@ description: openfeel-reviewer 审查官 Agent,异种推理模型,负责交
6114
6276
  mode: subagent
6115
6277
  model: zhipuai/glm-5.3-flash
6116
6278
  reasoning_effort: medium
6117
- color: "#D4A017"
6279
+ color: "#EC4899"
6118
6280
  permission:
6119
6281
  bash: "allow"
6120
6282
  read: "allow"
@@ -6181,6 +6343,15 @@ permission:
6181
6343
 
6182
6344
  若任一条件不满足,跳过快速通道,执行完整审查流程。
6183
6345
 
6346
+ ## 工作流模式感知(fast 单轮)
6347
+
6348
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
6349
+
6350
+ - **full**:计划审查 + 代码审查(多轮位点,现状不变)。
6351
+ - **fast(工作流快线)**:**单轮 ×2,两处均必跑**——① \`plan_review\` **计划审查(fast 下必经**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(\`review_failed\` 回环可重审 / 回执行修复);**质量底线不变**(问题照记、阻断照留,REV 条目照常)。
6352
+
6353
+ > **术语消歧**:本节的「**工作流快线**」(\`workflow_mode=fast\`,流程模式)与本模板「**快速通道 / fast track(FAST-PASS)**」(审查深度降级机制)为**不同机制**、同名异义——不得互相引用 / 混用。
6354
+
6184
6355
  ## REV 模板规范
6185
6356
 
6186
6357
  \`\`\`yaml
@@ -6222,7 +6393,7 @@ openfeel-reviewer 必须由**异种推理模型**(如 GLM / Qwen)驱动,
6222
6393
  | 需判定(默认阻塞) | 编码规范严重违反 / 跨模块一致性问题 | \`true\` |
6223
6394
  | 非阻塞 | 命名建议 / 注释完善 / 风格微调 / 优化建议 | \`false\` |
6224
6395
 
6225
- > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。
6396
+ > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。该机制与「工作流快线」无关——见「工作流模式感知」节。
6226
6397
 
6227
6398
  ## blocking 与流水线行为
6228
6399
 
@@ -6342,6 +6513,7 @@ permission:
6342
6513
 
6343
6514
  - 接收 Feel 调度启动,产出方案经 openfeel-reviewer 审查后交 openfeel-executor 执行
6344
6515
  - 审查不通过时,根据 openfeel-reviewer 反馈重新制定方案
6516
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过方案环节);职责定义不变。
6345
6517
 
6346
6518
  ## 注意事项
6347
6519
 
@@ -6784,7 +6956,7 @@ Skill 加载后,根据步骤 3 的匹配结果决定是否追加提示:
6784
6956
  `,
6785
6957
  'openfeel-cli-usage': `---
6786
6958
  name: openfeel-cli-usage
6787
- description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15 个 phase 枚举与转移表、stageId 命名与目录映射约定、v1.1.2 新增能力(自描述/可纠错、--json 结构化输出、health --fix、scheme draft、knowledge dedup、纠正清理侧命令面)、v1.1.4 新增能力(checkpoint 选择性恢复 --stage/--dry-run、flow stage reset 精准复位、故障恢复路径)、v1.1.5 新增能力(setup --check [--json] 诊断 / 被动部署提示)、v1.1.6 新增能力(Claude Code 适配器 \`--tools claude\` / settings 注入)。当需要查询 CLI 命令、参数、phase、stageId、阶段命名时加载。
6959
+ description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15 个 phase 枚举与转移表、stageId 命名与目录映射约定、v1.1.2 新增能力(自描述/可纠错、--json 结构化输出、health --fix、scheme draft、knowledge dedup、纠正清理侧命令面)、v1.1.4 新增能力(checkpoint 选择性恢复 --stage/--dry-run、flow stage reset 精准复位、故障恢复路径)、v1.1.5 新增能力(setup --check [--json] 诊断 / 被动部署提示)、v1.1.6 新增能力(Claude Code 适配器 \`--tools claude\` / settings 注入)、v1.1.7 新增能力(双模式工作流 workflow_mode:flow mode 只读查询 / flow phases --mode 模式分节 / plan stage add --workflow-mode / stage set --workflow-mode / config set --sync-stages --stage)。当需要查询 CLI 命令、参数、phase、stageId、阶段命名时加载。
6788
6960
  ---
6789
6961
 
6790
6962
  # OpenFeel CLI 用法参考
@@ -6796,7 +6968,7 @@ description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15
6796
6968
  - 与 \`openfeel-tool-usage\` 协同:工具选择规范见该 skill;本 skill 补充 CLI 命令细节。
6797
6969
  - 正文以**能力名**叙述;平台差异见 \`### opencode 适配器\` / \`### Claude Code 适配器\` 两小节。
6798
6970
 
6799
- > 本文档为 v1.1.6 快照;命令/参数细节以 \`openfeel <cmd> --help\`(本仓执行)实时输出为准(CLI 演进后本文档可能滞后)。
6971
+ > 本文档为 v1.1.7 快照;命令/参数细节以 \`openfeel <cmd> --help\`(本仓执行)实时输出为准(CLI 演进后本文档可能滞后)。
6800
6972
  >
6801
6973
  > ⚠️ **本仓自举**:本仓(openfeel 源码仓库)开发/执行时请用 \`node bin/openfeel.js <cmd>\`;安装后使用 \`openfeel <cmd>\`。
6802
6974
 
@@ -6811,10 +6983,10 @@ description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15
6811
6983
  | \`openfeel flow ...\` | 流水线状态管理 | 见下「flow 子命令」 |
6812
6984
  | \`openfeel flow checkpoint restore\` | Checkpoint 恢复(全量 / 选择性 / 预览) | \`<file> [--force] [--stage <id>] [--dry-run]\`(无 \`--stage\`=全量覆盖,最后手段;\`--stage\`=按阶段回退;\`--dry-run\`=零写盘预览) |
6813
6985
  | \`openfeel flow stage reset\` | 精准复位阶段 phase(\`flow advance\` 的对称复位,允许回退) | \`<stageId> --to <phase> [--dry-run]\`(受合法值域 + \`to=done\` 阻塞 REV 约束) |
6814
- | \`openfeel plan stage add\\|list\` | 工作阶段管理 | \`add <name> --deps <ids...> --tasks <items...> --exec-mode <manual\\|auto> --auto-advance <enabled\\|disabled>\`(初值取 \`config.yaml.defaults\`;显式选项优先) |
6986
+ | \`openfeel plan stage add\\|list\` | 工作阶段管理 | \`add <name> --deps <ids...> --tasks <items...> --exec-mode <manual\\|auto> --auto-advance <enabled\\|disabled> --workflow-mode <full\\|fast>\`(初值取 \`config.yaml.defaults\`;显式选项优先;\`--workflow-mode\` 覆盖 config 默认) |
6815
6987
  | \`openfeel plan scheme create\\|publish\\|rename\\|list\\|remove\\|register\` | 操作方案管理 | \`create <stage> <title> [--draft]\`、\`publish <stage> <opId>\`、\`rename <stage> <opId> --title <text>\`、\`remove <stage> <opId> [--force] [--dry-run]\`、\`register <stage> [opId] [--dry-run]\`(补注册 fileOrphans) |
6816
- | \`openfeel stage status\\|set\\|task\` | \`status.md\` 原子操作 | \`set <id> --status/--exec-mode/--auto-advance/--review-agent\`、\`task <id> [no] --add/--done/--undone\`(\`stage create\` 已弃用) |
6817
- | \`openfeel config ...\` | 配置管理 | \`get\\|set <key> <value> [--global]\`(支持全量 \`defaults.*\`,且 \`defaults.X ≡ X\`)、\`set ... --sync-stages\`(批量写入所有已注册阶段 \`status.md\` 的 \`自动推进\`/\`执行模式\`)、\`get-lang\\|set-lang\`、\`list-projects\`、\`effective [key]\` |
6988
+ | \`openfeel stage status\\|set\\|task\` | \`status.md\` 原子操作 | \`set <id> --status/--exec-mode/--auto-advance/--review-agent/--workflow-mode\`、\`task <id> [no] --add/--done/--undone\`(\`stage create\` 已弃用) |
6989
+ | \`openfeel config ...\` | 配置管理 | \`get\\|set <key> <value> [--global]\`(支持全量 \`defaults.*\`,且 \`defaults.X ≡ X\`)、\`set ... --sync-stages [--stage <ids...>]\`(批量写入已注册阶段 \`status.md\` 的 \`自动推进\`/\`执行模式\`/\`工作流模式\`;\`--stage\` 限定作用域,单独使用 / 与 \`--global\` 组合 → exit 1)、\`get-lang\\|set-lang\`、\`list-projects\`、\`effective [key]\` |
6818
6990
  | \`openfeel model set\\|get\\|list\` | 模型三层级配置 | \`set <agent> <model>\` |
6819
6991
  | \`openfeel lint i18n\\|kb\` | 健康检查(i18n 键一致性 / kb 过期引用) | 发现问题**非 0 退出** |
6820
6992
  | \`openfeel knowledge ...\` | 知识库管理 | \`list\` / \`add\` / \`search\` / \`index\` / \`dedup\` |
@@ -6824,7 +6996,7 @@ description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15
6824
6996
  | \`openfeel roadmap create\\|show\` | 分期大纲管理 | \`create <version>\`、\`show [version]\` |
6825
6997
  | \`openfeel instructions <artifactId>\` | 为指定 artifact 生成结构化指令 | \`--change <name>\`、\`--schema <name>\`、\`--json\` |
6826
6998
 
6827
- **flow 子命令**:\`status\` / \`current\` / \`overview\` / \`phases\` / \`stage\`(\`add\` / \`remove\` / \`set --deps\` / **\`reset <id> --to <phase> [--dry-run]\`**)/ \`metrics\` / \`advance\`(\`--stage <id> --to <phase>\`、\`--op\`、\`--force\`、\`--dry-run\`、\`--quiet\`)/ \`attempt\` / \`log\` / \`review\` / \`retry\` / \`repair\` / \`ops\` / \`migrate\` / \`checkpoint\`(\`list\` / **\`restore <file> [--force] [--stage <id>] [--dry-run]\`**)/ \`health\` / \`recover\` / \`wizard\`。
6999
+ **flow 子命令**:\`status\` / \`current\` / \`overview\` / \`phases\` / \`mode\`(\`[--stage <id>] [--json]\`,只读) / \`stage\`(\`add\` / \`remove\` / \`set --deps\` / **\`reset <id> --to <phase> [--dry-run]\`**)/ \`metrics\` / \`advance\`(\`--stage <id> --to <phase>\`、\`--op\`、\`--force\`、\`--dry-run\`、\`--quiet\`)/ \`attempt\` / \`log\` / \`review\` / \`retry\` / \`repair\` / \`ops\` / \`migrate\` / \`checkpoint\`(\`list\` / **\`restore <file> [--force] [--stage <id>] [--dry-run]\`**)/ \`health\` / \`recover\` / \`wizard\`。
6828
7000
 
6829
7001
  **纠错/清理侧补充**:\`flow review add|resolve|update|remove\`;\`flow ops list [--stage <id>] [--json]\`(操作方案视图,draft 分组展示);\`flow repair [--prune-orphans]\`(默认只报告,\`--prune-orphans\` 仅清键孤儿,单向不删文件);\`plan scheme register\`(补注册**文件孤儿**:有 op 文件无注册键 → 写入 flow.json,\`--dry-run\` 零写盘;与 \`flow repair --prune-orphans\`(仅清键孤儿)对称);**\`flow stage reset <id> --to <phase>\`**(\`advance\` 的**对称复位**:允许回退,受合法 phase 值域 + \`to=done\` 阻塞 REV 约束,\`--dry-run\` 零写盘);**\`flow checkpoint restore <file> --stage <id> [--dry-run]\`**(按阶段选择性回退;\`--dry-run\` 差异预览零写盘)。
6830
7002
 
@@ -6835,6 +7007,13 @@ description: OpenFeel CLI 命令用法参考:命令清单与关键参数、15
6835
7007
  - **多 harness 并存**:\`openfeel setup\` / \`openfeel update\` 新增 \`--tools <逗号列表>\`(如 \`opencode,claude\`);非法值 **exit 1** 前置校验零写盘;默认仅 \`opencode\`。
6836
7008
  - **Claude Code 适配器资产**:\`--tools claude\` 部署 \`~/.claude/\`——\`CLAUDE.md\`(全局约束,用户已有内容 append 不覆盖)、\`agents/\`(**9 个**,含 \`feel\`)、\`skills/\`(**17 个**共享源)、\`settings.json\`(注入 \`"agent":"feel"\` + \`"permissions":{"defaultMode":"auto"}\`,用户既有键逐字保留);默认零触(不带 \`--tools\` 时 \`~/.claude/\` 零变化)。
6837
7009
 
7010
+ ## v1.1.7 新增能力(stage-74~76)
7011
+
7012
+ - **双模式工作流(\`workflow_mode\`)**:值域 \`full | fast\`(默认 \`fast\`)。三层载体:\`config.yaml defaults.workflow_mode\`(项目默认 / 记忆)→ \`status.md「工作流模式」\`(阶段覆盖,**读取权威**)→ \`flow.json\` 冗余字段(可选、**不参与级联**);级联优先序 \`status.md > config.yaml > builtin\`(\`profile.yaml\` 不承载)。只读查询:\`openfeel flow mode [--stage <id>] [--json]\`(当前模式 + 四源 \`source\`)。
7013
+ - **fast 快线转移表(并列)**:\`transitions\` 共 **9 条目**(8 条流转键 + \`done\` 终止项):\`plan_pending → plan_review\`(**计划审查必经**)、\`plan_review → plan_passed / plan_pending\`、\`plan_passed → exec_running\`、\`exec_running → review_pending\`、\`review_pending → review_failed / review_passed\`、\`review_failed → review_pending / exec_running\`(回环)、\`review_passed → archiving\`、\`archiving → done\`、\`done\`(终态)。**\`phases\` / \`advanceAccepted\` 恒 15 项、模式无关**;fast 下 6 个相位不可达(\`scheme_*\` / \`test_*\`)。
7014
+ - **模式命令面**:\`plan stage add --workflow-mode <full|fast>\`(值域派生、非法 exit 1 不建阶段)、\`stage set <id> --workflow-mode <full|fast>\`(缺失字段插入)、\`flow phases [--mode <full|fast>] [--stage <id>]\`(模式分节;\`--json\` 追加 \`workflowMode\`)、\`config set ... --sync-stages [--stage <ids...>]\`(同步字段含「工作流模式」)。
7015
+ - **\`config effective\` 四键**:\`auto_advance\` / \`execution_mode\` / \`merge_mode\` / \`workflow_mode\`。
7016
+
6838
7017
  ## v1.1.5 新增能力(stage-67)
6839
7018
 
6840
7019
  - **主动诊断 \`openfeel setup --check [--json]\`**:只读检测全局部署版本(\`~/.openfeel/update_state.json.openfeel_version\`)与 CLI 版本一致性,**不执行部署**;一致退出 \`0\`,\`mismatch\`/\`missing\`/\`unknown\` 退出 \`1\`;\`--json\` 输出 \`{schemaVersion,status,cliVersion,deployedVersion}\`(\`status\` ∈ \`ok|mismatch|missing|unknown\`)。
@@ -6867,7 +7046,7 @@ openfeel setup --tools claude # 2. 重跑部署(claude 目标)
6867
7046
 
6868
7047
  > 以下为 v1.1.2 相对上版的增量能力(分组摘要,细节以 \`<cmd> --help\` 为准)。
6869
7048
 
6870
- - **A. 自描述与可纠错(stage-41)**:\`flow phases [--json]\`(**5 键**:\`schemaVersion\`/\`phases\`/\`transitions\`/\`advanceAccepted\`/\`transitionsDiff\`)、\`flow stage remove [--force] [--dry-run] [--purge]\`、stageId 校验/冲突检测(\`validateStageId\` / \`suggestStageId\` / \`findStageDirConflict\`)、\`plan stage add --deps\`。
7049
+ - **A. 自描述与可纠错(stage-41)**:\`flow phases [--json] [--mode <full|fast>] [--stage <id>]\`(**6 键**:\`schemaVersion\`/\`phases\`/\`transitions\`/\`advanceAccepted\`/\`transitionsDiff\`/\`workflowMode\`(v1.1.7 追加);既有五键语义逐字不变)、\`flow stage remove [--force] [--dry-run] [--purge]\`、stageId 校验/冲突检测(\`validateStageId\` / \`suggestStageId\` / \`findStageDirConflict\`)、\`plan stage add --deps\`。
6871
7050
  - **B. 状态与口径(stage-42)**:\`config effective [key]\`(有效值 + 生效来源 \`status.md > config.yaml > profile.yaml > builtin\`)、\`pipeline.phase\` 全量 done 判定、审计日志 \`register_stage\` / \`register_op\`。
6872
7051
  - **C. 部署与备份(stage-46)**:覆盖写前自动备份 \`~/.openfeel/backup/{ts}/\` + \`update_infos.md\`「备份」类条目(Agent 按 \`feel.md\` 检查规则核对)。
6873
7052
  - **D. 纠正/清理侧命令面(stage-51/52,v1.1.4-stage-64 补 register)**:\`plan scheme remove\`(仅删 \`flow.json\` 注册键,不删 op 文件;done/checkpoint 保护)、\`plan scheme register <stage> [opId] [--dry-run]\`(对称补全:补注册 fileOrphans,\`--dry-run\` 零写盘;**\`create\` 序号基于「ops/ 文件 ∪ flow.json 注册」的最小未用正整数(空位回填),创建后对目标阶段未注册文件输出 stderr 告警并提示 \`plan scheme register\`**)、\`plan scheme rename --title\`(必填,空标题报错)、\`plan scheme publish\` + \`create --draft\`(draft→pending,空模板拒绝)、\`flow stage set --deps\`(覆盖写入;**不带 \`--deps\` 视为清空**)、\`flow review update|remove\`、\`stage set\`(**幂等**:同值 no-op + 同值不生成 \`.bak\`;\`--exec-mode <manual\\|auto>\` / \`--auto-advance <enabled\\|disabled>\` / \`--review-agent <agent>\`)、\`stage task --add|--done|--undone\`、\`plan stage add --tasks\`/\`--exec-mode\`/\`--auto-advance\`(显式覆盖 config 默认)、\`flow repair --prune-orphans\`、\`flow health --fix [--dry-run]\`(默认只报告;\`--fix\` **仅回写 status.md「状态」字段**;\`--dry-run\` 预览零写盘)、\`flow ops list\`、\`flow advance --quiet\` + \`--to <远距 phase>\`(存在唯一路径时自动逐步;\`--dry-run\` 展示完整路径)、\`knowledge dedup\`(检索相似条目,**只读建议,不修改 kb**)。\`flow attempt\` 对 **draft op 拒绝**。
@@ -6901,7 +7080,23 @@ plan_pending → plan_review → plan_passed → scheme_pending → scheme_revie
6901
7080
  | \`archiving\` | \`done\` |
6902
7081
  | \`done\` | (终态) |
6903
7082
 
6904
- - 转移表以**运行时** \`.openfeel/pipeline.yaml\` 为准;\`openfeel flow phases\` 查看当前生效值。
7083
+ **fast 快线转移表(\`workflow_mode=fast\`)** —— \`transitions\` 共 **9 条目**(8 条流转键 + \`done\` 终止项),快线链(可达相位序列)为 \`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`:
7084
+
7085
+ | phase | 合法目标 |
7086
+ |-------|----------|
7087
+ | \`plan_pending\` | \`plan_review\` |
7088
+ | \`plan_review\` | \`plan_passed\`, \`plan_pending\` |
7089
+ | \`plan_passed\` | \`exec_running\` |
7090
+ | \`exec_running\` | \`review_pending\` |
7091
+ | \`review_pending\` | \`review_failed\`, \`review_passed\` |
7092
+ | \`review_failed\` | \`review_pending\`, \`exec_running\` |
7093
+ | \`review_passed\` | \`archiving\` |
7094
+ | \`archiving\` | \`done\` |
7095
+ | \`done\` | (终态) |
7096
+
7097
+ > \`phases\` / \`advanceAccepted\` 恒 15 项(模式无关);fast 下 \`scheme_pending\` / \`scheme_review\` / \`scheme_passed\` / \`test_pending\` / \`test_failed\` / \`test_passed\` 共 **6 项**不可达(无入边)。
7098
+
7099
+ - 转移表以**运行时** \`.openfeel/pipeline.yaml\` 为准;\`openfeel flow phases\` 查看当前生效值。(\`--mode <full|fast>\` 显式指定 / \`--stage <id>\` 按阶段派生;\`--json\` 追加 \`workflowMode\`)
6905
7100
  - 推进:\`openfeel flow advance --stage <id> --to <phase>\`。**\`advanceAccepted\` = 内置 15 个 phase 的「推进白名单」**(\`flow advance\` 只接受这 15 个值),**不是**组合式条件键的替代品(旧文案曾误述,此处已更正)。**组合式条件差异**(如内置默认含 \`review_passed|test_passed\`,本仓 \`pipeline.yaml\` 未列)经 \`--json.transitionsDiff.missing\` **显式可见**(stage-50 裁定:**不补组合键**,改以 \`transitionsDiff\` 显式化)。
6906
7101
  - 参考:\`.openfeel/manual/**\`(CLI/flow 模块文档)。
6907
7102
 
@@ -7013,7 +7208,7 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md,判断当前子
7013
7208
 
7014
7209
  ### 0. 读取全局配置
7015
7210
 
7016
- 读取 \`.openfeel/config.yaml\`,解析 \`defaults\` 中的 \`execution_mode\`、\`auto_advance\`、\`merge_mode\`。
7211
+ 读取 \`.openfeel/config.yaml\`,解析 \`defaults\` 中的 \`execution_mode\`、\`auto_advance\`、\`merge_mode\`、\`workflow_mode\`。
7017
7212
 
7018
7213
  ### 1. 定位状态文件
7019
7214
 
@@ -7029,6 +7224,7 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md,判断当前子
7029
7224
 
7030
7225
  - \`执行模式\`
7031
7226
  - \`自动推进\`
7227
+ - \`工作流模式\`
7032
7228
  - \`状态\`
7033
7229
  - \`当前责任 Agent\`
7034
7230
  - \`上一责任 Agent\`
@@ -7089,6 +7285,7 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md,判断当前子
7089
7285
  - 阶段:{stage}
7090
7286
  - 执行模式:manual | auto
7091
7287
  - 自动推进:disabled | enabled
7288
+ - 工作流模式:full | fast
7092
7289
  - 状态:{status}
7093
7290
  - 当前责任 Agent:{agent}
7094
7291
  - 前置依赖:{依赖列表 或 无}
@@ -7103,6 +7300,8 @@ description: 读取 .openfeel/plan/{series}/{stage}/status.md,判断当前子
7103
7300
  {根据状态给出下一步,例如:启动 Code、等待用户、启动 openfeel-feel-tester、停止流程;若存在并行候选则建议批量启动}
7104
7301
  \`\`\`
7105
7302
 
7303
+ > **模式感知(fast)**:\`工作流模式\` 为 \`fast\` 时,「下一步建议」不指向方案 / 测试环节(快线链为 计划 → 计划审查 → 执行 → 代码审查 → 归档);\`plan_pending\` 阶段下一步建议 = \`plan_review\`(必经,勿建议直接 \`plan_passed\`);相位口径为「**可达 ≠ 合法**」——合法枚举仍 15 项(fast 下仅 6 项不可达),**不得**表述为相位缩减。
7304
+
7106
7305
  ## 状态到下一步映射
7107
7306
 
7108
7307
  | 状态 | 下一步建议 |
@@ -7335,7 +7534,7 @@ models:
7335
7534
 
7336
7535
  ### opencode 适配器
7337
7536
 
7338
- 平台配置文件:
7537
+ 读取 \`opencode.jsonc\`(或对应平台的配置文件),确定当前适配器平台:
7339
7538
 
7340
7539
  | 配置文件 | 平台 |
7341
7540
  |----------|------|
@@ -7344,7 +7543,8 @@ models:
7344
7543
 
7345
7544
  若无平台配置文件,提示用户当前不在支持的平台中。
7346
7545
 
7347
- - agents 目录:\`.opencode/agents/\`(或对应平台的 agents/ 目录)下所有 \`.md\` 文件。
7546
+ 扫描 \`.opencode/agents/\`(或对应平台的 agents/ 目录)下所有 \`.md\` 文件,提取每个 Agent 的模型需求。
7547
+
7348
7548
  - 报告/模板中的平台标签:\`**平台**:OpenCode(当前适配器)\`(原文标签,正文已改为中性表述「当前 harness(opencode 适配器 / Claude Code 适配器)」)。
7349
7549
  - 向用户提问使用 \`question\` 工具。
7350
7550
 
@@ -7480,6 +7680,8 @@ description: 跨会话上下文恢复,供 Agent 在会话启动时重建流水
7480
7680
  2. 读取**索引** \`.openfeel/users/{username}/dev_last.md\`(「用户偏好」「主题索引」「公共交接区」)→ **按需**再读主题文件(**文件名英文,如 \`decisions.md\`/\`pending.md\`**)恢复详情;**旧格式**(无 \`## 主题索引\` 节)→ 触发惰性迁移(按英文命名映射拆分生成 \`dev_last/\` + 索引,原文保留)
7481
7681
  3. 将两者合并为当前会话起点
7482
7682
 
7683
+ > **模式感知**:恢复后按当前阶段 \`status.md「工作流模式」\` 确认流程模式(\`flow recover\` 输出不含模式字段;fast 工作流快线下按快线链继续)。
7684
+
7483
7685
  > **加锁提示(A9)**:恢复流程为**只读**,无需加锁;仅**会话末尾写入**走 \`withFileLock\` 临界区(见 agents-md「并发写加锁协议」)。
7484
7686
 
7485
7687
  ## 输出
@@ -7776,7 +7978,7 @@ description: 标准化更新 .openfeel/plan/{series}/{stage}/status.md 的子计
7776
7978
 
7777
7979
  ### 0. 读取全局配置
7778
7980
 
7779
- 读取 \`.openfeel/config.yaml\`,获取 \`defaults\` 中的 \`execution_mode\`、\`auto_advance\`、\`merge_mode\`。
7981
+ 读取 \`.openfeel/config.yaml\`,获取 \`defaults\` 中的 \`execution_mode\`、\`auto_advance\`、\`merge_mode\`、\`workflow_mode\`。
7780
7982
 
7781
7983
  ### 1. 读取状态文件
7782
7984
 
@@ -7821,6 +8023,7 @@ planned | ready_for_code | coding | ready_for_review | review_failed | review_pa
7821
8023
 
7822
8024
  - \`执行模式\`
7823
8025
  - \`自动推进\`
8026
+ - \`工作流模式\`(模式字段**不由**状态更新覆盖)
7824
8027
  - \`前置依赖\`(由 Architect 在 Phase 3.5 中声明,运行时不应修改)
7825
8028
 
7826
8029
  ### 4. 追加状态记录
@@ -7882,6 +8085,8 @@ description: 交互式流水线向导,供 Agent 在终端中逐步推进流水
7882
8085
  2. 按提示选择要推进的阶段和下一步 phase(基于当前阶段的可达 transitions)
7883
8086
  3. 确认后执行推进,循环直至阶段 done 或退出
7884
8087
 
8088
+ > **模式选型**:首次运行时向导会询问工作流模式(\`full\` / \`fast\`),写入 \`config.yaml defaults.workflow_mode\`(项目级记忆);非 TTY 环境沿用既有守卫、不询问。
8089
+
7885
8090
  ## 输出
7886
8091
 
7887
8092
  向导推进结果:阶段 phase 变化(from → to),结束/退出提示
@@ -8125,6 +8330,21 @@ When a stage enters \`plan_passed\` and the project's \`auto_advance\` is set to
8125
8330
  3. **User declines**: The main session keeps \`auto_advance=disabled\` and requires user confirmation before each stage advance (manual execution mode).
8126
8331
  4. **No silent advancement**: When \`auto_advance=disabled\`, the main session must not advance the pipeline without asking the user.
8127
8332
 
8333
+ #### Workflow Mode (workflow_mode)
8334
+
8335
+ Before dispatching, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`; when the field is absent, fall back per the cascade). Two modes:
8336
+
8337
+ - **full (complete flow)**: planner → plan_review (reviewer) → schemer → executor → reviewer → tester → archiver.
8338
+ - **fast (Workflow Fast Line)**: planner (lightweight) → plan_review (**single mandatory plan review**) → executor → reviewer (single round) → archiver (lightweight); **does not dispatch openfeel-schemer / openfeel-feel-tester**.
8339
+
8340
+ Fast-mode discipline:
8341
+
8342
+ 1. **The quality floor cannot be skipped**: under fast the reviewer **runs twice** — ① \`plan_review\` plan review (**mandatory single round**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (single round); the \`review_failed\` loop allows re-review or returning to exec for fixes; failures are recorded as usual (REV entries unchanged).
8343
+ 2. **Lightweight**: planner / archiver produce lightweight output (**must not** omit the task table / dependencies / acceptance points, or the state record / knowledge-staging decision).
8344
+ 3. **Phase semantics**: under fast, reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`); the **legal phase enumeration remains at 15** (6 phases are unreachable under fast: \`scheme_*\` / \`test_*\`).
8345
+ 4. **Full skeletons unchanged**: fast trims no on-disk structure; it only reduces agent relay steps.
8346
+ 5. **Terminology disambiguation**: the flow mode is called the **Workflow Fast Line** (\`workflow_mode=fast\`); the review-depth downgrade is called **Fast Track (FAST-PASS)** — they are different mechanisms and must not be cross-referenced or conflated.
8347
+
8128
8348
  ## Threshold for Small Changes vs. Large-Scale Planning
8129
8349
 
8130
8350
  Choose the appropriate process path based on the change scale:
@@ -8192,7 +8412,7 @@ A shared log entry (\`.openfeel/log/yyyy-mm-dd-feel-NNN.md\`) must be created wh
8192
8412
 
8193
8413
  ### Skeleton File Note
8194
8414
 
8195
- During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory. The main session does not need to manually create log files; simply fill in the content when you see a skeleton file.
8415
+ During critical operations (advancing to exec_running / review_pending / test_pending / archiving), the pipeline automatically creates skeleton files with date prefixes in the private log directory (under the fast Workflow Fast Line, \`test_pending\` remains a legal phase but is unreachable (no inbound edge), so its skeleton is no longer produced; all other skeleton rules are unchanged). The main session does not need to manually create log files; simply fill in the content when you see a skeleton file.
8196
8416
 
8197
8417
  ### Log Entry Format
8198
8418
 
@@ -8450,6 +8670,15 @@ After archiving is complete, the stage's pipeline phase must be set to one of th
8450
8670
 
8451
8671
  > ⚠️ Note: After archiving is complete, the stage status must be set to \`"done"\`, **do not** use non-standard values like \`"completed"\`. \`"completed"\` does not exist in \`VALID_TRANSITIONS\`.
8452
8672
 
8673
+ > **Under the fast Workflow Fast Line**: the 15-phase enumeration above is **unchanged** (reachable ≠ legal); reachable phases are the fast-line chain (\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`).
8674
+
8675
+ ## Workflow Mode Awareness (fast lightweight archiving)
8676
+
8677
+ Before archiving, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
8678
+
8679
+ - **full**: full archiving checklist (unchanged).
8680
+ - **fast (Workflow Fast Line)**: **lightweight archiving** — the state record and the knowledge-staging decision (including the dedup lookup) **must not be omitted**; checklist process narrative may be merged and condensed. (Lightweight scope: keep the state record / knowledge-staging decision / kb index quick overview / manual update decision / shared log summary; summary process narrative may be merged into bullet points.)
8681
+
8453
8682
  ## Model Selection
8454
8683
 
8455
8684
  openfeel-archiver is decided by the **Claude-side model** (default \`model: inherit\`); archiving and knowledge extraction require understanding of context, and the framework does not hard-code vendor model IDs in templates.
@@ -8461,7 +8690,7 @@ name: openfeel-executor
8461
8690
  description: "Executor: implements code strictly per the op scheme and self-tests (Edit/Write/TodoWrite); does not expand scope."
8462
8691
  tools: Bash, Read, Glob, Grep, Edit, Write, TodoWrite
8463
8692
  effort: medium
8464
- color: red
8693
+ color: green
8465
8694
  model: inherit
8466
8695
  ---
8467
8696
 
@@ -8521,9 +8750,10 @@ Confirm that the following 6 required fields are present. If any is missing, ret
8521
8750
 
8522
8751
  ### Step 2: Phase Legitimacy Check
8523
8752
 
8524
- 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid.
8753
+ 1. Read \`.openfeel/flow.json\`, check if \`pipeline.phase\` is a valid enum value (\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`); refuse to execute if invalid. (under the fast Workflow Fast Line, reachable phases are the fast-line chain; the legal phase enumeration remains at 15 — reachable ≠ legal)
8525
8754
  2. Confirm \`pipeline.current.op\` matches the current op-id; refuse to execute if mismatched.
8526
8755
  3. When the current phase is not \`exec_running\`: if the **main session** explicitly instructs execution, it may proceed but must note the phase deviation; otherwise, refuse to execute.
8756
+ 4. **Fast-mode phase paths**: \`plan_pending → plan_review → plan_passed → exec_running\` (the plan review is a mandatory single round; the step is entered only after it passes); the \`review_failed → exec_running\` loop (review failure returns to exec for fixes; the \`review_failed → review_pending\` re-review exit is retained).
8527
8757
 
8528
8758
  ### Step 3: FlowManager Transition Legitimacy Check
8529
8759
 
@@ -8667,7 +8897,7 @@ name: openfeel-feel-tester
8667
8897
  description: "Tester: performs formal test acceptance of pipeline outputs and files BUG entries (Edit/Write/Skill)."
8668
8898
  tools: Bash, Read, Glob, Grep, Edit, Write, Skill
8669
8899
  effort: medium
8670
- color: orange
8900
+ color: cyan
8671
8901
  model: inherit
8672
8902
  ---
8673
8903
 
@@ -8758,6 +8988,7 @@ Write regression verification results into the Bug file's "Acceptance Record" ta
8758
8988
  - When issues are found, **return to the main session**, which dispatches openfeel-schemer to formulate a revision
8759
8989
  - Re-test after fixes until passing
8760
8990
  - When tests pass, notify the **main session** to enter the archiving phase
8991
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the formal test step is skipped per \`status.md\` "Workflow Mode"; the \`test_*\` phases are unreachable); the role definition is unchanged.
8761
8992
 
8762
8993
  ## Model Selection
8763
8994
 
@@ -8776,7 +9007,7 @@ name: openfeel-planner
8776
9007
  description: "Planning officer: transforms user requirements into structured development plans, authoring roadmap/plan.md/deps.yaml; read-only, does not edit source."
8777
9008
  tools: Bash, Read, Glob, Grep, Skill
8778
9009
  effort: max
8779
- color: purple
9010
+ color: blue
8780
9011
  model: inherit
8781
9012
  ---
8782
9013
 
@@ -8870,6 +9101,13 @@ This step ensures openfeel-planner absorbs existing project knowledge before mak
8870
9101
  - Does not directly code or execute tests
8871
9102
  - openfeel-planner and openfeel-schemer responsibility boundary: openfeel-planner is responsible for "what" (what) and "when" (when), openfeel-schemer is responsible for "how" (how)
8872
9103
 
9104
+ ## Workflow Mode Awareness (fast)
9105
+
9106
+ Before planning, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
9107
+
9108
+ - **full**: the output goes through openfeel-reviewer plan review (\`plan_review\`) before openfeel-schemer (unchanged).
9109
+ - **fast (Workflow Fast Line)**: **this agent's output must pass openfeel-reviewer's plan review (\`plan_review\`, single round; pass → \`plan_passed\`, issues returned → \`plan_pending\`; only then does it enter exec)**; produce a lightweight plan — the task table / dependencies / acceptance points **must not be omitted**; other process narrative may be trimmed. (Lightweight scope: keep goals / dependencies / task table / acceptance points / constraints / KB retrieval / change-point list / risks; background evidence details and revision history may be condensed.)
9110
+
8873
9111
  ## Model Selection
8874
9112
 
8875
9113
  openfeel-planner is decided by the **Claude-side model** (default \`model: inherit\`); plan formulation requires strong reasoning capability, and the framework does not hard-code vendor model IDs in templates.
@@ -8884,7 +9122,7 @@ name: openfeel-reviewer
8884
9122
  description: "Reviewer: cross-reviews plans/schemes/code and files REV entries; reviews only, does not modify."
8885
9123
  tools: Bash, Read, Glob, Grep
8886
9124
  effort: medium
8887
- color: yellow
9125
+ color: pink
8888
9126
  model: inherit
8889
9127
  ---
8890
9128
 
@@ -8946,6 +9184,15 @@ When **all three** of the following conditions are met, openfeel-reviewer enters
8946
9184
 
8947
9185
  If any condition is not met, skip fast track and execute full review process.
8948
9186
 
9187
+ ## Workflow Mode Awareness (fast single round)
9188
+
9189
+ Before reviewing, read the current stage's \`status.md\` "Workflow Mode" field (authoritative query: \`openfeel flow mode [--stage <id>]\`):
9190
+
9191
+ - **full**: plan review + code review (multiple points, unchanged).
9192
+ - **fast (Workflow Fast Line)**: **single round ×2, both mandatory** — ① \`plan_review\` **plan review (mandatory under fast**, on par with code review; pass → \`plan_passed\`, issues returned → \`plan_pending\`); ② code review after exec (the \`review_failed\` loop allows re-review / returning to exec for fixes); the **quality floor is unchanged** (issues are still recorded and blockers still raised; REV entries as usual).
9193
+
9194
+ > **Terminology disambiguation**: the **Workflow Fast Line** (\`workflow_mode=fast\`, the flow mode) and **Fast Track (FAST-PASS)** (the review-depth downgrade mechanism defined in this template) are **different mechanisms** with similar names — do not cross-reference or conflate them.
9195
+
8949
9196
  ## REV Template Specification
8950
9197
 
8951
9198
  \`\`\`yaml
@@ -8989,7 +9236,7 @@ openfeel-reviewer is decided by the **Claude-side model** (default \`model: inhe
8989
9236
  | Requires judgment (default blocking) | Serious coding convention violations / Cross-module consistency issues | \`true\` |
8990
9237
  | Non-blocking | Naming suggestions / Comment improvements / Style tweaks / Optimization suggestions | \`false\` |
8991
9238
 
8992
- > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities).
9239
+ > When fast track is hit, REV defaults to \`blocking=false\` (except for security vulnerabilities). This mechanism is unrelated to the Workflow Fast Line — see "Workflow Mode Awareness".
8993
9240
 
8994
9241
  ## blocking and Pipeline Behavior
8995
9242
 
@@ -9105,6 +9352,7 @@ When third-party dependencies are involved:
9105
9352
 
9106
9353
  - Receives dispatch from the **main session** to start; outputs are reviewed by openfeel-reviewer before being handed to openfeel-executor
9107
9354
  - When review fails, re-formulate the scheme based on openfeel-reviewer feedback
9355
+ - **Workflow Mode Awareness**: under the fast Workflow Fast Line this agent is **not dispatched** (the scheme step is skipped per \`status.md\` "Workflow Mode"); the role definition is unchanged.
9108
9356
 
9109
9357
  ## Notes
9110
9358
 
@@ -9432,6 +9680,21 @@ openfeel-reviewer 审查发现的 REV,**即使是白名单操作(如文档
9432
9680
  3. **用户拒绝**:主会话保持 \`auto_advance=disabled\`,每次阶段推进前均需向用户确认(手动执行模式)。
9433
9681
  4. **禁止静默推进**:\`auto_advance=disabled\` 时禁止主会话不询问用户直接推进流水线。
9434
9682
 
9683
+ #### 工作流模式(workflow_mode)
9684
+
9685
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询:\`openfeel flow mode [--stage <id>]\`;字段缺失时按级联口径回落)。两种模式:
9686
+
9687
+ - **full(完整流程)**:planner → plan_review(reviewer)→ schemer → executor → reviewer → tester → archiver。
9688
+ - **fast(工作流快线)**:planner(轻量)→ plan_review(**计划审查单轮,必经**)→ executor → reviewer(单轮)→ archiver(轻量);**不派发 schemer / tester**。
9689
+
9690
+ fast 调度纪律:
9691
+
9692
+ 1. **质量底线不可跳**:reviewer 在 fast 下**必跑两处**——① \`plan_review\` 计划审查(**必经单轮**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(单轮);\`review_failed\` 回环可重审或回执行修复;失败留痕照常(REV 条目照常)。
9693
+ 2. **轻量化**:planner / archiver 轻量产出(**不得**省略任务表 / 依赖 / 验收要点与状态记录 / 知识暂存判定)。
9694
+ 3. **相位口径**:fast 下可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`);**合法相位枚举 15 项不变**(fast 下 6 项不可达:\`scheme_*\` / \`test_*\`)。
9695
+ 4. **骨架全量不变**:fast 不裁剪任何落盘结构,仅减少 Agent 接力环节。
9696
+ 5. **术语消歧**:流程模式称「**工作流快线**」(\`workflow_mode=fast\`);审查深度降级称「**快速通道 / fast track(FAST-PASS)**」——二者为不同机制,不得互相引用 / 混用。
9697
+
9435
9698
  ## 小改 vs 大规模规划的阈值
9436
9699
 
9437
9700
  根据变更规模选择适当的流程路径:
@@ -9499,7 +9762,7 @@ openfeel-reviewer 审查发现的 REV,**即使是白名单操作(如文档
9499
9762
 
9500
9763
  ### 骨架文件提示
9501
9764
 
9502
- 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件。主会话无需手动创建日志文件,看到骨架文件时填充内容即可。
9765
+ 关键操作(推进到 exec_running / review_pending / test_pending / archiving)时,流水线会自动在私域日志目录创建带日期前缀的骨架文件(fast 工作流快线下 \`test_pending\` 仍为合法相位、仅不可达(无入边),该相位骨架不再产生;其余骨架规则全量不变)。主会话无需手动创建日志文件,看到骨架文件时填充内容即可。
9503
9766
 
9504
9767
  ### 日志条目格式
9505
9768
 
@@ -9756,6 +10019,15 @@ openfeel-feel-tester 通过 → 主会话触发归档 → openfeel-archiver 整
9756
10019
 
9757
10020
  > ⚠️ 注意:归档完成后的阶段状态必须设为 \`"done"\`,**不得**使用 \`"completed"\` 等非标准值。\`VALID_TRANSITIONS\` 中不存在 \`"completed"\`。
9758
10021
 
10022
+ > **fast 工作流快线下**:上表 15 项相位枚举**不变**(可达 ≠ 合法);可达相位为快线链(\`plan_pending → plan_review → plan_passed → exec_running → review_pending → review_failed → review_passed → archiving → done\`)。
10023
+
10024
+ ## 工作流模式感知(fast 轻量归档)
10025
+
10026
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
10027
+
10028
+ - **full**:归档全量清单(现状不变)。
10029
+ - **fast(工作流快线)**:**轻量归档**——状态记录与知识暂存判定(含去重检索)**不得省略**;清单过程性叙述可合并精简。(轻量口径:保留 状态记录 / 知识暂存判定 / 知识库快速概览 / 模块手册判定 / 公共日志摘要;总结过程性叙述可合并为要点。)
10030
+
9759
10031
  ## 模型选择
9760
10032
 
9761
10033
  openfeel-archiver 由 **Claude 侧模型**决定(默认 \`model: inherit\`);归档与知识提取需要理解上下文,框架不在模板内硬编码厂商模型 ID。
@@ -9767,7 +10039,7 @@ name: openfeel-executor
9767
10039
  description: 执行官:严格按 op 操作方案编码实现并自测(Edit/Write/TodoWrite);不擅自扩大范围。
9768
10040
  tools: Bash, Read, Glob, Grep, Edit, Write, TodoWrite
9769
10041
  effort: medium
9770
- color: red
10042
+ color: green
9771
10043
  model: inherit
9772
10044
  ---
9773
10045
 
@@ -9827,9 +10099,10 @@ model: inherit
9827
10099
 
9828
10100
  ### 步骤 2:Phase 合法性校验
9829
10101
 
9830
- 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。
10102
+ 1. 读取 \`.openfeel/flow.json\`,检查 \`pipeline.phase\` 是否为合法枚举值(\`plan_pending | plan_review | plan_passed | scheme_pending | scheme_review | scheme_passed | exec_running | review_pending | review_failed | review_passed | test_pending | test_failed | test_passed | archiving | done\`),非法则拒绝执行。(fast 工作流快线下可达相位为快线链;合法相位枚举 15 项不变——可达 ≠ 合法)
9831
10103
  2. 确认 \`pipeline.current.op\` 与当前 op-id 匹配,不匹配则拒绝执行。
9832
10104
  3. 当前 phase 不是 \`exec_running\` 时:若**主会话**已明确指示执行可继续但需注明 phase 偏差;否则拒绝执行。
10105
+ 4. **fast 工作流快线下相位路径**:\`plan_pending → plan_review → plan_passed → exec_running\`(计划审查为必经单轮:通过后进入本环节);\`review_failed → exec_running\` 回环(审查不通过时回执行修复;\`review_failed → review_pending\` 重审出口保留)。
9833
10106
 
9834
10107
  ### 步骤 3:FlowManager 流转合法性校验
9835
10108
 
@@ -9973,7 +10246,7 @@ name: openfeel-feel-tester
9973
10246
  description: 测试官:对流水线产出做正式测试验收,记录 BUG 条目(Edit/Write/Skill)。
9974
10247
  tools: Bash, Read, Glob, Grep, Edit, Write, Skill
9975
10248
  effort: medium
9976
- color: orange
10249
+ color: cyan
9977
10250
  model: inherit
9978
10251
  ---
9979
10252
 
@@ -10064,6 +10337,7 @@ high 优先级 Bug 修复后,推荐执行全量测试套件。
10064
10337
  - 发现问题后**返回主会话**,由主会话调度 openfeel-schemer 制定修复方案
10065
10338
  - 修复后重新测试直到通过
10066
10339
  - 测试通过后通知**主会话**进入归档阶段
10340
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过正式测试环节,\`test_*\` 相位不可达);职责定义不变。
10067
10341
 
10068
10342
  ## 模型选择
10069
10343
 
@@ -10082,7 +10356,7 @@ name: openfeel-planner
10082
10356
  description: 计划官:将用户需求转化为结构化开发计划,制定 roadmap/plan.md/deps.yaml;只读,不写源码。
10083
10357
  tools: Bash, Read, Glob, Grep, Skill
10084
10358
  effort: max
10085
- color: purple
10359
+ color: blue
10086
10360
  model: inherit
10087
10361
  ---
10088
10362
 
@@ -10176,6 +10450,13 @@ openfeel-planner 作为独立 subagent,由**主会话(Feel 角色)**经 **
10176
10450
  - 不直接编码,不执行测试
10177
10451
  - openfeel-planner 与 openfeel-schemer 的职责边界:openfeel-planner 负责"做什么"(what)和"何时做"(when),openfeel-schemer 负责"怎么做"(how)
10178
10452
 
10453
+ ## 工作流模式感知(fast 快线)
10454
+
10455
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
10456
+
10457
+ - **full**:产出经 openfeel-reviewer 计划审查(\`plan_review\`)后进入 openfeel-schemer(现状不变)。
10458
+ - **fast(工作流快线)**:**本 Agent 产出后必经 openfeel-reviewer 的计划审查(\`plan_review\` 单轮;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`;此后进入 exec)**;产出为轻量计划——任务表 / 依赖声明 / 验收要点**不得省略**,其余过程性描述可精简。(轻量口径:保留 目标 / 依赖 / 任务表 / 验收要点 / 约束 / KB 检索 / 变更点清单 / 风险;背景实测证据明细与修订记录过程可收敛为结论。)
10459
+
10179
10460
  ## 模型选择
10180
10461
 
10181
10462
  openfeel-planner 由 **Claude 侧模型**决定(默认 \`model: inherit\`);计划制定需要较强推理能力,框架不在模板内硬编码厂商模型 ID。
@@ -10190,7 +10471,7 @@ name: openfeel-reviewer
10190
10471
  description: 审查官:交叉审查计划/方案/代码并提交 REV 条目;只审不改。
10191
10472
  tools: Bash, Read, Glob, Grep
10192
10473
  effort: medium
10193
- color: yellow
10474
+ color: pink
10194
10475
  model: inherit
10195
10476
  ---
10196
10477
 
@@ -10252,6 +10533,15 @@ model: inherit
10252
10533
 
10253
10534
  若任一条件不满足,跳过快速通道,执行完整审查流程。
10254
10535
 
10536
+ ## 工作流模式感知(fast 单轮)
10537
+
10538
+ 调度前读取当前阶段 \`status.md「工作流模式」\`(权威查询 \`openfeel flow mode [--stage <id>]\`):
10539
+
10540
+ - **full**:计划审查 + 代码审查(多轮位点,现状不变)。
10541
+ - **fast(工作流快线)**:**单轮 ×2,两处均必跑**——① \`plan_review\` **计划审查(fast 下必经**,与代码审查同级;通过 → \`plan_passed\`,问题退回 → \`plan_pending\`);② exec 后代码审查(\`review_failed\` 回环可重审 / 回执行修复);**质量底线不变**(问题照记、阻断照留,REV 条目照常)。
10542
+
10543
+ > **术语消歧**:本节的「**工作流快线**」(\`workflow_mode=fast\`,流程模式)与本模板「**快速通道 / fast track(FAST-PASS)**」(审查深度降级机制)为**不同机制**、同名异义——不得互相引用 / 混用。
10544
+
10255
10545
  ## REV 模板规范
10256
10546
 
10257
10547
  \`\`\`yaml
@@ -10295,7 +10585,7 @@ openfeel-reviewer 由 **Claude 侧模型**决定(默认 \`model: inherit\`)
10295
10585
  | 需判定(默认阻塞) | 编码规范严重违反 / 跨模块一致性问题 | \`true\` |
10296
10586
  | 非阻塞 | 命名建议 / 注释完善 / 风格微调 / 优化建议 | \`false\` |
10297
10587
 
10298
- > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。
10588
+ > 快速通道命中时,REV 默认 \`blocking=false\`(安全漏洞除外)。该机制与「工作流快线」无关——见「工作流模式感知」节。
10299
10589
 
10300
10590
  ## blocking 与流水线行为
10301
10591
 
@@ -10411,6 +10701,7 @@ model: inherit
10411
10701
 
10412
10702
  - 接收**主会话**调度启动,产出方案经 openfeel-reviewer 审查后交 openfeel-executor 执行
10413
10703
  - 审查不通过时,根据 openfeel-reviewer 反馈重新制定方案
10704
+ - **工作流模式感知**:fast 工作流快线下本 Agent **不被调度**(依据 \`status.md「工作流模式」\` 跳过方案环节);职责定义不变。
10414
10705
 
10415
10706
  ## 注意事项
10416
10707
 
@@ -10573,7 +10864,7 @@ Not all tasks must go through the full pipeline. Non-coding tasks and coding tas
10573
10864
  | Task Type | Handling Path | Notes |
10574
10865
  |-----------|---------------|-------|
10575
10866
  | Research/exploration (reading code, consulting references, locating issues) | The main session (Feel role) → research (\`general\` / \`Explore\` subagent) | Read-only exploration, no source code changes; flow.json need not spin up for this |
10576
- | Coding implementation (adding/modifying source code) | Full pipeline (openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) | Involves source changes, must go through the full audit chain |
10867
+ | Coding implementation (adding/modifying source code) | Full pipeline (openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) (full); in fast mode: planner → plan review (reviewer, single mandatory round) → executor → code review (reviewer) → archiver (see status.md "Workflow Mode" / openfeel flow mode) | Involves source changes, must go through the full audit chain (fast-line audit chain in fast mode) |
10577
10868
  | Selection discussion (settling a technical approach / design trade-off) | The main session (Feel role) and the user + the \`AskUserQuestion\` tool | Conversational decision, produces a conclusion, no plan.md |
10578
10869
 
10579
10870
  > Non-coding tasks (research, selection discussion) do not require creating a plan or advancing the pipeline; the pipeline is engaged only when source changes or a formal plan document is produced.
@@ -10636,7 +10927,7 @@ When encountering technical issues, **the first action MUST be to consult the kn
10636
10927
  - openfeel-utility Agent performs mechanical file operations, does not participate in design decisions
10637
10928
  - openfeel-archiver archives and distills knowledge, does not modify source code; does not write flow.json directly (written via the **main session**)
10638
10929
 
10639
- 3. **Main session orchestration constraint**: The **main session (Feel role)**, as the overall commander, uniformly orchestrates downstream subagents (openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / openfeel-utility Agent / openfeel-vision / openfeel-archiver), advancing serially via the **Task** tool according to pipeline phases (plan → scheme → execute → review → test → archive). Each Agent operates only within its own responsibility boundary and must not start other Agents beyond its scope or modify flow.json state on its own.
10930
+ 3. **Main session orchestration constraint**: The **main session (Feel role)**, as the overall commander, uniformly orchestrates downstream subagents (openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / openfeel-utility Agent / openfeel-vision / openfeel-archiver), advancing serially via the **Task** tool according to pipeline phases (plan → scheme → execute → review → test → archive) (full); in fast mode: plan → plan review → execute → code review → archive (see status.md "Workflow Mode" / openfeel flow mode). Each Agent operates only within its own responsibility boundary and must not start other Agents beyond its scope or modify flow.json state on its own.
10640
10931
 
10641
10932
  4. **Lightweight decision boundary**: Conversational selections (the **main session** and the user settle a technical direction or design trade-off via the \`AskUserQuestion\` tool, producing a conclusion but no plan.md) are handled by the **main session** directly, without delegating to openfeel-planner; only when a **formal plan document** (plan.md, including stage division, task table, constraint table) is needed, or the planning scale threshold is reached, should openfeel-planner be delegated. Avoid the extremes of "handle everything personally" or "delegate everything".
10642
10933
 
@@ -10692,7 +10983,7 @@ Version progression must be prudent, using the four-level X.Y.Z.W version number
10692
10983
  | Level 4 (W) | Feature detail | Independently committed feature or submodule |
10693
10984
 
10694
10985
  When Feel starts a new version, it defaults to incrementing the fourth level (W+1), unless the user explicitly specifies otherwise.
10695
- The OpenFeel framework has released the official v1.0.x (currently v1.1.6). After deploying the global constraints via openfeel setup, new projects set their own starting version number as needed.
10986
+ The OpenFeel framework has released the official v1.0.x (currently v1.1.7). After deploying the global constraints via openfeel setup, new projects set their own starting version number as needed.
10696
10987
 
10697
10988
  ### Module Manuals
10698
10989
 
@@ -11085,7 +11376,7 @@ AI Agent 行为约束与编码规范。本文件为永久性约束,适用于
11085
11376
  | 任务类型 | 处理路径 | 说明 |
11086
11377
  |----------|----------|------|
11087
11378
  | 调研/探索(读代码、查资料、定位问题) | 主会话(Feel 角色)→ research(\`general\` / \`Explore\` subagent) | 只读探索,不产出源码变更,flow.json 不必为此空转 |
11088
- | 编码实现(新增/修改源码) | 完整流水线(openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester) | 有源码变更,须走完整审计链 |
11379
+ | 编码实现(新增/修改源码) | 完整流水线(openfeel-planner → openfeel-schemer → openfeel-executor → openfeel-reviewer → openfeel-feel-tester)(full);fast 工作流快线(workflow_mode=fast)下为 planner → 计划审查(reviewer,单轮必经)→ executor → 代码审查(reviewer)→ archiver——见 status.md「工作流模式」 / openfeel flow mode | 有源码变更,须走完整审计链(fast 走快线审计链) |
11089
11380
  | 选型讨论(敲定技术方案/设计取舍) | 主会话(Feel 角色)与用户 + \`AskUserQuestion\` 工具 | 对话式决策,产出结论,不产出 plan.md |
11090
11381
 
11091
11382
  > 非编码任务(调研、选型讨论)不强制创建计划或推进流水线;仅当产生源码变更或正式计划文档时才接入流水线。
@@ -11148,7 +11439,7 @@ AI Agent 行为约束与编码规范。本文件为永久性约束,适用于
11148
11439
  - 事务官 执行文件机械操作,不参与设计决策
11149
11440
  - openfeel-archiver 归档和沉淀知识,不修改源码;不直写 flow.json(通过**主会话**写入)
11150
11441
 
11151
- 3. **主会话调度约束**:**主会话(Feel 角色)**统一调度下游 subagent(openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / 事务官 / openfeel-vision / openfeel-archiver),通过 **Task** 工具按流水线阶段(计划→方案→执行→审查→测试→归档)串行推进。各 Agent 仅在自己的职责边界内操作,不得越界启动其他 Agent 或自行修改 flow.json 状态。
11442
+ 3. **主会话调度约束**:**主会话(Feel 角色)**统一调度下游 subagent(openfeel-planner / openfeel-schemer / openfeel-executor / openfeel-reviewer / openfeel-feel-tester / 事务官 / openfeel-vision / openfeel-archiver),通过 **Task** 工具按流水线阶段(计划→方案→执行→审查→测试→归档)串行推进(full);fast 工作流快线下为 计划 → 计划审查 → 执行 → 代码审查 → 归档(见 status.md「工作流模式」 / openfeel flow mode)。各 Agent 仅在自己的职责边界内操作,不得越界启动其他 Agent 或自行修改 flow.json 状态。
11152
11443
 
11153
11444
  4. **轻量决策边界**:对话式选型(**主会话**与用户通过 \`AskUserQuestion\` 工具敲定技术方向/设计取舍,产出结论不产出 plan.md)由**主会话**直接处理,不委托 openfeel-planner;仅当需要**产出正式计划文档**(plan.md,含阶段划分、任务表、约束表)或达到规划规模阈值时,才委托 openfeel-planner。避免"要么全亲为、要么全委托"的极端。
11154
11445
 
@@ -11204,7 +11495,7 @@ Claude Code 的权限与工具可用性由 subagent 的 \`tools\` 白名单与 \
11204
11495
  | 四级(W) | 功能细节 | 独立提交的功能或子模块 |
11205
11496
 
11206
11497
  Feel 启动新版本时默认使用四级版本递增(W+1),除非用户明确指定。
11207
- OpenFeel 框架已发布正式版 v1.0.x(当前 v1.1.6)。新项目经 openfeel setup 部署全局约束后,按自身需求设定起始版本号。
11498
+ OpenFeel 框架已发布正式版 v1.0.x(当前 v1.1.7)。新项目经 openfeel setup 部署全局约束后,按自身需求设定起始版本号。
11208
11499
 
11209
11500
  ### 模块手册
11210
11501