Files
writing-agent/docs/px-roadmap.md
moran 6392af54b4 完善配方驱动的创作编排
为可重复技能补充参数校验与展示,统一配方、编排器和执行单元术语。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-30 17:59:20 +08:00

7.9 KiB
Raw Permalink Blame History

PX 路线图(产品体验与交付)

0. 定位

当前仓库的执行计划表。系统边界见 architecture.md;日常场景与 P0 工作包见 daily-use-p0.md;文件级索引见 implementation-guide.md

绿场重写、近端迁 Mastra/Next/SQLite。挂在现有相位机 + Book/快照 + 声明驱动 Worker 上增量交付。

0.1 已锁定产品取向

决定
日常玩法 AIRP/交互 + 长文/爽文(同一内核)
编排器 Skill 新建时 UI 选择技能包;初期可只有 1 项(默认选中)
工作流计划层 动态:听用户说话谈 Worker 集 + tool loop不做死板流程选单/DAG
UI 抄参考即可,不自研美学
硬指标 存档 / 续作稳定
多配方 仅当方法边界真不同时再加包;爽文≠新配方

0.2 成功标尺

级别 含义
L1 可演示 带路能跑通一轮
L2 可自助 选配方 → 创作 → 玩/写,少踩坑
L3 可日常 双线存档续作可靠;少死循环
L4 可扩展 新配方包或隔离模式不改内核边界

1. 总计划表(主表)

阶段 名称 目标标尺 核心交付 状态
PX0 双线可日常最小集 L2→摸 L3 配方选择 UI线 A 扮演 + 线 B 长文/爽文主路径;存档硬稳定失败出口UI 只抄缺口 进行中(核心已落地)
PX1 创作体验 L3 design 规格可读可改、进度可见、表/黑板可手改、instance 改规格 进行中(定稿存读+黑板改+进度面板已有)
PX2 游玩/写作体验 L3 play 阅读主舞台(抄)、状态抽屉、重 roll 顺手、副作用调度、多 run 线打磨 未开始
PX3 运行可信 L3 加固 Context Trace、调度预算、规格钉版本、mock E2E 未开始
PX4 长文加深 L4 章产物/多卷、局部评测、更好的长文阅读面P0 已含最小长文) 未开始
PX5 隔离 + 调试 L4 私有上下文、泄漏测试Trace/成本/分支调试台 未开始
现在 →  PX0存档+双线+编排器UI
      →  PX1创作好改
      →  PX2玩/写好用)
      →  PX3可信可测
      →  PX4 / PX5按需可调序

顺序原则:先 PX0 双线硬路径再体验12再加固3再扩展45
若 PX02 出现腐档/死循环,允许提前插入 PX3 对应子项。

预估单人全职约PX0 1.52 周PX1/PX2 各 23 周PX3 23 周PX4/PX5 各 35 周。


2. PX0 — 双线可日常最小集(当前)

权威细项daily-use-p0.md §3。

2.1 计划表(工作包)

工作包 内容 验收要点
1 WP-S 存档稳定 续作相位正确;手动存/列表/加载;正文与关键 tag 不丢 线 A、B 各存读一轮,不手改磁盘
2 WP-D 配方选择 新建作品 UI 选配方registry 列表;仅 1 项时默认选中 能选中并进入该包创作
3 WP-A 进出与失败 glossary 底线;waiting_user 有主按钮LLM/worker 失败可重试 无死胡同、无裸 id 挡路
4 WP-R 线 A 扮演 ≥3 回合不卡 A-GP15
5 WP-L 线 B 引导+template 能谈成写手规格≥2 段正文;续作不丢文 B-GP15
6 WP-U UI 抄补 仅补存档/确认/选配方等缺口控件 不按 ui-design 大重构
7 WP-E 闸门 双线冷启动+续作验收;勾选 DoD 全绿才出 PX0

