Jyotisha/docs/tasks/README.md

任务书与进度记录（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 错误）；家庭采集题带年份前缀自相矛盾	待验收	codex/rectification-post-adopt-verify-20260904（BUG-536～539）
TASK-rectification-quality-probe-dedupe-20260904.md	PROGRESS-rectification-quality-probe-dedupe-20260904.md	候选区分阶段同一道"上大学"题问两次：pickProbe 按种类取第一条质量探针无视 semantic_key（第二次答案绑到错的证据）；引擎对毕业等学业 kind 也套"高考发挥"模板；同域同分组质量探针不去重	待验收	codex/rectification-quality-probe-dedupe-20260904（BUG-540～541）
—	PROGRESS-rectification-adopt-card-anchor-20260905.md	采用卡钉在历史采集题下，最新旁白没有卡；单分钟交付旁白机器腔	待验收	codex/rectification-quality-probe-dedupe-20260904（BUG-544～545）
TASK-api-not-configured-mislabel-20260904.md	—	16 处路由把数据库瞬断（部署切换窗口）兜底翻译成 503「服务尚未配置」；改为仅配置错误用该文案，其余 service_unavailable，收敛为共享 helper	待执行	codex/api-not-configured-mislabel-20260904（BUG-542 起）
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	待验收	4ef4c406（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（视觉与交互合同）。
• 任务书里的行号会随代码漂移，定位以符号名为准。