ilaandClaude Fable 5
a89821a571
Split docs/softbox-catalog-design.md into the numbered harness doc set (00-06, api.md, current-state, agent-context, tasks) following the harness_coding_docs template and soft_quay conventions. Register the nine open decision items from the design spec into the 06-tasks roadmap as W- tasks and backlog entries. Keep the original design spec as an archived design input with a header note. Recreated after the repository's previous git history was lost to an external reset; content matches the original initial commit. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
当前实现状态
本文是可覆盖的项目级快照,记录代码与任务的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。 执行记录写进各任务文件(
docs/tasks/W-<编号>.md)的## 执行记录,不在本文重复维护。
当前快照
- 日期:2026-07-20
- 阶段:文档就绪、代码未起步。harness coding 文档集(00~06、api、tasks、agent-context 等)已建立;设计规格
softbox-catalog-design.md已拆分归位。 - 代码:无。没有 go.mod / 源码目录;
init.sh/init.ps1顶部三个命令为占位符,运行会主动失败(预期,W-001 替换)。 - 协议权威源:
../soft_quay/docs/api.md、../soft_quay/schemas/(manifest/app/installed-app/download-task)、../soft_quay/testdata/catalog/canonical-vectors.json均存在于同级客户端仓库;引用方式(submodule / 版本化拷贝)未裁定(W-001)。 - 客户端配套现状:
soft_quay已完成 Phase 0~4,corpus 已冻结(soft_quay/T-614);客户端当前 blocker 之一是缺可信 Catalog 发布源,对应本仓库 M2/M3。 - 版本管理:git 已初始化(main 分支,本地,无远端)。
- 当前 blocker:无技术 blocker;立项裁定项(签名私钥管理 W-003、权威源引用方式 W-001)未裁定前,对应实现不能开工。
当前目录要点
| 路径 | 状态 | 说明 |
|---|---|---|
docs/ |
已有 | harness coding 文档集(本次初始化完成)+ 原始设计规格 |
docs/tasks/ |
已有 | 仅 README 与模板,尚无任务文件;下一步按路线图落 W-001/W-003 |
scripts/ |
已有 | validate_agent_context.py(上下文清单校验) |
init.sh / init.ps1 |
占位 | W-001 替换真实命令 |
| 源码目录 | 无 | W-001 建立 |
任务状态
任务状态以 docs/tasks/ 各任务文件 frontmatter 的 status 为准。本节只写项目级摘要:
- 已完成:无(项目刚初始化)。
- 正在进行:无。下一步按
06-tasks.md落成 Phase 0 任务;W-003(私钥管理裁定)与 W-001(骨架)无相互依赖,建议先落 W-001。
当前可运行内容
# 上下文清单校验(唯一当前可运行的验证):
python3 scripts/validate_agent_context.py
# init 脚本当前会按预期失败并提示命令未替换:
./init.sh
开始编码前检查
- 读仓库级 agent 规则文件
AGENTS.md。 - 读
docs/00-ai-start-here.md。 - 读
docs/05-coding-rules.md。 - 在
docs/tasks/找到 frontmatterstatus: TODO且依赖均DONE的任务文件;暂无任务时,先按docs/06-tasks.md路线图落成任务文件。 - 把任务改为
DOING再动手。
维护规则
当实际状态发生变化时,同步更新本文件:新增入口文件、初始化框架、新增可运行命令、发现文档和代码现实不一致、阶段或 blocker 变化。本文件只保留当前快照,不保留完整历史。