docs: 接入 harness coding 执行工件
- tasks.md 任务看板(路线图阶段0~2拆为14个小步任务,一次领一个) - progress.md 只追加执行流水(补记文档初始化与JKDA00002联调) - docs/current-state.md 可覆盖当前快照(pre-code现实+已验证事实) - init.sh 统一验证入口(无 go.mod 时指向 T-001) - AGENTS.md 通用 agent 薄入口;CLAUDE.md 会话启动改为三件套流程 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -8,14 +8,25 @@
|
||||
|
||||
## 会话启动
|
||||
|
||||
1. 读取 `docs/README.md` — 了解文档集结构与一句话结论
|
||||
2. 执行 `git log --oneline -10` — 了解上次做到哪里
|
||||
3. 确认当前所处阶段(见 `docs/05-实施路线图.md` 的阶段 0~6)
|
||||
1. 读 `docs/current-state.md` — 当前快照、已验证事实、blocker
|
||||
2. 读 `tasks.md` — 任务看板;一次只领一个 `TODO` 且依赖均 `DONE` 的任务
|
||||
3. 执行 `git log --oneline -10` — 了解上次做到哪里
|
||||
4. 需要背景再读 `docs/README.md`(文档导航)与 `docs/05-实施路线图.md`(阶段全景)
|
||||
|
||||
> 需要架构细节读 `docs/03-目标架构设计.md`;需要接口字段/码表读 `docs/01-OSI接口规范分析.md` 与 `docs/04-字段与接口映射.md`。
|
||||
> 需要架构细节读 `docs/03-目标架构设计.md`;需要接口字段/码表读 `docs/01-OSI接口规范分析.md` 与 `docs/04-字段与接口映射.md`(**§8 为联调实测契约,优先级高于 docx 整理**)。
|
||||
|
||||
> 用户说"继续开发""继续上次的"时,完成以上步骤后直接接续,不重新介绍项目背景。
|
||||
|
||||
### 三件套职责(完成任务后同步)
|
||||
|
||||
| 工件 | 性质 | 维护方式 |
|
||||
|------|------|---------|
|
||||
| `tasks.md` | 任务看板 | 领取改 `DOING`,验收通过改 `DONE`;标 DONE 需有 `progress.md` 里的验证证据 |
|
||||
| `progress.md` | 执行流水 | **只追加**:变更/验证命令与结果/阻塞/决策/下一步 |
|
||||
| `docs/current-state.md` | 当前快照 | **覆盖更新**:目录现实、可运行命令、blocker、下一步 |
|
||||
|
||||
统一验证入口:`./init.sh`(阶段 0 骨架未建立前会主动失败并提示 T-001,属预期)。
|
||||
|
||||
---
|
||||
|
||||
## 项目定位
|
||||
@@ -80,7 +91,7 @@ OSI 是**无状态服务端接口**,鉴权 = 请求头 MD5 签名(`password=
|
||||
### osi(薄客户端)
|
||||
- 签名只在 `osi` 层完成,业务层无感;用 `crypto/md5` 即可,**不引入 SM2/任何加密库**。
|
||||
- `ts` 取 13 位毫秒;`password` 取 32 位小写;`ask` **仅参与签名**,不进请求头、不进报文、不进日志。
|
||||
- 返回判定集中在 `codes.go`:`code=="1"` 成功(注意是**字符串**);`405` 超时(可重试);其它失败。
|
||||
- 返回判定集中在 `codes.go`:成功码为**字符串**,联调实测 `"01"`(docx 误写 `"1"`),判定按去前导零 == `"1"`;`405` 超时(可重试);其它失败。
|
||||
- 传输层移植自 `chis_upload`(保留 SOCKS5/超时,**去掉 cookiejar 与网页拟态头**)。
|
||||
|
||||
### mapping(核心)
|
||||
@@ -127,6 +138,7 @@ OSI 是**无状态服务端接口**,鉴权 = 请求头 MD5 签名(`password=
|
||||
| serviceId / 接口路径 / 字段映射 / 码表校准 | `docs/01-OSI接口规范分析.md`、`docs/04-字段与接口映射.md` |
|
||||
| 联调确认了开放问题(完整度 / checkId 规则 / 缺漏接口等) | `docs/03` 第 8 节、`docs/04` 第 7 节待补清单 |
|
||||
| 阶段推进或验收通过 | `docs/05-实施路线图.md` 勾选项与阶段状态 |
|
||||
| 任务领取/完成/受阻 | `tasks.md` 状态 + `progress.md` 追加记录(含验证证据)+ `docs/current-state.md` 覆盖快照 |
|
||||
| 做了重要技术决策 | `docs/decisions/00N-简短描述.md`(背景 / 决策 / 原因 / 影响) |
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user