25 lines
1.6 KiB
Markdown
25 lines
1.6 KiB
Markdown
---
|
|
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`、构建文件、锁文件或源码证据确认，不默认最新版本。
|
|
- 对现有系统的设计先追踪真实调用链和数据流，区分已验证事实与建议。
|
|
- 不把接口示例、表结构草案或伪代码视为已实施行为。
|