Files

4.2 KiB

执行进度记录

本文件是只追加的历史流水,用来记录任务执行过程、验证命令、阻塞点和关键决策。 当前目录、当前命令、下一个可领取任务等可覆盖快照,写入 docs/current-state.md。

职责边界

  • docs/06-tasks.md:任务看板,维护任务状态、依赖和验收要点。
  • progress.md:历史流水,只追加记录每轮执行发生了什么。
  • docs/current-state.md:当前快照,可覆盖更新仓库现实、可运行命令和下一步。

不要在本文重复维护当前目录结构、当前运行命令或下一个任务;这些信息以 docs/current-state.md 为准。

记录格式

每完成或中断一轮任务,在文件末尾追加一条记录:

## YYYY-MM-DD T-编号 任务名

- 状态:DONE / BLOCKED / PARTIAL
- 变更:修改了哪些文件或模块
- 验证:运行的真实命令和结果
- 阻塞:如有,写明原因和需要谁决策;没有写“无”
- 决策:如有,记录本轮确定的关键取舍
- 下一步:建议下一个任务 ID 或待确认事项

执行记录

2026-07-06 T-000 初始化 harness 文档

  • 状态:DONE
  • 变更:复制 D:\github\harness_coding_docs 模板到当前项目,并替换根目录入口、需求、技术栈、架构、编码规则、任务看板、API 边界、路由和当前状态文档。
  • 验证:Get-ChildItem -Recurse -File 已列出根目录和 docs/ 文档;定向检查确认根入口不再误称模板库。init.ps1 / init.sh 的命令占位保留到 T-001 初始化生产代码时替换。
  • 阻塞:生产代码尚未初始化,init.ps1 / init.sh 仍为占位命令。
  • 决策:第一版采用 Wagtail + Django + Python 3.12 + SQLite;先做内容目录和评测闭环,不做前台用户系统、支付、评论、自动抓取和复杂搜索。
  • 下一步:T-001 初始化 Wagtail 项目骨架。

2026-07-06 文档审核与优化(harness 文档瘦身 + 商业计划加验证闸门)

  • 状态:DONE
  • 变更:
    • docs 瘦身:method-map.md、evaluator-rubric.md、quality-document.md、adoption-checklist.md 四个元文档合并为 docs/90-harness-reference.md 并删除原文件,移出每轮必读链路;AGENTS.md 定为唯一权威入口,README.md、docs/README.md、docs/00-ai-start-here.md 删除重复的定位/必读顺序/技术栈内容,改为链接。
    • 纠错:修正 00-ai-start-here.md 中"尚未初始化 git"的过期事实;开发环境定为 WSL2/Linux(/mnt/d/OPC/skelet),全部文档命令改为 bash 形态,init.sh 为标准入口、init.ps1 降为可选。
    • 评分模型统一:04-architecture.md 定为评分维度唯一权威(6 个 0-5 分项,新增 incremental_score,删除独立录入的 0-100 总分,总分改为由分项计算);business-plan-v1.md 和 research-sourcing-strategy.md 改为引用。
    • 数据模型:scenario 字段明确为多对多(scenarios)。
    • 任务看板:新增 T-305(轻量访问统计与外链点击,M3/M4 数据前置,T-304 增加对其依赖);Backlog 收入首批内容库任务(原 T-105~T-109,收敛为 2 个场景)和 llms.txt/JSON 导出。
    • 商业文档:里程碑加验证闸门和止损线(M2 从 8 场景 50 项目砍到 2 场景 20 项目;M3 定 8 周/12 周复盘线;内容投入封顶 20 项目+12 篇);定站点语言为英文单语言、主攻"AI Coding 友好度"角度词、头部词只作词根;竞品分析补"直接问 AI"为最大隐性竞品及 llms.txt 借力策略;Newsletter 口径统一为"MVP 外部托管订阅外链、完整功能 V2";付费价格标注为未验证假设;发布节奏按单人投入下调。
  • 验证:git status + find . -type f -not -path "./.git/*" 确认文件清单;grep 确认仓库内已无对四个被删元文档的引用(progress.md 历史记录除外),无残留 PowerShell 命令(历史记录除外)。
  • 阻塞:无。
  • 决策:第一版英文单语言站点;首批只做 SaaS 和内容站/CMS 两个场景;评分维度以 docs/04-architecture.md 为唯一权威;M3 闸门不过不扩内容。
  • 下一步:T-001 初始化 Wagtail 项目骨架。