36 lines
1.1 KiB
Markdown
36 lines
1.1 KiB
Markdown
# Real API Example
|
|
|
|
这个目录用于沉淀「真实系统 API」类 skill 的可复制成功案例。
|
|
|
|
## 适用场景（规划）
|
|
|
|
- 目标系统提供真实 API
|
|
- 需要 token / secret / credential
|
|
- 需要请求重试、权限校验、限流处理、schema 校验和幂等写库
|
|
|
|
## 当前状态：规划占位
|
|
|
|
- **本目录当前为规划占位**，仅保留最小结构（`README.md`、`scripts/`、`tests/` 占位）。
|
|
- **尚未沉淀可复制实现**；目录内无参考代码。
|
|
- **AI 编程工具不得**基于空目录自行脑补 API 对接实现。
|
|
- 后续补齐可复制案例后，再按 README copy map 选择性复制到新技能 `scripts/`。
|
|
|
|
## 轻量结构
|
|
|
|
```text
|
|
real_api/
|
|
README.md
|
|
scripts/
|
|
service/
|
|
util/
|
|
tests/
|
|
```
|
|
|
|
不要在本目录添加 `SKILL.md`、市场 README、`references/`、`development/`、`.github/` 等完整 skill 仓库层文件。
|
|
|
|
## 复制边界（待案例补齐后生效）
|
|
|
|
- 参考代码将从 `examples/real_api/scripts/` 选择性复制到新技能 `scripts/`
|
|
- 根 `README.md`、`SKILL.md`、`references/` 仍按模板主目录规则编写
|
|
- 当前阶段：**不可作为实现参考**
|