提交背景:2026-09-29 ~ 09-30,Pantheogen 项目。本会话连续推进 13 个阶段(v0.0.1 ~ v0.3.0-stage-12),全程使用 OpenFeel CLI 管理
flow.json/ 计划目录 / 阶段状态。过程中暴露出「状态一旦写错就修不回来」这一类系统性问题,本文件逐条记录,供 OpenFeel 维护者参考。 关联:docs/06-openfeel-tooling-feedback.md(计划落地视角)、docs/07-openfeel-permission-issue.md(权限模型)。
OpenFeel CLI 在「创建」侧能力齐备,但在「纠正 / 清理」侧近乎空白:
flow.json。这导致一条硬性纪律——「禁止手动编辑 flow.json」——在故障恢复场景下无解。
openfeel plan scheme create 每次调用都会向 flow.json 的 stages[].ops 追加一个 op 条目。本会话方案官(openfeel-schemer)在 stage-10 一次多创建了 5 个(op-006 ~ op-010),生成的模板文件已删除,但 flow.json 中 5 个条目永久残留(state=pending)。openfeel flow repair --dry-run 输出「未检测到需要修复的问题」——不清理孤儿 op;openfeel flow stage 只有 add;openfeel plan scheme 只有 create/list。无任何删除子命令。openfeel plan scheme remove <stage> <opId>(带校验:文件不存在 / 无 checkpoint / 非 done 时可删);flow repair 增加「孤儿 op 检测与清理」。flow.json 手工编辑是唯一出路,与硬性纪律冲突deps 字段的设置,都没有 CLI 途径。plan stage add 与 plan scheme create 的阶段注册语义不一致openfeel plan stage add <id>:建目录 + 写 overview/status + 注册 flow.json(phase=plan_pending)。openfeel plan scheme create <stage>:若阶段不存在则自动注册(phase=plan_pending),并 mkdir ops/,但不建 overview.md/status.md。plan stage add 而先跑 scheme create,阶段会被「半注册」;此时 flow advance --stage <id> --to scheme_pending 报错:
错误: 阶段 "<id>" 当前 phase 无法跳转到 "scheme_pending"
当前阶段 phase: 未知
错误信息误导(说「未知」,实际是 plan_pending,只是缺少合法的中间相位跳转)。
scheme create 不应隐式注册阶段;flow advance 报错时应回显当前真实 phase 与合法目标列表。flow attempt 不回写 pipeline.current.opflow attempt --op "stage.op-001" --result pass … 直到 op-005,flow current 的 current.op 始终停在 op-001。current.op 滞后」的偏差说明(本会话 10+ 次);跨会话恢复时容易误判进度。flow attempt 成功记录后同步推进 current.op;或提供 flow current --set <opId>。stage set 同值写入报错,且留下 .bak 垃圾openfeel stage set <id> --status review_passed 在 status.md 已是该值时报错退出,并在 .openfeel/tmp/ 留下 status.<id>.bak。.bak 文件累积。.bak 仅在真正变更时生成。openfeel config 仅能设置 auto_advance 一个键openfeel config set defaults.execution_mode auto → 无效的配置键 "defaults.execution_mode",当前仅支持:auto_advance。execution_mode / test_enabled / merge_mode 只能手改 .openfeel/config.yaml(本会话不得不如此);阶段级 执行模式 / 自动推进 字段完全无 CLI(stage set 仅支持 --status)。defaults.* 全量键纳入 config set/get;stage set 增加 --review-agent / --exec-mode / --auto-advance 等选项。stage task 在无任务行的 status.md 上直接报错plan stage add 生成的 status.md 没有「当前任务」条目(方案官也不一定会补)。此时 openfeel stage task <id> 1 --done → 错误:未找到「任务 1」。stage task 增加 --add "描述" 追加任务;或在 plan stage add 时支持 --tasks 初始化。flow advance 打印「Git 脏区警告」框[!] ╔════════════════════════════════════════╗
[!] ║ ⚠ Git 脏区警告:存在未提交的变更 ║
[!] ║ 请确认 Executor 已完成 git commit ║
[!] ╚════════════════════════════════════════╝
每个 advance 都打印,即使脏区是正常的中间状态(方案/归档产物本就未提交)。
--quiet / 仅在 --to done 时提示;或按「是否存在未提交的源码变更」判定而非全仓库。knowledge CLI 无法解析自定义 kb/index.mdopenfeel knowledge list --type patterns 与既有 kb/index.md(无日期格式)不兼容;归档官反复记录「kb-dedup.ts 不存在 → 降级手工去重」。kb/index.md 的可解析格式规范,或让 knowledge 容忍任意 Markdown 结构。log/2026-09-28/2026-09-28-Liuary-001.md(会话初期)与 log/2026/09/28/2026-09-28-Liuary-001.md(归档官后续创建)同时存在,索引各自维护。openfeel init 时固定;提供迁移命令。plan scheme create 的文件名不符合自身约定op-001_{中文标题}.md(含空格/中文/甚至 /),而项目既有约定与 kb 记录均为 op-NNN.md;标题含 / 时创建直接失败(方案官实际踩到)。op-NNN.md,标题写入文件内容而非文件名;或对标题做安全化(去除路径分隔符)。| # | 问题 | 建议 | 优先级 |
|---|---|---|---|
| 1 | 孤儿 op 无法回收 | plan scheme remove + flow repair 清理孤儿 |
高 |
| 2 | 结构字段无 CLI,只能手改 | 提供 ops/deps/reviews 的增删改;或明确授权例外 | 高 |
| 3 | 阶段注册语义不一致 + 误导性报错 | scheme create 不隐式注册;报错回显真实 phase 与合法目标 |
高 |
| 4 | current.op 不回写 |
flow attempt 同步推进指针 |
中 |
| 5 | stage set 同值报错 + .bak 垃圾 |
同值 no-op 返回成功;按需生成备份 | 中 |
| 6 | config 仅支持一个键 |
纳入全量 defaults.*;stage set 增加字段选项 |
中 |
| 7 | stage task 无任务行即报错 |
支持 --add / plan stage add --tasks |
中 |
| 8 | git 脏区警告噪声 | 加 --quiet 或按源码变更判定 |
低 |
| 9 | knowledge 不解析自定义 index |
规范格式或宽容解析 | 低 |
| 10 | 日志目录两套布局 | 统一布局 + 迁移命令 | 低 |
| 11 | op 文件名含中文// |
固定为 op-NNN.md |
低 |
本会话跑了 13 个阶段,CLI 的创建与推进侧体验顺滑;但只要写错一次(多建 5 个 op),就没有任何合法手段改回来——flow repair 不管、CLI 无删除、手改被禁。建议优先补齐 「删除与修正」 能力(op remove / deps set / repair 覆盖孤儿)、统一阶段注册语义,并让 stage set / config set 覆盖 Agent 真正需要写的字段。
本文档为 Feel 总统领的一手工具链反馈(第二轮),供 OpenFeel 项目维护者参考。