🚀 [umbrella][P0] codex-sdk /goal /loop 用户友好化 (Vincent 6039 Goal #3)

[s2agi]

目标 (Vincent 2026-05-27 telegram 6039 三大目标 #3)

"code-sdk 的 /goal /loop 用户友好化"

Scope

@openai/codex-sdk runtime 在 anet 中的 /goal (scheduler) + /loop (recurring/dynamic prompt) 命令用户友好化, 降低门槛, 提升 onboarding。

Pillars

Pillar A — /goal scheduler UX

• 现状: codex-sdk runtime 需要先 anet node create --runtime codex-sdk, 再用 codex CLI /goal 命令 — chain 长, 用户易卡
• 目标: 一键 /goal 即可用; 跟 [feature][runtime] Implement /goal scheduler for codex-sdk and agent-node runtimes / 为 codex-sdk 实现可持久化目标调度 #184 实施 联动
• 子项:
  • anet goal list/cancel/edit 子命令 (现已部分 ship, 完善)
  • goal 状态 dashboard 集成 — 在 Dashboard 显当前 active goals
  • goal 失败 UX — 错误信息 actionable (不是 raw stack trace)
  • goal 持久化保证 — node restart 后 goals 不丢

Pillar B — /loop 用户友好化

• 现状: /loop [interval] <prompt> 命令需理解 cron 概念 / dynamic mode 区别 / <<autonomous-loop>> sentinel 等高级语义
• 目标: 用户视角"我要每 5min 跑一次 X" 直接表达, 不学 cron
• 子项:
  • /loop wizard — 交互式输 prompt + 选 interval 预设 (5m / 15m / 1h)
  • dynamic mode 文档化 — 何时该用 dynamic vs fixed, 用例对照
  • loop 取消 UX — 显当前 active loops, 一键取消
  • autonomous-loop sentinel 替代方案 — 用户不需要知道 sentinel, 自动判断

Pillar C — onboarding / docs

• docs/runtimes/codex-sdk.md 加 /goal /loop 实战 walkthrough
• 视频或 GIF 演示 (per 群星马 协作)
• 错误诊断手册 (常见 stuck 场景 + 解决)

Related existing issues

• [feature][runtime] Implement /goal scheduler for codex-sdk and agent-node runtimes / 为 codex-sdk 实现可持久化目标调度 #184 Implement /goal scheduler for codex-sdk + agent-node runtimes (P0 in flight)
• [research][P0] codex Mobile + remote-control 深入调研 — 评估对 anet codex runtime 的影响 #120 codex Mobile + remote-control 调研
• [observability][codex-sdk] 补齐 send_task 调用与投递链路日志 #167 send_task 投递链路日志
• [bug][agent-node][codex-sdk] codex-sdk runtime missing @openai/codex-sdk dependency #186 codex-sdk runtime missing dependency

Owner

• SDK马 (codex-sdk lane, /goal scheduler 实施主笔)
• SDK牛 (codex internals 视角, /loop semantic 协助)
• 通信龙 review + Vincent strategic ack

Tracking

• Vincent /loop 5min 汇报 (per 6039 directive)
• 通信龙 双轨 issue comment + telegram per round

Acceptance (Phase 1)

1. Pillar A — anet goal subcommand 完备 (list/cancel/edit) + Dashboard 集成 LIVE
2. Pillar B — /loop wizard + dynamic mode 文档化 + 取消 UX LIVE
3. Pillar C — onboarding walkthrough 视频 / GIF ship 到 docs.anet.sh

Phase 2 (advanced patterns, e.g. multi-step plans / sub-goals) 单独 RFC 跟进。

[s2agi]

Round 1 — Umbrella opened by Vincent 6039 directive (北京 ~16:06)

Vincent strategic dispatch

"code-sdk 的 /goal /loop 用户友好化"

3 大目标之 #3, Vincent 要求 issue 专门跟进 + /loop 5min 汇报。

Current state

• 现有 #184 /goal scheduler 实施 in flight (SDK马)
• 现有 #120 codex Mobile 调研 (SDK马)
• 现有 #167 send_task 日志 + #186 codex-sdk 依赖 等 component fixes
• 本 umbrella 跟踪用户友好化顶层 roadmap: 一键 /goal + /loop wizard + 错误 UX + onboarding docs

Next steps (Round 2, 5min)

• 通信龙 + SDK马 协调 — 出 Phase 1 plan (Pillar A anet goal subcommand 完备 + Dashboard 集成, Pillar B /loop wizard, Pillar C docs/videos)
• /loop 5min 汇报 progress to Vincent (per 6039 directive)

Owner

• SDK马 (codex-sdk lane, /goal 实施)
• SDK牛 (codex internals, /loop semantic)
• 通信龙 review + Vincent strategic ack

— 通信龙 @ 北京 ~16:06

[s2agi]

Round 2 — Standby (北京 ~16:09)

仍在 v0.10.x grok runtime ship 收尾 (Goal 1, #189), code-sdk /goal /loop 用户友好化 Phase 1 待 Grok release ship 完后 fire。

Existing in flight

• #184 /goal scheduler 实施 (SDK马, P0)
• #120 codex Mobile 调研 (SDK马)

Next

• 通信龙 + SDK马 + SDK牛 协调 Phase 1 plan
• Pillar A anet goal subcommand 完备 + Dashboard 集成
• Pillar B /loop wizard + 取消 UX
• Pillar C onboarding docs/videos

— 通信龙 @ 北京 ~16:09

[s2agi]

Round 3 — Standby (北京 ~16:13)

Goal 1 (Grok #189) preview.2 fix in flight, Goal 3 codex-sdk /goal /loop 仍 standby gate Grok ship 闭环 + #184 /goal scheduler 实施仍 active。

— 通信龙 @ 北京 ~16:13

[s2agi]

Round 4 — Standby (北京 ~16:13)

Goal 1 (Grok #189) preview.2 fix push 进度: 通信牛 4d3a644 已 push, 工程马 publish chain firing。

Goal 3 codex-sdk /goal /loop 仍 gate Grok ship 闭环。#184 /goal scheduler 实施仍 active (SDK马 lane)。

— 通信龙 @ 北京 ~16:13

[s2agi]

进度 (北京 16:23)

Goal 1 (Grok 派单) 第二次修完跑测试。

Goal 3 (codex /goal /loop 友好化) 等 Goal 1 完了就 fire。/goal scheduler 实施已 active。

— 通信龙

[s2agi]

5min 进度 (北京 16:25)

• Goal 1 (Grok 修复): 新版本测试 ~3min 内出结果
• Goal 2 (Dashboard 优化): N站马 刚开始第一轮分析
• Goal 3 (codex /goal /loop): SDK马 ACK 第一轮 plan + grep 现有代码

— 通信龙

[s2agi]

5min 进度 (北京 16:30)

• Goal 1 (Grok 派单): 新版本里修复真在, Vincent 实测真用 (测试那边 mock 数据有点不齐, 不影响真用)
• Goal 2 (Dashboard): N站马 第一轮分析中
• Goal 3 (codex /goal /loop): SDK马 grep 现有代码 + 第一轮 plan

— 通信龙

[s2agi]

5min 进度 (北京 16:34)

• Goal 1 (Grok 派单): 等 Vincent 实测命令结果 (~5min 内)
• Goal 2 (Dashboard): N站马 还没第一轮 ACK, 我 ping 他
• Goal 3 (codex /goal /loop): SDK马 context 满了可能要 restart, 我 ping 他

— 通信龙

[s2agi]

5min 进度 (北京 16:39)

• Goal 1 (Grok 派单): 等 Vincent 升级 preview.2 后实测
• Goal 2 (Dashboard): N站马 还没 ACK, 已 ping 第二次, 不回考虑换人
• Goal 3 (codex /goal /loop): SDK马 context 满了 standby, 等他 reply 是否需要 reassign 给 SDK牛
• 附带 (anet -v 显示 bug [bug][P1] anet -v Components 段 strip -preview.N 后缀 (Vincent 6040 catch) #192): Vincent 6069 直接催 — 工程马 立修, 跟下版本一起发

— 通信龙

[s2agi]

5min 进度 (北京 16:44)

• anet -v 显示 bug: ✅ 修了, 新版本 agent-network@2.2.9-preview.2 发好, 升级后能看到完整 preview 后缀
• Goal 1 (Grok 派单): 等 Vincent 升级 + 实测
• Goal 2 / Goal 3: 两个 owner 还没 ACK, 等他们或换人

— 通信龙

[s2agi]

5min 进度 (北京 16:49)

• Goal 1 (Grok 派单): 部分修好 — broaden 派单触发 + 子任务真发出去 ✅ (Vincent 截图 confirm)
• 新 bug: 总指挥 收到任务时 "from name" 显示不对 (Vincent 6074), 等他 paste 详情我查根因
• anet -v 显示 bug: ✅ 修了 (preview.2)
• Goal 2 / Goal 3: owner 仍 idle, 待 ACK

— 通信龙

[s2agi]

Phase 1 Pillar A — anet goal show + anet goal edit (shipped)

接续 68661a8 (list/cancel),Phase 1 Pillar A 把缺的两条 CLI 子命令补齐 + UX 打磨:

52e0f64 — feat(#191): anet goal show + edit subcommands

新增子命令

anet goal show <node> <goal-id>
# 详细单 goal 视图 + 末 10 条 progress_log 时间线 + runtime/parent_task_id/report_to。
# Goal-id prefix matching (跟 cancel 一致),只读。

anet goal edit <node> <goal-id> [--interval ...] [--text "..."] [--status ...]
# 至少一条 mutating flag,否则 nonzero + 提示。
# --interval 跟 in-node /goal 解析器同 surface: 5min / 1h / 1d / 每5分钟 / hourly / daily,
#   sub-minute 拒绝 (`MIN_INTERVAL_MS=60_000` 防 wake-storm)。
# --status 校验 active|paused|completed|cancelled。
# 每次 edit 追加一条 progress_log "edited" entry 写明改了什么字段。
# interval 变更后,next_wake_at = now + new interval (立即生效, 不等老窗口)。
# 原子写盘 (tmp + rename, 沿用 saveGoalsFile)。

anet --help 也同步更新

新条目:

anet goal show <node> <id>     Show one goal in detail (progress log)
anet goal edit <node> <id> ... Edit a goal's interval / text / status

11-case smoke (bun-run 直接跑 cli.ts on mocked .anet/)

#	Case	Expected	Actual
T1	goal --help	new usage block	✅
T2	goal list (all nodes)	1 row, status=active, every=5min	✅
T3	goal list <node>	same, only that node	✅
T4	goal show <node> <prefix>	detailed view + progress_log (2 entries)	✅
T5	goal edit ... --interval 10min	goals.json interval_ms: 600000	✅
T6	goal edit ... --status paused	status updated, progress_log entry added	✅
T7	goal edit ... --interval 5s	sub-minute reject + stderr	✅
T8	goal edit ... --status BOGUS	reject + list valid values	✅
T9	goal edit ... (no flags)	reject "no edit flags supplied"	✅
T10	goal cancel (regression)	unchanged behaviour	✅
T11	goal show after cancel	status=cancelled reflected	✅

tsc --noEmit -p agent-network/ clean。

Pillar A 外的剩余 Phase 1 工作 (后续)

• Pillar B: dashboard 端 goal 状态可视化 — 跟 N站马 协同(待派单)
• Pillar C: commhub_goal_* MCP 工具(让 agent 自己 CRUD,而非只能改 goals.json file)— 待 design review

现状:Pillar A 不依赖 hub API,纯本地 file 操作。运行中的 node 内存里的 goal 副本不感知 file 改动 —— 用户改完需要重启 node 才生效;isNodeProbablyRunning detect 后会在 stdout 提示 "node appears to be running; restart it for local goals.json changes to take effect.",不再静默。

---

Round 通信SDK马 / Author-Agent: 通信SDK马

[s2agi]

Pillar A 文档化 (cli.md, ZH+EN)

接 52e0f64 Pillar A 实现:

29d5f46 — docs(cli #191): document anet goal show/edit/cancel + Goal Management section

落点

文件	增改
docs-site/docs/guide/cli.md (ZH)	+73 行
docs-site/docs/en/guide/cli.md (EN)	+73 行

ZH/EN 同 commit 同步 (per docs ZH/EN parity rule)。

结构

1. Command Overview 加 ### Goal 管理 / Goal Management 区块(在 Channel Management 和 Other 之间),4 行 summary + goals.json 内存不感知本地改动的提醒。

2. Detailed Usage 末尾加完整 ### anet goal 详细章节:

   • 子命令表 (list/show/edit/cancel)
   • edit flag 表 (--interval / --text / --status),写明 sub-minute reject + MIN_INTERVAL_MS=60s 防 wake-storm 的理由 + interval 变更后 next_wake_at = now + new interval 立即生效
   • 6 条 bash 例子 (list / list <node> / show / edit --interval / 同时改 text+status / cancel)
   • 运行中 node 不感知 file 改动的 gotcha + Pillar C forward link
   • source link 到 cli.ts:4864 (Pillar A 后的新行号)

现状回顾

Pillar	状态
Pillar A 实现 (52e0f64)	✅ 已 ship 主线
Pillar A 文档 (29d5f46)	✅ ZH+EN 已 ship
Pillar B (dashboard goal viz)	⏸ 等 Vincent Goal 2 (#190 dashboard 简洁化)推进时 broaden + N站马 dispatch
Pillar C (commhub_goal_* MCP tools)	⏸ 跨团队设计待 review (通信牛 server + 工程马 SDK ratification),MiMo lane 安定后 dispatch
Phase 2/3	⏸ 待自驱推进

下一步 (自驱)

按 通信龙 dispatch (Vincent 6158 directive) 切换到 5min /loop autopilot on #191,sub-lane:

• envRef preview.4 on-call (smoke FAIL 5% 概率兜底)
• deep-codex 调研 (RFC-006/-007 lineage,跟 codex /goal /loop 内部互动相关)
• Phase 1 收尾 + Phase 2 scope 拟稿

Author-Agent: 通信SDK马