Files
skelet/docs/current-state.md
T
ilaandClaude Fable 5 678d081124 Harden task board and specs for weaker coding agents
- 06-tasks: add per-task detail sheets for Phase 0/1 (concrete init
  commands, BLOCKED preconditions, verification commands with expected
  results) and a constraint/verification quick table for Phase 2/3;
  replace subjective acceptance wording with checkable items
- 04-architecture: promote 3.4 to an authoritative filter-param
  contract (names, values, AND combination, invalid-value handling);
  add required/optional/default field annex with 0-5 validators to
  3.3; state AiCodingScore is not a model in MVP; record structure
  decision (keep wagtail-start home/search apps, business models in
  new core app, no Dockerfile)
- 03-tech-stack: add version-pinning policy row for T-001
- routes/02-requirements: point filter wording back to the 3.4
  contract instead of maintaining copies
- T-104: human-input boundary - seed projects, scores and verdicts
  must be user-confirmed; BLOCKED without a confirmed list
- current-state snapshot updated; maintenance record appended to
  progress.md

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 16:11:54 +08:00

3.5 KiB
Raw Blame History

当前实现状态

本文是可覆盖的当前快照,记录代码与任务看板的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。

职责边界

  • 06-tasks.md:任务看板,维护任务状态、依赖和验收要点。
  • ../progress.md:执行流水,只追加记录每轮执行、验证、阻塞和决策。
  • current-state.md:当前快照,可覆盖更新当前目录、当前命令、已完成摘要和下一步。

当前快照

  • 日期:2026-07-06
  • 阶段:MVP 起步前,harness 文档已初始化并完成瘦身(元文档合并为 90-harness-reference.md,入口统一为 AGENTS.md);任务看板已加固(任务详单、验证命令、筛选参数契约、字段必填/默认附注)
  • 开发环境:WSL2 / Linux,仓库根目录 /mnt/d/opc_project/skelet,bash 为标准命令形态
  • git:已初始化,主分支 main;.gitignore 已生效(deploy/ 及凭证类文件不入库),.gitattributes 统一 LF 行尾
  • 技术栈:目标为 Wagtail + Django + Python 3.12 + SQLite;第一版英文单语言站点
  • 生产代码:尚未初始化
  • 测试:尚未初始化
  • 数据:尚未建立 seed 数据;未来通过 Wagtail 后台录入首批项目
  • 标准启动路径:init.sh 尚未配置真实命令(init.ps1 为可选辅助)
  • 标准验证路径:生产代码初始化后补齐
  • 当前 blocker:未初始化 Wagtail 项目骨架;下一步执行 T-001

当前目录要点

路径 状态 说明
docs/ 已有 harness coding 文档和项目需求 / 方案。
AGENTS.md 已有 AI agent 仓库入口。
CLAUDE.md 已有 Claude Code 薄入口。
progress.md 已有 只追加执行流水。
business/ 已有 商业计划、内容策略、变现、竞品分析。
deploy/ 已有,不入库 本机部署凭证(SSH 私钥等),被 .gitignore 整目录忽略。
.gitignore / .gitattributes 已有 忽略凭证与运行产物;统一 LF 行尾。
init.ps1 / init.sh 已有,占位 T-001 初始化生产代码后替换真实命令。
manage.py 待建 Wagtail/Django 入口。
requirements.txt 待建 Python 依赖。
skelet/ 待建 Django 配置包(wagtail start 生成 base/dev/production settings)。
home/ / search/ 待建 wagtail start 默认 app,保留不改名;HomePage 在 home。
core/ 待建 业务 app:Snippet、场景页、项目页、文章模型、模板和静态资源。
各 app tests.py 待建 smoke 与模型测试(T-003 起),暂不建独立 tests/ 目录。

任务看板状态

  • 已完成:T-000 初始化 harness 文档。
  • 正在进行:无。
  • 下一个可领取任务:T-001 初始化 Wagtail 项目骨架。

当前可运行内容

# 当前只能做文档检查
git status
find . -type f -not -path "./.git/*"

生产应用命令待 T-001 初始化后补齐:

# 目标形态
.venv/bin/python manage.py check
.venv/bin/python manage.py test
.venv/bin/python manage.py runserver

开始编码前检查

  1. 读仓库级 agent 规则文件。
  2. 读 docs/00-ai-start-here.md。
  3. 读 docs/05-coding-rules.md。
  4. 在 docs/06-tasks.md 取第一个 TODO 且依赖均 DONE 的任务。
  5. 将该任务状态改为 DOING。

维护规则

当实际代码状态发生变化时,同步更新本文件、docs/06-tasks.md 和 progress.md。