2.2 黄金路径(摘要)

  • 线 A:选配方 → 扮演意图 → 验收 → ≥3 回合 → 存档 → 续作/读档
  • 线 B:选配方 → 爽文/长篇意图 → 验收写手规格 → ≥2 段正文 → 存档含正文 → 续作/读档

2.3 非范围

死板流程选单;自研精美 UITrace隔离完整副作用多配方商店列表可扩展P0 不追求多包运营)。

2.4 DoD

  • WP-SE 完成
  • 线 A、线 B 黄金路径各冷启动 + 续作通过
  • 配方选择 UI 可用(可仅一项)
  • 更新本文状态列 + architecture.md §13

2.5 挂载

web/新建选配方、savessession-managerskill-catalog / registry、phase-runtime、引导与 worker-templates


3. PX1 — 创作体验

内容 DoD
规格工作台 产物为主舞台(可抄 Notion/PR 式验收) 不看文档能验完 Worker 集进 play
进度 创作单位已验收/进行中可见
字段可编辑 + rev 不覆盖手改 手改后 worker 写入可解释
规格回退 load instance 再改 至少一条路径可用

挂载:worker-set-viewcreation-units、questions UI、表编辑 API。


4. PX2 — 游玩 / 写作体验

内容 DoD
阅读面 终稿/章文主视线(抄 ST/阅读器) ≥10 回合或等价连续写段不卡
重 roll 发现入口;与快照语义一致 存/读/重 roll 各至少一次
状态 抽屉看表/变量
副作用 side_effects 边沿完整可观测 fixtureonce / changed
多线 同开局新开 play 线 不串 run 状态

挂载:table-side-effectsphase-runtime、play UI、run-snapshot


5. PX3 — 运行可信

子项 DoD
Context Trace 失败调用能看出装载了什么
调度预算 重复/嵌套/Token 触顶可读停止
规格钉版本 改规格不污染未迁移旧 run
mock E2E 双线+存档脚本可进 CI

6. PX4 — 长文加深P0 之后)

P0 已要求最小长文/爽文闭环。本阶段加深:

  • 章/卷 Artifact 更清晰;多段目录
  • 简单质量检查(程序优先)
  • 更好的长文阅读/对照面(仍可抄,可不上 Monaco

不做:固定小说 DAG为长文另起调度内核。


7. PX5 — 隔离模拟 + 专业调试

内容
隔离 私有上下文、公私事件、泄漏测试(依 Trace
调试 调度时间线、Trace 检查器、Token/成本、分支树

若隔离需要不同方法边界,以新配方包形式加入UI 多一项),仍保持包内工作流计划动态。


8. 明确不做(周期内)

  • Mastra / LangGraph 换相位机Next 重写前端
  • 完整事件溯源 + SQLite 近端必达
  • 题材固定 instantiate 管道;死板流程选单
  • 把创作方法长文塞回系统架构文

9. 里程碑

里程碑 退出 产出
M0 PX0 DoD 双线验收记录;编排器 UI存档稳定
M1 PX1+PX2 DoD 内部「可日常」说明
M2 PX3 DoD Trace/预算/E2E 绿灯
M3 PX4 或 PX5 长文加深或隔离/调试演示

10. 文档 / 代码映射

阶段 文档 代码
PX0 daily-use-p0.mdui-glossary.md web/、session、saves、catalog、templates
PX1 ui-design.md可抄着落地、design-guide worker-set、creation-units
PX2 run-snapshot.md、tag-blackboard side-effects、phase-runtime
PX3 context-assembly.md、architecture assemble、budgets、tests
PX4 Skill 薄层 artifacts、长文面
PX5 隔离短文(待写) Trace 强制、debug、stats

11. 下一行动(立即)

  1. 手工跑双线黄金路径(线 A ≥3 回合;线 B ≥2 段;存读档)验收 PX0 DoD
  2. 表字段格级编辑器(当前是黑板 tag 预览级手改)可继续打磨
  3. 再开 PX2阅读面 / 副作用 / 多 run

当前PX0/PX1 主代码已落地,待你本地用真实 LLM 走一遍确认「能用」。