Jesse_Chen
8db71aaf81
- README.md is now the product/repo front door (architecture, repo map, local dev, test tiers, delivery flow, doc map). Engine positioning, VedAstro/Codex setup and the oracle/benchmark command reference move verbatim to docs/engine/README.md, docs/engine/vedastro-gateway.md and docs/benchmark/README.md. Capability badges realigned with the registry (91/78/8/0); tests/test_readme_badges.py was red on staging. - AGENTS.md: Part A (environment truth, delivery, worktrees, record placement, bug workflow, growth freeze, frontend red lines, privacy, pre-work check, test tiers) and Part B (reading-rigor constraints). GitHub issue-tracker/triage boilerplate removed: GitHub is a read-only mirror. All strings locked by tests/ are preserved. - CLAUDE.md added: roles, three working modes, task-brief sections, acceptance criteria, session discipline; imports AGENTS.md. - 50 tracked TASK-*/PROGRESS-* files and 3 never-committed briefs move to docs/tasks/ with an index; REPO_LAYOUT.md merged into README. Docs-only change (no gated path touched). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0193vBv6w5MV2cifdTUu9H5P
73 lines
5.2 KiB
Markdown
73 lines
5.2 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`）。
|
||
|
||
## 索引（按主题）
|
||
|
||
### 生时校正（rectification）
|
||
|
||
| 任务书 | 进度 | 主题 |
|
||
| --- | --- | --- |
|
||
| `TASK-rectification-convergence-20260830.md` | `PROGRESS-rectification-convergence-20260830.md` | 收敛重构 v2 |
|
||
| `TASK-rectification-decision-authority-20260831.md` | `PROGRESS-rectification-decision-authority-20260831.md` | 决策权威归一与停止语义 |
|
||
| `TASK-rectification-billing-20260831.md` | — | run_failed 与开场问题槽为空 |
|
||
| `TASK-round2-cost-and-delivery-20260831.md` | — | 第二轮真实成本与交付物 |
|
||
| `TASK-rectification-provisional-adopt-20260901.md` | — | provisional 采用成为一等成功出口 |
|
||
| `TASK-rectification-engine-convergence-20260901.md` | — | 引擎侧相邻分钟可区分 |
|
||
| `TASK-rectification-nonterminal-exit-20260901.md` | — | 非终态轮出口统一 |
|
||
| `TASK-rectification-tails-20260901.md` | — | Round A/2 收尾 |
|
||
| `TASK-rectification-question-in-message-20260902.md` | — | 题目进消息、删问题槽 |
|
||
| `TASK-rectification-question-ownership-fix-20260902.md` | — | 选项回归服务端、fail-closed |
|
||
| `TASK-rectification-adopt-flow-20260902.md` | — | 采用流程整治 |
|
||
| `TASK-rectification-adopt-flow-fix-20260903.md` | — | 采用流程修复单（含删「用这个时间看盘」） |
|
||
| `TASK-rectification-uncertainty-stop-20260903.md` | — | 不确定度停止规则加样本下限（BUG-503） |
|
||
| `TASK-rectification-walkthrough-polish-20260902.md` | — | 首次真实走查抛光（服务端） |
|
||
| `TASK-rectification-ux-20260902.md` | — | 会话面空白假死与交互摩擦（09-03 已在新基线重启） |
|
||
| `TASK-consultation-birth-accuracy-20260901.md` | — | 咨询侧出生时间精度真值传递 |
|
||
|
||
### 聊天主链路与首页
|
||
|
||
| 任务书 | 进度 | 主题 |
|
||
| --- | --- | --- |
|
||
| `TASK-chat-message-authority-20260901.md` | — | 消息服务端权威化（BUG-464） |
|
||
| `TASK-session-url-20260901.md` | — | 会话 URL 化 |
|
||
| `TASK-cloud-truth-convergence-20260901.md` | — | 本地/云端双份真相收敛 |
|
||
| `TASK-home-split-20260901.md` | `PROGRESS-home-split-20260901.md` | 拆分首页巨石组件·第一批 |
|
||
| `TASK-contract-repairs-20260901.md` | `PROGRESS-contract-repairs-20260901.md` | 孤儿契约红修复（先于第二批） |
|
||
| `TASK-home-split-batch2-20260901.md` | `PROGRESS-home-split-batch2-20260901.md` | 拆页第二批：聊天主链路 |
|
||
| `TASK-home-split-batch3-20260901.md` | `PROGRESS-home-split-batch3-20260901.md` | 拆页第三批：onboarding/profile |
|
||
| `TASK-chat-streaming-ux-20260901.md` | `PROGRESS-chat-streaming-ux-20260901.md` | 流式体验与双会话面统一 |
|
||
| `TASK-unified-loading-20260902.md` | `PROGRESS-unified-loading-20260902.md` | 首页一次等待一次揭幕（BUG-479） |
|
||
| `TASK-agent-voice-20260901.md` | — | Agent 输出语气 |
|
||
|
||
### 个人报告
|
||
|
||
| 任务书 | 进度 | 主题 |
|
||
| --- | --- | --- |
|
||
| `TASK-report-sectioned-generation-20260830.md` | `PROGRESS-report-sectioned-20260830.md` | 分章节生成 |
|
||
| `TASK-report-skill-parity-20260901.md` | `PROGRESS-report-skill-parity-20260901.md` | 内容对齐 skill 解读深度 |
|
||
| `TASK-report-blocked-repairs-20260902.md` | `PROGRESS-report-blocked-repairs-20260902.md` | 全主题 blocked 修复 |
|
||
| `TASK-report-section-writer-failure-20260902.md` | `PROGRESS-report-writer-failure-20260902.md` | 写作阶段 report_schema_invalid |
|
||
|
||
### 前端基础与工程
|
||
|
||
| 任务书 | 进度 | 主题 |
|
||
| --- | --- | --- |
|
||
| `TASK-frontend-optimization-20260828.md` | `PROGRESS-frontend-optimization-20260828.md` | 前端优化九条 |
|
||
| `TASK-frontend-followup-20260829.md` | `PROGRESS-frontend-followup-20260829.md` | 九条收尾 |
|
||
| `TASK-frontend-interaction-20260830.md` | `PROGRESS-frontend-interaction-20260830.md` | 交互与 UI 收尾 |
|
||
| — | `PROGRESS-react-compiler-20260817.md` | React Compiler 尝试（已回滚，结论见 BLOCKED.md） |
|
||
| `TASK-engine-runtime-hygiene-20260901.md` | `PROGRESS-engine-runtime-hygiene-20260901.md` | Python 引擎运行时治理 |
|
||
| `TASK-billing-pricing-20260830.md` | `PROGRESS-billing-pricing-20260830.md` | 计费闭环与功能级定价 |
|
||
|
||
## 命名与归档
|
||
|
||
- 文件名：`TASK-<kebab-主题>-<YYYYMMDD>.md`；同主题的修复单加 `-fix`；进度记录同名换前缀。
|
||
- 一轮结束后不删除文件；结论沉淀到 `docs/BUG_HISTORY.md`（Bug）、`CHANGELOG.md`（行为/skill 变化）、`frontend/DESIGN.md`（视觉与交互合同）。
|
||
- 任务书里的行号会随代码漂移，定位以符号名为准。
|