mcpField
S
software-design

software-design

github.com/yinhunfeixue开发450 次安装22 周前更新
代码仓库

关于 software-design

software-design 是一项将需求转化为可执行模块设计的技能,面向软件开发团队。它通过分批评审、文档拆分和阶段检查明确模块边界、接口、交互与依赖。

主要功能

  1. 01按批次设计并经开发者评审
  2. 02输出模块职责、边界与接口
  3. 03按前后端规范拆分设计文档
  4. 04记录模块依赖并检查循环依赖
  5. 05通过评审后进入下一阶段

适用场景

  1. 01将需求清单转化为模块方案
  2. 02为前端和后端分别编写设计文档
  3. 03检查需求覆盖及模块依赖
  4. 04在进入开发规划前执行设计评审

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yinhunfeixue/software_development_skills --skill software-design

安装后在 Claude Code 中输入/software-design确认已加载。

附带文件backend-design.mdfrontend-design.md

详细介绍

来自项目 README

软件设计

依赖规范

#[[file:../rules/review-base.md]] #[[file:../rules/git-workflow.md]] #[[file:../rules/project-structure.md]] #[[file:frontend-design.md]] #[[file:backend-design.md]]

目的

将需求转化为可执行的模块设计方案,明确模块边界、接口和 UI 交互。

输入

  • 需求文档:需求清单 + 范围边界说明,或对话上下文

步骤

每个步骤先输出标题,再输出结果

  • 分批设计:设计拆成批次,每批次完成模块边界、接口和交互流程,与开发者 review 确认,记录设计决策
  • 文档拆分:根据项目架构,按 frontend-design 和 backend-design 规范分别输出对应的设计文档
  • 模块依赖:所有模块设计完成后,标注模块间的依赖关系
  • 写入文档:每个模块单独一个文件,创建入口文档引用所有设计文件(路径遵守 project-structure 文档存放规范)
  • 执行 review:遵守 review-base,通过后才进入下一步

输出

  • 模块划分方案:职责、边界
  • 模块依赖关系:标注模块间的依赖,无依赖的模块不需要列出
  • 前端设计文档:按 frontend-design 规范输出(涉及前端时)
  • 后端设计文档:按 backend-design 规范输出(涉及后端时)

Review 检查清单

  • 模块职责:单一,边界清晰,无职责重叠
  • 前端设计:符合 frontend-design 规范(涉及前端时)
  • 后端设计:符合 backend-design 规范(涉及后端时)
  • 模块依赖:依赖关系已标注,无循环依赖
  • 需求覆盖:覆盖所有已确认的需求,无遗漏
  • 公共模块:已识别,无重复设计
  • 敏感信息:设计文档中不包含真实密码、密钥、token 等敏感信息,使用占位符代替

阶段结束

下一阶段:dev-planning

#[[file:../rules/stage-gate.md]]

评论

支持 Markdown