skill-template/examples/real_api/README.md

Real API Example

这个目录用于沉淀「真实系统 API」类 skill 的可复制成功案例。

适用场景（规划）

• 目标系统提供真实 API
• 需要 token / secret / credential
• 需要请求重试、权限校验、限流处理、schema 校验和幂等写库

当前状态：规划占位

• 本目录当前为规划占位，仅保留最小结构（README.md、scripts/、tests/ 占位）。
• 尚未沉淀可复制实现；目录内无参考代码。
• AI 编程工具不得基于空目录自行脑补 API 对接实现。
• 后续补齐可复制案例后，再按 README copy map 选择性复制到新技能 scripts/。

轻量结构

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/ 仍按模板主目录规则编写
• 当前阶段：不可作为实现参考