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,24 @@
---
name: design-backend
description: 基于需求、现有后端代码和项目规范设计模块边界、服务职责、数据影响、事务、错误处理和接口需求。适用于新功能或复杂后端变更的技术设计;直接编码、单纯数据库建模、HTTP 契约细化或前端设计不应触发。
---
# 后端设计
形成可由实现人员执行和验证的后端设计,不生成业务代码,不内置特定 Java、Spring 或公司框架规则。
## 工作流
1. 读取需求、项目元数据、适用规范、依赖清单和相关后端实现,确认语言、框架及精确版本。
2. 按 [范围分析](references/scope.md) 明确现状、边界、参与者和约束。
3. 设计模块职责、调用关系、数据所有权、事务边界、并发策略、错误语义、权限和可观测性。
4. 数据库或 HTTP 契约需要详细设计时,记录输入和待决项,交由相应专项 Skill;本 Skill 保持整体一致性。
5. 按 [设计输出](references/output.md) 展示方案、备选项和风险,并用 [评审清单](references/review.md) 自检。
6. 默认在对话中输出;用户要求落盘时,先确认项目约定路径并保守写入。
## 边界
- 项目规则通过 `guidance` 获取;不存在的规范、框架能力和依赖接口不得猜测。
- 版本从 `.craftkit/project.json`、构建文件、锁文件或源码证据确认,不默认最新版本。
- 对现有系统的设计先追踪真实调用链和数据流,区分已验证事实与建议。
- 不把接口示例、表结构草案或伪代码视为已实施行为。
@@ -0,0 +1,4 @@
interface:
display_name: "后端设计"
short_description: "设计后端边界、数据影响和运行约束"
default_prompt: "使用 $design-backend 为当前需求制定后端技术设计。"
@@ -0,0 +1,13 @@
# 后端设计输出
按任务需要包含:
1. 目标、范围外事项和现状证据。
2. 模块与服务职责、依赖方向及关键时序。
3. 领域对象、状态变化和数据所有权。
4. 持久化影响、事务、并发和一致性策略。
5. 接口需求、错误语义、权限和审计需求。
6. 兼容、迁移、回滚、监控和测试策略。
7. 备选方案、取舍、待确认项和实现交接清单。
避免用固定文档模板掩盖缺失信息;简单变更可以缩减为最小充分设计。
@@ -0,0 +1,10 @@
# 后端设计评审
- 职责和依赖方向是否清晰,是否引入循环或重复所有权。
- 事务边界是否覆盖真实状态变化,并说明失败后的状态。
- 并发、幂等、重试、超时和外部调用顺序是否明确。
- 输入信任边界、权限、敏感数据和审计要求是否覆盖。
- 数据与接口变化是否具有兼容和迁移方案。
- 日志、指标、追踪和告警是否围绕关键失败设计。
- 测试是否覆盖正常、边界、拒绝、并发和恢复路径。
- 框架版本和依赖能力是否有项目证据。
@@ -0,0 +1,11 @@
# 后端设计范围
设计前确认:
- 入口、调用者、下游依赖和外部系统边界。
- 当前模块职责、数据所有权和已有扩展点。
- 输入、输出、状态变化、失败路径和幂等要求。
- 事务、一致性、并发、批量规模、性能和安全约束。
- 数据迁移、兼容期、灰度、回滚和可观测性需求。
只有需求或项目证据支持的内容才能作为约束;产品决策、运行参数和外部契约缺失时列为待确认。