Commit 22f99af08b2cc5420a3db93bf1a6b9e182845e2c
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).
Showing
2 changed files
with
1 additions
and
16 deletions
skills/plan/downstream-gen/templates/docs-02-template.md
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 填入) | ... | ... |