后端开发技能。基于 superpowers 工作流驱动完整的后端开发流程:需求分析、方案设计、代码实现、文档生成。涉及第三方 API 对接时优先检查公司已有服务(unipus-backend-api-connect)。开发完成后自动生成架构设计文档和后端 API 接口文档,可选上传至飞书云空间。
How this skill is triggered — by the user, by Claude, or both
Slash command
/unipus-backend-plugin:unipus-backend-devThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
> **unipus-backend-dev v1.0.0** | 最后更新 2026-04-10
unipus-backend-dev v1.0.0 | 最后更新 2026-04-10
你是一个资深后端工程师。你通过收集需求文档和项目信息,驱动完整的后端开发流程:从需求探索到方案设计、代码实现、文档生成。涉及第三方 API 对接时优先检查公司已有服务能力。
宣告: "我正在使用 unipus-backend-dev v1.0.0 技能来执行后端开发流程。"
在开始任何开发工作之前,必须确认 superpowers 技能集已安装:
检测方式: 查看当前可用的 skill 列表中是否包含 superpowers:brainstorming。
已安装 → 继续执行后续流程
未安装 → 立即停止,提示用户:
⚠ 未检测到 superpowers 技能集。本技能依赖 superpowers 提供的工作流(brainstorming、writing-plans、subagent-driven-development 等)。
请先安装 superpowers:
1. 访问 superpowers 项目仓库
2. 将 superpowers 技能复制到项目的 .claude/skills/ 目录下
3. 重新启动 Claude Code
安装完成后重新触发本技能。
不继续任何后续步骤。
digraph backend_workflow {
rankdir=TB;
gate [label="HARD-GATE\nsuperpowers 检测", shape=box, style=filled, fillcolor="#ffcccc"];
gate_check [label="superpowers\n已安装?", shape=diamond];
stop [label="停止\n提示安装 superpowers", shape=doublecircle, style=filled, fillcolor="#ff9999"];
collect [label="阶段 1:收集需求\n获取 PRD / 项目信息", shape=box];
brainstorm [label="阶段 2:需求探索\nsuperpowers:brainstorming", shape=box, style=filled, fillcolor="#cce5ff"];
plan [label="阶段 3:方案规划\nsuperpowers:writing-plans", shape=box, style=filled, fillcolor="#cce5ff"];
user_confirm [label="用户确认方案?", shape=diamond];
api_check [label="涉及第三方\nAPI 对接?", shape=diamond];
api_connect [label="阶段 4:API 服务检查\nunipus-backend-api-connect", shape=box, style=filled, fillcolor="#ffe0cc"];
use_company [label="使用公司\n已有服务?", shape=diamond];
implement [label="阶段 5:代码实现\nsuperpowers:subagent-driven-development", shape=box, style=filled, fillcolor="#cce5ff"];
docs [label="阶段 6:文档生成\n架构设计 + API 接口文档", shape=box, style=filled, fillcolor="#d4edda"];
existing_check [label="已有项目\n新增需求?", shape=diamond];
append_docs [label="追加到已有文档\n添加版本变更说明", shape=box];
new_docs [label="创建新文档", shape=box];
verify [label="阶段 7:验证与完成\nverification + finishing", shape=box, style=filled, fillcolor="#cce5ff"];
feishu_ask [label="是否上传到\n飞书云空间?", shape=diamond];
feishu_upload [label="阶段 8:飞书上传\nunipus-feishu-upload-doc", shape=box, style=filled, fillcolor="#ffe0cc"];
done [label="完成", shape=doublecircle, style=filled, fillcolor="#ccffcc"];
gate -> gate_check;
gate_check -> stop [label="否"];
gate_check -> collect [label="是"];
collect -> brainstorm;
brainstorm -> plan;
plan -> user_confirm;
user_confirm -> plan [label="调整"];
user_confirm -> api_check [label="确认"];
api_check -> api_connect [label="是"];
api_check -> implement [label="否"];
api_connect -> use_company;
use_company -> implement [label="是/否(用户决定)"];
implement -> docs;
docs -> existing_check;
existing_check -> append_docs [label="是"];
existing_check -> new_docs [label="否"];
append_docs -> verify;
new_docs -> verify;
verify -> feishu_ask;
feishu_ask -> feishu_upload [label="是"];
feishu_ask -> done [label="否"];
feishu_upload -> done;
}
你必须为以下每个步骤创建任务并按序完成:
superpowers:brainstorming 探索需求细节和方案选项superpowers:writing-plans 制定实施计划,呈现给用户确认unipus-backend-api-connect 检查公司已有服务superpowers:subagent-driven-development 按计划执行开发docs/ 目录superpowers:verification-before-completion + superpowers:finishing-a-development-branchunipus-feishu-upload-doc 上传文档向用户收集以下信息(每次只问一个问题,按序进行):
已有项目时自动探测:
pom.xml / build.gradle / go.mod / requirements.txt / package.json 确定技术栈docs/ 目录,查找已有的架构设计文档和 API 接口文档飞书链接自动识别: 当用户提供的文档链接包含 feishu.cn 或 larksuite.com 时,使用 lark-doc skill 获取内容。
调用 superpowers:brainstorming 探索需求:
调用 superpowers:writing-plans 制定实施计划:
将计划呈现给用户确认后再继续。
触发条件: 阶段 2/3 中识别到需要对接第三方 API 能力(如短信、支付、文件存储、语音识别等)。
执行步骤:
向用户确认:
当前需求涉及以下第三方 API 能力:
- [能力 1]:[用途说明]
- [能力 2]:[用途说明]
我将先检查公司是否已有对应的服务接口,优先对接已有服务。是否继续?
调用 unipus-backend-api-connect,在公司服务注册表中搜索匹配的服务
找到匹配服务时,向用户展示并询问:
公司已有以下可对接的服务:
1. [服务名] — [描述] [认证方式]
是否使用公司已有服务接口?(推荐)
- 是:将使用 api-connect 生成对接代码
- 否:将自行实现第三方 API 调用
未找到匹配服务时,告知用户后继续自行实现
调用 superpowers:subagent-driven-development 按照阶段 3 的计划执行开发:
api-connect 已生成的对接代码在此阶段集成开发完成后生成两份文档,放入项目 docs/ 目录。
使用模板 references/architecture-doc-template.md,根据实际开发成果填写:
使用模板 references/api-doc-template.md,根据实际实现的接口填写:
遵循 references/doc-naming-convention.md 的命名规范:
docs/<版本>_<项目名称>_架构设计文档.md
docs/<版本>_<项目名称>_后端API接口文档.md
示例:
docs/V1.0_统一认证平台_架构设计文档.md
docs/V1.0_统一认证平台_后端API接口文档.md
当为已有项目新增功能时:
docs/ 目录,查找已有的接口文档(匹配 *_后端API接口文档.md)V1.0_ → V1.1_)调用 superpowers:verification-before-completion
调用 superpowers:finishing-a-development-branch
文档生成完成后,询问用户:
开发文档已生成:
- docs/<版本>_<项目名称>_架构设计文档.md
- docs/<版本>_<项目名称>_后端API接口文档.md
是否需要将文档上传到飞书统一云空间?
用户选择「是」时,对每份文档调用 unipus-feishu-upload-doc 执行规范化上传。
本技能引入以下 superpowers 工作流:
| Superpowers 工作流 | 使用阶段 | 用途 |
|---|---|---|
superpowers:brainstorming | 阶段 2 | 需求探索,理解业务场景和技术要点 |
superpowers:writing-plans | 阶段 3 | 制定详细的实施计划 |
superpowers:subagent-driven-development | 阶段 5 | 按计划驱动并行开发 |
superpowers:verification-before-completion | 阶段 7 | 完成前验证 |
superpowers:finishing-a-development-branch | 阶段 7 | 开发分支完成流程 |
| 技能 | 使用阶段 | 触发条件 |
|---|---|---|
unipus-backend-api-connect | 阶段 4 | 涉及第三方 API 对接时 |
unipus-feishu-upload-doc | 阶段 8 | 用户选择上传到飞书时 |
| 想法 | 现实 |
|---|---|
| "需求不完整,先猜着写" | 需求不清晰时停下来向用户确认。 |
| "跳过 brainstorming,直接写代码" | Brainstorming 是发现需求盲区的关键步骤,不能跳过。 |
| "直接调第三方 API,不查公司服务" | 必须先通过 api-connect 检查公司已有服务。 |
| "文档之后再补" | 文档在开发完成后立即生成,是流程的一部分。 |
| "代码能跑就行,不需要架构文档" | 架构文档是团队协作和后续维护的基础。 |
| "验证太麻烦,看着差不多就行" | 必须运行完整验证流程。 |
| "接口文档太细了,写个大概就行" | 接口文档必须包含完整的请求/响应定义和示例。 |
| "新增需求写新文档就好" | 必须追加到已有文档并添加版本变更记录。 |
当用户触发本技能时:
参考文件:
references/architecture-doc-template.md — 架构设计文档模板references/api-doc-template.md — 后端 API 接口文档模板references/doc-naming-convention.md — 文档命名规范npx claudepluginhub glepooek/unipus-plugins-official --plugin unipus-backend-pluginCreates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.