Menu
设计接口契约 — 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/design-an-interface/。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
通用需求分析到开发设计工作流 — thin Skill router,加载规则与路径按声明。Use when starting any new feature requiring structured analysis-to-delivery workflow.
分析到交付的入口 — 根据你的目标(配置/澄清/BRD/PRD/合规/开发/审计/交接)路由到正确的 user-invoked skill。不确定该用哪个 analysis-to-delivery skill 时,从此入口进入。
严守 9 阶段流程(分析-设计)— 适合新手/复杂项目,按顺序自动调 9 个 user-invoked skill。希望按完整结构化流程、逐步推进且不需每步自行决策时调用本编排。
反复提问澄清需求,产出设计稿 — 来自 superpowers 体系(obra/superpowers)。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/brainstorming/。
梳理领域模型 — 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/domain-modeling/。
逐步按计划执行 + 复盘 — 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/executing-plans/。
| name | design-an-interface |
| description | 设计接口契约 — 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/design-an-interface/。 |
| version | 4.0.0 |
stage-gate/domain-modeling or /writing-plans本仓库不维护此 skill 的内容。完整纪律请读:
<SUPERPOWERS_SKILL_ROOT>/design-an-interface/SKILL.md
/domain-modeling 或 /writing-plansdisciplines/stage-gate 第 2 层如果 <SUPERPOWERS_SKILL_ROOT>/design-an-interface/ 不存在,按以下 4 步产出接口契约:
每个接口必须含 5 列:
| 列 | 含义 | 例子 |
|---|---|---|
| Name | 方法/路径名 | POST /api/v1/asn/receive |
| Input | 入参 schema | {tcAsnId, lpnList[]} |
| Output | 出参 schema | {receivedQty, exceptionList[]} |
| Errors | 错误码字典 | E_ASN_NOT_FOUND(40401) |
| Pre/Post | 前置/后置条件 | 前置:ASN 状态=10;后置:状态=30 |
09-QA审计报告 的错误码字典一致disciplines/no-field-guessing)写到 docs/superpowers/specs/<topic>-interface.md,末尾 ## Sign-off 等用户白名单签字(4 句之一)。
npx skills@latest add obra/superpowers-design-an-interface