OpenFeel

OpenFeel 工具链反馈(三):可编排性与可观测性

提交背景:2026-09-29 ~ 10-01,Pantheogen 项目。本会话完整跑完 19 个阶段(v0.0.1 ~ v0.3.0.3-stage-19),涵盖四个开发周期与三期补充子版本,累计 CLI 调用数百次、跨 agent 委托上百次。本文档聚焦「长时间、多阶段自动推进」场景下的 CLI 可编排性与可观测性缺口,供 OpenFeel 维护者参考。 关联:docs/06-openfeel-tooling-feedback.md(计划落地视角)、docs/07-openfeel-permission-issue.md(权限模型)、docs/08-openfeel-workflow-feedback.md(状态维护与可维护性)。本文只记新增项,不重复前作。


一、本会话的规模(说明为何这些缺口重要)

指标 数值
完成阶段 19(全部 done)
里程碑 M1 ~ M17
相位推进 每阶段约 5~7 次 flow advance,累计 上百次
stage set 校正 单次批量修正 11 个阶段(逐条调用)
op 文件中文名改名 7 个阶段的方案官各自手工改名
委托下游 agent 上百次(planner / schemer / executor / reviewer / archiver / utility)

核心结论:单阶段使用时体验尚可;一旦进入「多阶段长链自动推进」,缺少批量操作、缺少机器可读输出、缺少自愈能力这三类缺口会持续放大——每一次推进都是多次人工拼接,且状态漂移只能靠人工发现。


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

问题 1(高):CLI 无机器可读输出,且 Windows 控制台中文乱码

问题 2(高):无「状态批量校正」能力,flow health 只报不改

问题 3(中):正常中间态被误报为错误

问题 4(中):Agent 任务中断后无恢复检测

问题 5(中):相位推进只能逐步调用,无路径预览/一次到位

问题 6(中):op 元数据(标题)无更新命令

问题 7(低,复发):op 文件名含中文/空格,方案官每阶段都要手工改名

问题 8(低,复发):公共日志目录两套布局并存


三、建议汇总

# 问题 建议 优先级
1 无机器可读输出 / 控制台乱码 UTF-8 + --json + NO_COLOR 高
2 无批量状态校正 flow health --fix / flow advance 自动同步 status.md 高
3 正常中间态误报错误 无 op 阶段降为提示级 中
4 中断后无恢复检测 flow ops list + 空模板 warning + draft→pending 中
5 推进只能逐步调用 advance --to <phase> 自动逐步 + --dry-run 路径预览 中
6 op 标题不可改 plan scheme rename 中
7 op 文件名含中文 固定 op-NNN.md(复发,建议上调优先级) 低→中
8 日志目录双布局 统一 + 迁移(复发) 低

四、一句话总结

本会话把流水线跑到了 19 个阶段、4 个周期,CLI 单点能力可靠、拒绝非法操作也很准确;但「长链自动推进」缺三样东西——批量编排(一次到位/批量校正)、机器可读(--json/UTF-8)、自愈恢复(--fix/空模板检测)。补齐这三样,OpenFeel 才能从「能支撑单阶段自动化」走到「能支撑整周期无人值守」。


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