基于 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 测试全部通过
36 lines
1.2 KiB
Markdown
36 lines
1.2 KiB
Markdown
# Simulator API Example
|
|
|
|
这个目录用于沉淀「仿真环境 / API」类 skill 的可复制成功案例。
|
|
|
|
## 适用场景(规划)
|
|
|
|
- 使用 mock / sandbox / simulator API
|
|
- 不需要启动浏览器
|
|
- 适合演示输入校验、API 调用、结果入库、日志、错误契约和测试
|
|
|
|
## 当前状态:规划占位
|
|
|
|
- **本目录当前为规划占位**,仅保留最小结构(`README.md`、`scripts/`、`tests/` 占位)。
|
|
- **尚未沉淀可复制实现**;目录内无参考代码。
|
|
- **AI 编程工具不得**基于空目录自行脑补 mock API 或仿真接口实现。
|
|
- 后续补齐可复制案例后,再按 README copy map 选择性复制到新技能 `scripts/`。
|
|
|
|
## 轻量结构
|
|
|
|
```text
|
|
simulator_api/
|
|
README.md
|
|
scripts/
|
|
service/
|
|
util/
|
|
tests/
|
|
```
|
|
|
|
不要在本目录添加 `SKILL.md`、市场 README、`references/`、`development/`、`.github/` 等完整 skill 仓库层文件。
|
|
|
|
## 复制边界(待案例补齐后生效)
|
|
|
|
- 参考代码将从 `examples/simulator_api/scripts/` 选择性复制到新技能 `scripts/`
|
|
- 根 `README.md`、`SKILL.md`、`references/` 仍按模板主目录规则编写
|
|
- 当前阶段:**不可作为实现参考**
|