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.
- package/README.en.md +13 -2
- package/README.md +10 -1
- package/README.zh-CN.md +13 -2
- package/dist/commands/config.d.ts.map +1 -1
- package/dist/commands/config.js +66 -4
- package/dist/commands/config.js.map +1 -1
- package/dist/commands/flow.d.ts +8 -0
- package/dist/commands/flow.d.ts.map +1 -1
- package/dist/commands/flow.js +169 -10
- package/dist/commands/flow.js.map +1 -1
- package/dist/commands/plan.d.ts.map +1 -1
- package/dist/commands/plan.js +59 -2
- package/dist/commands/plan.js.map +1 -1
- package/dist/commands/stage.d.ts.map +1 -1
- package/dist/commands/stage.js +56 -2
- package/dist/commands/stage.js.map +1 -1
- package/dist/core/config.d.ts +17 -2
- package/dist/core/config.d.ts.map +1 -1
- package/dist/core/config.js +21 -6
- package/dist/core/config.js.map +1 -1
- package/dist/core/flow-manager.d.ts +71 -14
- package/dist/core/flow-manager.d.ts.map +1 -1
- package/dist/core/flow-manager.js +266 -51
- package/dist/core/flow-manager.js.map +1 -1
- package/dist/core/i18n-data/en.d.ts.map +1 -1
- package/dist/core/i18n-data/en.js +25 -3
- package/dist/core/i18n-data/en.js.map +1 -1
- package/dist/core/i18n-data/zh-CN.d.ts.map +1 -1
- package/dist/core/i18n-data/zh-CN.js +26 -3
- package/dist/core/i18n-data/zh-CN.js.map +1 -1
- package/dist/core/pipeline-schema.d.ts +5 -0
- package/dist/core/pipeline-schema.d.ts.map +1 -1
- package/dist/core/pipeline-schema.js +5 -0
- package/dist/core/pipeline-schema.js.map +1 -1
- package/dist/core/plan/scheme.d.ts +22 -0
- package/dist/core/plan/scheme.d.ts.map +1 -1
- package/dist/core/plan/scheme.js +71 -2
- package/dist/core/plan/scheme.js.map +1 -1
- package/dist/core/plan/stage.d.ts +2 -0
- package/dist/core/plan/stage.d.ts.map +1 -1
- package/dist/core/plan/stage.js +8 -0
- package/dist/core/plan/stage.js.map +1 -1
- package/dist/core/template-loader.d.ts.map +1 -1
- package/dist/core/template-loader.js +353 -62
- package/dist/core/template-loader.js.map +1 -1
- package/dist/core/update.d.ts.map +1 -1
- package/dist/core/update.js +45 -12
- package/dist/core/update.js.map +1 -1
- 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: "#
|
|
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: "#
|
|
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: "#
|
|
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
|
|
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: "#
|
|
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: "#
|
|
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: "#
|
|
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.
|
|
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\`
|
|
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.
|
|
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: "#
|
|
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: "#
|
|
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: "#
|
|
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
|
|
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: "#
|
|
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: "#
|
|
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: "#
|
|
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
|
|
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.
|
|
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
|
|
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]\`(**
|
|
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
|
-
|
|
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
|
-
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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.
|
|
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**
|
|
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.
|
|
11498
|
+
OpenFeel 框架已发布正式版 v1.0.x(当前 v1.1.7)。新项目经 openfeel setup 部署全局约束后,按自身需求设定起始版本号。
|
|
11208
11499
|
|
|
11209
11500
|
### 模块手册
|
|
11210
11501
|
|