feat(dev): 新增开发分析与设计 Skill

This commit is contained in:
zhiye.sun
2026-08-25 17:39:57 +08:00
parent 6bc3d84018
commit 5b9fa51b6e
25 changed files with 318 additions and 13 deletions
@@ -0,0 +1,11 @@
# 映射规则
按页面动作建立接口清单,再分别映射请求和响应:
- 字段的业务含义、路径、必填条件、基数、空值和默认值。
- 前端表示与传输类型,以及初始化和提交两个方向的转换。
- 标识符精度、金额精度、日期时间格式与时区、枚举值域和嵌套结构。
- 查询、分页、排序、筛选、批量和文件传输约定。
- 成功、业务拒绝、输入错误、认证授权失败和系统失败的呈现需求。
名称不同但含义一致时记录映射证据;名称相同但含义或单位不同时列为冲突。未匹配字段和缺失接口必须完整保留,不用猜测值或临时 Mock 隐藏缺口。
@@ -0,0 +1,11 @@
# API 对接评审
- 每个页面动作是否有明确接口或缺失说明。
- 请求方法、路径、参数位置和内容类型是否来自真实契约。
- 请求与响应字段是否覆盖页面需要,未匹配项是否完整。
- 双向转换是否处理精度、空值、时区、枚举和嵌套对象。
- 分页、排序、批量和文件行为是否有契约依据。
- 错误、权限、幂等、重复提交和并发更新是否可处理。
- 契约版本、弃用、兼容期和环境差异是否说明。
- 是否避免从 API 描述反向修改用户已确认的展示文案。
- 未运行真实联调时,是否明确结果仅为静态契约分析。
@@ -0,0 +1,11 @@
# 契约来源
优先使用与目标环境和版本一致的契约:
1. 用户指定的正式 OpenAPI 或其他机器可读契约。
2. 当前项目生成并用于目标环境的接口文档。
3. 服务端控制器、请求响应模型、校验和契约测试。
4. 经过项目维护的 Markdown 文档和示例。
5. 用户明确说明的临时约定。
记录来源路径、版本或提交、生成时间和已知偏差。多个来源冲突时不自动裁决;列出冲突并由契约所有者确认。示例响应只能证明示例形态,不能代替完整字段约束。