OpenFeel

OpenFeel CLI 工具链体验反馈(计划落地视角)

提交背景:2026-09-28 会话在 Pantheogen 项目执行「三阶段计划落地」——用 OpenFeel CLI 把正式计划落成 flow.json 阶段 + .openfeel/plan/ 结构,并推进 v0.0.1 至方案阶段。以下是 Feel 总统领(主力推理模型驱动)在把计划落地为流水线过程中遇到的具体工具链问题,供 OpenFeel 项目维护者参考。 关联:本文档为 CLI/工具链视角,承接 docs/04-openfeel-feedback.md(Agent 与提示词框架视角)。


一、本次落地做了什么

步骤 命令
退役遗留阶段 openfeel flow advance --stage phase1 --to done --force
建分期大纲 openfeel roadmap create 0.0
建三个工作阶段 openfeel plan stage add v0.0.1-stage-01(×3)
推进阶段相位 openfeel flow advance --stage v0.0.1-stage-01 --to plan_review / plan_passed / scheme_pending
建操作方案 openfeel plan scheme create "v0.0.1-stage-01" "<title>"(×4,由 schemer 执行)

二、亮点(建议保留)

  1. plan stage add 一步成型:自动创建 plan/{series}/stage-NN/(overview.md + status.md)并同步注册到 flow.json。
  2. flow advance --dry-run 实用:预演合法性检查,避免误改状态机。
  3. 自检闭环完整:flow health / flow repair --dry-run 能给出可读诊断。
  4. plan scheme create 自动编号 + op 注册同步,模板统一、幂等(已存在不覆盖)。

三、问题(按严重度排序)

问题 1(高):缺「移除阶段」命令,遗留阶段只能 force 退役

问题 2(高):--help 不自描述 phase 枚举与合法转移,迫使 Agent 翻包源码

问题 3(高):stageId 命名 / 目录映射约定未文档化,与计划命名天然冲突

问题 4(中):plan stage add 不支持声明依赖(deps)

问题 5(中):auto_advance 配置优先级两处口径冲突

问题 6(中):flow status 的 current 不回退,显示已 done 阶段为「活跃」

问题 7(中):CLI 关键状态变更不写 flow.json 审计日志

问题 8(低):非 git 仓库时 flow advance 打印 fatal: not a git repository

问题 9(低):stage create 与 plan stage add 职责重叠、易混

四、改进建议汇总

# 问题 建议 优先级
1 无移除阶段命令 新增 flow stage remove(带安全校验) 高
2 help 不含 phase / 转移 新增 flow phases 或内联转移表 高
3 命名约定未文档化 文档化 + 非法 id 给建议名 高
4 无 deps 声明 plan stage add --deps 或 flow deps set 中
5 auto_advance 口径冲突 统一口径 + config 显示有效值来源 中
6 current 不回退 失效时自动回退首个非 done 中
7 CLI 操作不写审计日志 状态变更类操作统一 append log 中
8 非 git 噪声 静默跳过 低
9 命令职责重叠 合并 / 重命名 低

五、一句话总结

OpenFeel CLI 的「阶段 / 方案 / 推进」能力可用且设计合理(dry-run、health、自动同步是亮点),但在「计划 → 流水线」的落地环节缺少自描述与纠错能力:Agent 必须翻包源码才知道合法 phase 与目录约定,且无法删除误建阶段、无法声明依赖、关键操作不留审计日志。建议优先补齐两类能力——自描述(phases / 命名约定)与可纠错(remove / deps)。


本文档为 Feel 总统领的一手工具链反馈,供 OpenFeel 项目维护者参考。