OpenFeel

OpenFeel 工具链反馈(二):流水线状态维护与 CLI 可维护性

提交背景: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」——在故障恢复场景下无解。


二、问题清单(按严重度)

问题 1(高):op 条目只增不减,孤儿条目无法回收

问题 2(高):flow.json 手工编辑是唯一出路,与硬性纪律冲突

问题 3(高):plan stage add 与 plan scheme create 的阶段注册语义不一致

问题 4(中):flow attempt 不回写 pipeline.current.op

问题 5(中):stage set 同值写入报错,且留下 .bak 垃圾

问题 6(中):openfeel config 仅能设置 auto_advance 一个键

问题 7(中):stage task 在无任务行的 status.md 上直接报错

问题 8(低):git 仓库存在时,每次 flow advance 打印「Git 脏区警告」框

问题 9(低):knowledge CLI 无法解析自定义 kb/index.md

问题 10(低):公共日志目录存在两套布局并存

问题 11(低):plan scheme create 的文件名不符合自身约定


三、改进建议汇总

# 问题 建议 优先级
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 项目维护者参考。