chore: auto release commit (2026-06-17 09:21:19)

examples/real_api/README.md

@@ -1,15 +1,35 @@
 # Real API Example
 
-这个目录用于沉淀“真实系统 API”类 skill 的可复制成功案例。
+这个目录用于沉淀「真实系统 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/` 仍按模板主目录规则编写
+- 当前阶段：**不可作为实现参考**