Commit 22f99af08b2cc5420a3db93bf1a6b9e182845e2c

Authored by zichun
1 parent 37c9d660

downstream-gen templates: dedup global conventions to docs/04; drop docs/02 notes section

- docs-05 header: collapse the `## 全局约定` block (response-format JSON +
  auth/pagination placeholders) into a single pointer to docs/04 (the
  conventions SSoT). Also fixes a broken ref — it cited "docs/04 § 1.4
  错误码段位", but § 1.4 is 统一响应格式 and no such section exists.
- docs-02: remove the free-form `## 三、关键说明 {{notes}}` filler section
  (the skill defines no source for it).
skills/plan/downstream-gen/templates/docs-02-template.md
... ... @@ -17,6 +17,3 @@
17 17 {{#each req_order}}
18 18 | {{index}} | **{{req_id}}** | {{module_id}} | {{rationale}} | {{note}} |
19 19 {{/each}}
20   -
21   -## 三、关键说明
22   -{{notes}}
... ...
skills/plan/downstream-gen/templates/docs-05-header-template.md
... ... @@ -5,19 +5,7 @@ BasePath: `{{base_path}}`
5 5  
6 6 ## 全局约定
7 7  
8   -### 响应格式
9   -```json
10   -{"code": 200, "message": "操作成功", "data": {}, "timestamp": 1700000000000}
11   -```
12   -
13   -### 错误码
14   -See docs/04 § 1.4 错误码段位.
15   -
16   -### 鉴权
17   -{{auth_note}}
18   -
19   -### 分页参数
20   -{{pagination_note}}
  8 +响应格式 / 异常 / 错误码 / 认证 / 分页等全局约定的 SSoT 在 `docs/04`(响应格式见 § 1.4、异常处理见 § 1.5、认证见 § 1.7、分页查询见 § 3.2),此处不重复。各端点专属的请求 / 响应 / 错误码见下方接口清单。
21 9  
22 10 ## 接口清单
23 11 (各模块接口段落见下方,由 `downstream-gen` 按 REQ 填入)
... ...