提示:AI 结果必须带引用;若证据不足会提示“未找到可靠证据”。

    下载 Markdown

    提示词资产化系统可执行开发计划(v1.1)

    计划版本:v1.1
    计划日期:2026-02-17
    适用仓库:/Users/Zhuanz/work-space/pe-list(研发) + /Users/Zhuanz/work-space/hot-docs(文档)
    对应需求:/Users/Zhuanz/work-space/hot-docs/content/docs/reference/prompt-asset-system-v1.1-structured-template-and-example-spec.md

    1. 执行约束(强制)

    1. 单线程执行:同一时刻只做 1 个任务。
    2. 任务闭环顺序固定:
      • 更新状态跟踪器
      • 运行测试
      • 提交代码
    3. 未完成上述三步,不允许进入下一任务。
    4. 所有存储读写必须通过 cloud-data-proxy,禁止业务代码直连数据库。
    5. 前端遵循事件驱动:非必要不得使用 useEffect 拉数。

    2. 版本目标(v1.1)

    1. 完成提示词结构块模式化编辑(STATIC/VARIABLE/MIXED)。
    2. 完成变量校验、渲染预览与复制闭环。
    3. 完成示例与预期效果对照能力。
    4. 新增“已保存资产可修改”能力(含并发冲突保护与审计)。
    5. 完成宽屏高密度可用性优化与回归。

    3. 里程碑(M6)

    里程碑 日期窗口 目标
    M6-W1 2026-02-18 ~ 2026-02-20 后端数据模型与核心 API
    M6-W2 2026-02-21 ~ 2026-02-24 前端核心页面、资产编辑、前后端联调
    M6-W3 2026-02-25 ~ 2026-02-27 宽屏优化、自动化回归、发布门禁

    4. 可执行任务清单(严格按序)

    ID 任务 优先级 前置 交付物 测试门禁 提交信息模板
    V11-T00 文档基线冻结 P0 v1.1 规格/计划/跟踪器 文档检查通过 docs(V11-T00): freeze v1.1 baseline
    V11-T01 DDL 增量与字段迁移 P0 T00 prompt_template_blocks/variables_v2/examples/assets(version) 变更脚本 go test ./... feat(V11-T01): add v1.1 ddl migration
    V11-T02 后端资产编辑 API P0 T01 GET/PATCH /api/v1/assets/{id} + version 乐观锁 go test ./... feat(V11-T02): support saved asset editing
    V11-T03 后端结构块 API P0 T01 GET/PUT /templates/{id}/blocks go test ./... feat(V11-T03): implement template blocks api
    V11-T04 后端变量规则增强 P0 T01 变量批量保存与规则校验 go test ./... feat(V11-T04): enhance variable validations
    V11-T05 后端示例管理 API P1 T01 示例增删改查 API go test ./... feat(V11-T05): add template examples api
    V11-T06 后端渲染与复制增强 P0 T03,T04 render-preview/copy 与错误细化 go test ./... feat(V11-T06): enhance render and copy api
    V11-T07 审计与可观测补齐 P1 T02~T06 资产编辑与模板变更审计、关键日志字段 go test ./... feat(V11-T07): add audit trail for v1.1
    V11-T08 前端工作台壳体与宽屏框架 P1 T03~T06 双栏布局与页签框架 cd frontend && pnpm test feat(V11-T08): add v1.1 workspace shell
    V11-T09 前端资产编辑页面 P0 T02,T08 已保存资产编辑页(含版本冲突提示) cd frontend && pnpm test feat(V11-T09): implement saved asset editor
    V11-T10 前端结构拆分与变量页面 P0 T03,T04,T08 结构块编辑器 + 变量规则面板 cd frontend && pnpm test feat(V11-T10): implement block and variable editors
    V11-T11 前端示例与预期效果页面 P1 T05,T08 示例管理与对照展示 cd frontend && pnpm test feat(V11-T11): add examples and expected output view
    V11-T12 前后端联调与冲突回归 P0 T09~T11 联调修复、并发编辑冲突处理 go test ./... && cd frontend && pnpm test fix(V11-T12): integration fixes for v1.1
    V11-T13 自动化测试补齐 P0 T12 新增成功/失败/冲突路径测试 go test ./... && cd frontend && pnpm test test(V11-T13): add v1.1 coverage
    V11-T14 发布门禁与上线验收 P0 T13 runbook、发布清单、灰度回滚验证 ./scripts/release-gate.sh chore(V11-T14): release gate for v1.1

    5. 单任务执行 SOP(每次照做)

    1. 开发当前任务范围内的最小可交付变更。
    2. 更新跟踪器中该任务状态与证据字段。
    3. 执行对应测试命令并记录结果。
    4. 提交当前任务代码(仅包含相关文件)。
    5. 再切换下一任务。

    6. 完成定义(DoD)

    1. 功能 DoD:满足 v1.1 规格文档中的 FR 与验收条款。
    2. 质量 DoD:关键路径测试全部通过,失败路径可复现且有明确错误码。
    3. 架构 DoD:无数据库直连,所有读写经 cloud-data-proxy
    4. 交付 DoD:跟踪器、测试记录、提交哈希三者齐全且一致。

    7. 关键风险与预案

    风险 描述 预案
    R1 资产并发编辑导致覆盖写 强制 version 乐观锁,冲突返回 CONFLICT
    R2 前端宽屏布局改造引入回归 先壳体后业务,按页面逐步切换
    R3 变量规则复杂导致渲染失败率升高 引入示例回归集与保存前校验
    R4 任务并行导致闭环失效 严格按单任务 SOP 与跟踪器门禁执行