القائمة
设计接口契约 — 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/design-an-interface/。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
通用需求分析到开发设计工作流 — 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