4.2 KiB
4.2 KiB
Harness Coding 样本库任务列表
本文件记录当前文档样本库自身的拆分任务。 复制到新项目后,项目开发任务应写入
docs/06-tasks.md,不要把本文件当成业务项目任务看板。
使用规则
- 每次只领取一个状态为
TODO且依赖均已DONE的任务。 - 修改模板前先读
AGENTS.md、CLAUDE.md和相关docs/文件。 - 新增、改名或删除文档时,同步检查
README.md和docs/README.md。 - 改完后至少运行:
Get-ChildItem -Recurse -File
如涉及链接、文件名或入口说明,继续用 rg 检查引用一致性。
状态图例
TODO 待开始 · DOING 进行中 · DONE 已完成 · BLOCKED 受阻
Phase 0 · 仓库入口
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| H-001 | 建立 Codex 入口 AGENTS.md |
- | 说明仓库定位、必读顺序、工作规则和验证方式 | DONE |
| H-002 | 建立 Claude Code 入口 CLAUDE.md |
- | 说明 Claude Code 读取顺序、模板边界和禁止事项 | DONE |
| H-003 | 建立根目录总览 README.md |
- | 说明样本库用途、推荐文档集合和使用方式 | DONE |
| H-004 | 明确 docs/ 是 harness coding 文档目录 |
H-001, H-002 | AGENTS.md 和 CLAUDE.md 均说明编程从 docs/00-ai-start-here.md 进入 |
DONE |
| H-005 | 建立样本库任务列表 tasks.md |
H-001 | 根目录存在维护任务列表,并和 docs/06-tasks.md 职责区分清楚 |
DONE |
Phase 1 · 核心模板
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| H-101 | 建立文档导航 docs/README.md |
H-003 | 能快速找到入口、愿景、需求、技术栈、架构、规则、任务、API、路由和当前状态 | DONE |
| H-102 | 建立 AI 开发入口模板 docs/00-ai-start-here.md |
H-101 | 包含必读顺序、任务领取规则、MVP 边界、事实来源和验证命令 | DONE |
| H-103 | 建立愿景模板 docs/01-vision.md |
H-102 | 能约束为什么做、为谁做、产品原则和非目标 | DONE |
| H-104 | 建立需求模板 docs/02-requirements.md |
H-103 | 能表达功能范围、用户故事、优先级和验收标准 | DONE |
| H-105 | 建立技术栈模板 docs/03-tech-stack.md |
H-104 | 能固定框架、依赖、运行命令和待定项 | DONE |
| H-106 | 建立架构模板 docs/04-architecture.md |
H-105 | 能表达系统边界、模块职责、数据模型和开发顺序 | DONE |
| H-107 | 建立编码规则模板 docs/05-coding-rules.md |
H-106 | 能约束事实来源、范围、架构、代码规范和验证 | DONE |
| H-108 | 建立任务看板模板 docs/06-tasks.md |
H-107 | 能指导 agent 每轮只领取一个小任务 | DONE |
Phase 2 · 辅助模板
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| H-201 | 建立 API 合约模板 docs/api.md |
H-106 | 能记录接口形状、错误格式、鉴权和示例 | DONE |
| H-202 | 建立路由模板 docs/routes.md |
H-106 | 能记录页面路由、组件归属和导航规则 | DONE |
| H-203 | 建立当前状态模板 docs/current-state.md |
H-108 | 能记录仓库现实、已完成内容、可运行命令和下一步 | DONE |
Phase 3 · 一致性维护
| ID | 任务 | 依赖 | 验收要点 | 状态 |
|---|---|---|---|---|
| H-301 | 检查入口文件之间的职责是否重复 | H-005 | AGENTS.md、CLAUDE.md、README.md、docs/README.md、docs/00-ai-start-here.md 各自职责清楚 |
TODO |
| H-302 | 检查所有模板是否保持通用占位符 | H-201, H-202, H-203 | 没有混入只适用于某个真实项目的业务事实 | TODO |
| H-303 | 检查链接和文件名引用一致性 | H-301 | rg 搜索无旧名称、坏路径或冲突说明 |
TODO |
| H-304 | 补充复制到新项目后的使用流程 | H-302 | README 和入口模板能指导用户从复制、替换占位符到开始编程 | TODO |
Backlog
- 增加“从空项目初始化文档”的操作清单。
- 增加“已有项目补齐 harness coding 文档”的迁移清单。
- 增加“任务拆分质量检查表”。
- 增加“文档与代码现实不一致时的处理流程”。