Files
query-payslip-default/examples/real_api
skill-dev 3db196e49d feat: 工资查询助手首版 v1.0.105
基于 skill-template 脚手架开发,包含:
- payroll_config(费率配置,可编辑)+ payslip_snapshots(解析历史,只读)2 张业务表
- 全国默认 + 北上广 4 套费率(社保/公积金/个税起征点/7 级税率表)
- 5 个业务 Action:calculate-payslip-simple / calculate-payslip-full / explain-term / view-config / edit-config
- 个税累计预扣法计算,支持多月历史累加
- 20 个薪资名词库(社保/公积金/个税/全勤/加班费等)
- 完整市场文档(README/TUTORIAL/DEMO/CHANGELOG)
- 296 测试全部通过
2026-09-07 17:02:05 +08:00
..

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