Jesse_Chen
118 lines
12 KiB
Markdown
118 lines
12 KiB
Markdown
# 任务书与进度记录（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-adopt-narration-20260904.md` | `PROGRESS-rectification-adopt-narration-20260904.md` | 探针池耗尽时采用卡旁白改 Agent 生成 + 已丢弃探针绕过 BUG-472 早退 + 区分题答否关线 | 已验收（4.1.4 点选入口未通过，见修复单） | `0aaa0d70`（BUG-519/520） |
|
||
| `TASK-rectification-adopt-narration-fix-20260904.md` | `PROGRESS-rectification-adopt-narration-fix-20260904.md` | 采用旁白 Agent 在点选入口从不运行（早退分支重算过期决策）+ 校验器/可观测/超时 | 已验收（5.1/5.2 实现通过；超时测试挂死事件循环，见修复单 2） | `13dded9f`（BUG-521/522） |
|
||
| `TASK-rectification-adopt-narration-fix2-20260904.md` | `PROGRESS-rectification-adopt-narration-fix2-20260904.md` | 采用旁白超时用了 unref 的 `AbortSignal.timeout`，测试挂死取消同文件后三条用例，门禁 `npm test` 退出码 1 | 已验收（门禁通过，staging 已部署） | `45bdb63e`（BUG-523） |
|
||
| `TASK-rectification-collect-direction-20260904.md` | `PROGRESS-rectification-collect-direction-20260904.md` | 可评分事件 2 条时盘外核对抢跑到刚拒答的家人领域，Agent 只能改写成不指向任何领域的泛问；缺第三件带年份的事却先问职业 | 已验收：5.1/5.3/5.4 通过；5.2 顺序错位（任务书责任）见修复单 | `codex/rectification-collect-direction-20260904`（BUG-527～530） |
|
||
| `TASK-rectification-collect-direction-fix-20260904.md` | `PROGRESS-rectification-collect-direction-fix-20260904.md` | dated 补采集分支插在方法轮转之前，新案例第二问被家人抢占感情/事业；`7ee7f825` CSS 与合同测试脱节挡住门禁 | 已验收通过（0be51e65），待 staging 部署核对 | `codex/rectification-collect-direction-fix-20260904`（BUG-531～532） |
|
||
| `TASK-rectification-post-adopt-verify-20260904.md` | `PROGRESS-rectification-post-adopt-verify-20260904.md` | 采用后核对题重复已问题；核对卡「这题跳过」等于整案停止、已采用仍念"选一个先用着"、前端"没有拿到下一个问题"；采用旁白承诺的 holdout/OOS 核对与实际计划不同源（原任务书 §4 错误）；家庭采集题带年份前缀自相矛盾 | 待执行 | — |
|
||
| `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-report-sensitivity-crash-20260904.md`（仓库根） | `PROGRESS-report-sensitivity-crash-20260904.md` | consultation_workflow float 时辰崩溃，全量 500 | 执行中 | `codex/report-sensitivity-crash-20260904`（BUG-524） |
|
||
| `TASK-report-candidate-range-read-20260904.md`（仓库根） | `PROGRESS-report-candidate-range-20260904.md` | accepted 生时报告直读已收权校正表 | 待验收 | `e27d5dc5`（BUG-526/534；终稿见 BUG-535） |
|
||
| `TASK-report-chart-cap-20260904.md`（仓库根） | `PROGRESS-report-chart-cap-20260904.md` | 文档 charts 上限绑定 CHART_IDS | 执行中 | `61194690`（BUG-535） |
|
||
|
||
### 前端基础与工程
|
||
|
||
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `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` | `PROGRESS-repo-hygiene-20260903.md` | 岁差默认 Raman + 用户设置可选、参考集锁口径、发布门本地可复现、注册表白名单、仓库地址、早期日志搬家、远端分支清理 | 已验收（带修复单） | `b6a70aa7`、`2415e751`、`01a45363`（BUG-511）；验收结论见修复单附录 |
|
||
| `TASK-repo-hygiene-fix-20260903.md` | `PROGRESS-repo-hygiene-fix-20260903.md` | Gulika 全局岁差泄漏（P1）、设置类名无样式、提示语对齐校正现状、剩余 lahiri 字面量、测试不写仓库 | 已验收 | `027e4b08`、`c1e3f32a`（BUG-512/513）；Gulika 泄漏实验已复核为不泄漏，全量 pytest 后仓库干净 |
|
||
|
||
### 上游同步与能力接入
|
||
|
||
| 任务书 | 进度 | 主题 | 状态 | 落点 |
|
||
| --- | --- | --- | --- | --- |
|
||
| `TASK-upstream-sync-20260903.md` | `PROGRESS-upstream-sync-20260903.md`、`PROGRESS-upstream-capabilities-20260903.md` | 上游快照推进到 `a6f47abd`、引擎三方合并、health 三窗 / VedAstro REST 桥 / 专业报告导出 / 新字段接聊天与报告 / 校正解冻三项 | 已验收 | 0/1/2/4/6：`45d13258`、`f2241463`、`734d2059`；3/5/7：`c2f23131`～`6063c1f7`（BUG-514）。staging 已部署 `6063c1f7`。修复单 `4ee79210` 已验收 |
|
||
| `TASK-upstream-sync-fix-20260903.md` | `PROGRESS-upstream-sync-fix-20260903.md` | 非原生主题恢复 `degraded`、finance Yogi/D11/confidence cap、模板注册表引用、VedAstro/MCP finance 路由与 quick CORE 扩列 | 已验收 | `4ee79210`（BUG-515）；staging health 已到该 SHA；十主题 e2e 合同全对，Python 红 90→69 无新增 |
|
||
|
||
## 命名与归档
|
||
|
||
- 文件名：`TASK-<kebab-主题>-<YYYYMMDD>.md`；同主题的修复单加 `-fix`；进度记录同名换前缀。
|
||
- 一轮结束后不删除文件；结论沉淀到 `docs/BUG_HISTORY.md`（Bug）、`CHANGELOG.md`（行为/skill 变化）、`frontend/DESIGN.md`（视觉与交互合同）。
|
||
- 任务书里的行号会随代码漂移，定位以符号名为准。
|