soft_quay_web/docs/current-state.md

当前实现状态

本文是可覆盖的项目级快照,记录代码与任务的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。 执行记录写进各任务文件(docs/tasks/W-<编号>.md)的 ## 执行记录,不在本文重复维护。

当前快照

• 日期:2026-07-20
• 阶段:文档就绪、代码未起步。harness coding 文档集(00~06、api、tasks、agent-context 等)已建立;原始设计规格已完整拆分进编号文档后删除(git 历史可查)。
• 代码:无。没有 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

开始编码前检查

1. 读仓库级 agent 规则文件 AGENTS.md。
2. 读 docs/00-ai-start-here.md。
3. 读 docs/05-coding-rules.md。
4. 在 docs/tasks/ 找到 frontmatter status: TODO 且依赖均 DONE 的任务文件;暂无任务时,先按 docs/06-tasks.md 路线图落成任务文件。
5. 把任务改为 DOING 再动手。

维护规则

当实际状态发生变化时,同步更新本文件:新增入口文件、初始化框架、新增可运行命令、发现文档和代码现实不一致、阶段或 blocker 变化。本文件只保留当前快照,不保留完整历史。