Jesse_Chen
2974ca5b85
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VawU7Xfd5jS9wUEXz1XYmS
8.3 KiB
8.3 KiB
任务书与进度记录（docs/tasks/）
这里存放每一轮协作的任务书（TASK-<主题>-<日期>.md）和执行方的进度记录（PROGRESS-<主题>-<日期>.md）。2026-09-03 之前它们堆在仓库根目录，已整体搬到这里；新文件一律直接写在本目录。
- 任务书由产品/架构侧（通常是 Claude）写，包含：基线 commit、事故实证、根因、决策记录、硬红线、任务分解、验收标准。
- 进度记录由执行方（coding agent）写：做了什么、测试数字、偏离与原因。
- 被环境或依赖挡住的事项写进根目录
BLOCKED.md；Bug 事实写进docs/BUG_HISTORY.md；两者不在这里重复。 - 纯文档改动不触发 staging 门禁（见
deploy/gated-paths.txt）。
状态板
这一节是所有任务的总板。任务书推上来时加一行，状态变化时改这一行，不另开文件。
状态含义：
| 状态 | 含义 |
|---|---|
| 待领取 | 任务书已推 staging，还没有执行分支 |
| 执行中 | 有执行分支，尚未回报 |
| 待验收 | 执行方已回报，验收未做 |
| 已验收 | 验收通过并合入 staging；浏览器级真实走查仍可能欠着，见 docs/testing/ |
| 已合入 | 代码在 staging 上，但本板没有留下独立验收记录（以 PROGRESS / BUG_HISTORY 为准） |
| 待核对 | 状态板建立时无法从 staging 历史确认，需要人工核对 |
| 已上线 | 已随 main 提升进入生产 |
截至 2026-09-03，main 停在 2026-08-16 的 7b620c7a，下表没有任何一项已上线。
生时校正（rectification）
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-rectification-convergence-20260830.md |
PROGRESS-rectification-convergence-20260830.md |
收敛重构 v2 | 已验收 | 3a4396a4、86ba17ee |
TASK-rectification-decision-authority-20260831.md |
PROGRESS-rectification-decision-authority-20260831.md |
决策权威归一与停止语义 | 已合入 | 9f011194 |
TASK-rectification-billing-20260831.md |
— | run_failed 与开场问题槽为空 | 已合入 | 47b4b06b |
TASK-round2-cost-and-delivery-20260831.md |
— | 第二轮真实成本与交付物 | 待核对 | — |
TASK-rectification-provisional-adopt-20260901.md |
— | provisional 采用成为一等成功出口 | 已验收 | 20df8c60（BUG-463） |
TASK-rectification-engine-convergence-20260901.md |
— | 引擎侧相邻分钟可区分 | 已验收 | 8743dcb1 |
TASK-rectification-nonterminal-exit-20260901.md |
— | 非终态轮出口统一 | 已合入 | e404b6f4 |
TASK-rectification-tails-20260901.md |
— | Round A/2 收尾 | 已验收 | c48a9656（PR #47） |
TASK-consultation-birth-accuracy-20260901.md |
— | 咨询侧出生时间精度真值传递 | 已合入 | 56daf6be（PR #49） |
TASK-rectification-question-in-message-20260902.md |
— | 题目进消息、删问题槽 | 已验收 | d9404976 |
TASK-rectification-question-ownership-fix-20260902.md |
— | 选项回归服务端、fail-closed | 已验收 | 8dfe457f |
TASK-rectification-walkthrough-polish-20260902.md |
— | 首次真实走查抛光（服务端） | 待核对 | — |
TASK-rectification-adopt-flow-20260902.md |
— | 采用流程整治 | 已验收 | 35e5781e（BUG-497～500） |
TASK-rectification-adopt-flow-fix-20260903.md |
— | 采用流程修复单（含删「用这个时间看盘」） | 已验收 | e8c98c37（BUG-501/502） |
TASK-rectification-uncertainty-stop-20260903.md |
— | 不确定度停止规则加样本下限 | 已验收 | 0c0df426（BUG-503） |
TASK-rectification-ux-20260902.md |
PROGRESS-rectification-ux-20260903.md |
会话面空白假死与交互摩擦 | 已验收 | d159f08e（09-03 在新基线重做后合入，BUG-505～509） |
聊天主链路与首页
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-chat-message-authority-20260901.md |
— | 消息服务端权威化 | 已验收 | b6989c3e（BUG-464） |
TASK-session-url-20260901.md |
— | 会话 URL 化 | 已验收 | 924f4202 |
TASK-cloud-truth-convergence-20260901.md |
— | 本地/云端双份真相收敛 | 已验收 | ce6a8a7e（BUG-466） |
TASK-home-split-20260901.md |
PROGRESS-home-split-20260901.md |
拆分首页巨石组件·第一批 | 已验收 | 54269fcf |
TASK-contract-repairs-20260901.md |
PROGRESS-contract-repairs-20260901.md |
孤儿契约红修复 | 已验收 | 551d6317（与第二批同提交） |
TASK-home-split-batch2-20260901.md |
PROGRESS-home-split-batch2-20260901.md |
拆页第二批：聊天主链路 | 已验收 | 551d6317 |
TASK-home-split-batch3-20260901.md |
PROGRESS-home-split-batch3-20260901.md |
拆页第三批：onboarding/profile | 已验收 | bf6989ec + 058e5db9（BUG-470） |
TASK-agent-voice-20260901.md |
— | Agent 输出语气 | 已合入 | ed9497e7（PR #48） |
TASK-chat-streaming-ux-20260901.md |
PROGRESS-chat-streaming-ux-20260901.md |
流式体验与双会话面统一 | 已验收 | 4dc0c8c7（BUG-473～478） |
TASK-unified-loading-20260902.md |
PROGRESS-unified-loading-20260902.md |
首页一次等待一次揭幕 | 已验收 | 482796fc（BUG-479） |
个人报告
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-report-sectioned-generation-20260830.md |
PROGRESS-report-sectioned-20260830.md |
分章节生成 | 已合入 | 见 PROGRESS |
TASK-report-skill-parity-20260901.md |
PROGRESS-report-skill-parity-20260901.md |
内容对齐 skill 解读深度 | 已验收 | 90bad10d、ef1bd6df |
TASK-report-blocked-repairs-20260902.md |
PROGRESS-report-blocked-repairs-20260902.md |
全主题 blocked 修复 | 已验收 | 7faf8555 |
TASK-report-section-writer-failure-20260902.md |
PROGRESS-report-writer-failure-20260902.md |
写作阶段 report_schema_invalid | 已验收 | eda37c15（后续 43294265、5c0bec0c、fbd6e480、cf6405ed） |
前端基础与工程
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-frontend-optimization-20260828.md |
PROGRESS-frontend-optimization-20260828.md |
前端优化九条 | 待核对 | 分支 codex/frontend-optimization-20260828 |
TASK-frontend-followup-20260829.md |
PROGRESS-frontend-followup-20260829.md |
九条收尾 | 待核对 | — |
TASK-frontend-interaction-20260830.md |
PROGRESS-frontend-interaction-20260830.md |
交互与 UI 收尾 | 待核对 | 分支 codex/interaction-20260830 |
| — | PROGRESS-react-compiler-20260817.md |
React Compiler 接管首页 | 已回滚 | 结论见 BLOCKED.md |
TASK-engine-runtime-hygiene-20260901.md |
PROGRESS-engine-runtime-hygiene-20260901.md |
Python 引擎运行时治理 | 已验收 | 124d3990（staging 实机三条待部署窗口） |
TASK-billing-pricing-20260830.md |
PROGRESS-billing-pricing-20260830.md |
计费闭环与功能级定价 | 已合入 | aaaa5fb7～a499c344 |
待开的任务书（2026-09-03 审查决定）
| 主题 | 内容 | 状态 |
|---|---|---|
| staging 测试账号 | 给验收环境一个虚构资料的受控账号，让 API 级端到端验收可做 | 待产品负责人提供 |
仓库整备与发布前置
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-repo-hygiene-20260903.md |
— | 岁差默认 Raman + 用户设置可选、参考集锁口径（P0，单独先推）、发布门本地可复现、注册表白名单、仓库地址、早期日志搬家、远端分支清理 | 待领取 | 分支 codex/repo-hygiene-20260903 |
上游同步与能力接入
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|---|---|---|---|---|
TASK-upstream-sync-20260903.md |
— | 上游快照推进到 a6f47abd、引擎三方合并、health 三窗 / VedAstro REST 桥 / 专业报告导出 |
待领取 | — |
命名与归档
- 文件名：
TASK-<kebab-主题>-<YYYYMMDD>.md；同主题的修复单加-fix；进度记录同名换前缀。 - 一轮结束后不删除文件；结论沉淀到
docs/BUG_HISTORY.md（Bug）、CHANGELOG.md（行为/skill 变化）、frontend/DESIGN.md（视觉与交互合同）。 - 任务书里的行号会随代码漂移，定位以符号名为准。