ai-delivery-spec · git:20260908.a33edf6 · 2026-09-08 · sha256 0273d8d44361f21c

ai-delivery-spec git:20260908.a33edf6A

Immutable. This exact content is served forever at /api/v1/blob/0273d8d44361f21c.

---
name: ai-delivery-spec
license: Apache-2.0
description: Clarify, create, review or change product, service and office workflow requirements, PRDs and interactive prototypes. Use for vague goals, process improvements, spreadsheet/form rules, small UI edits and changes to existing systems, even without the word requirement. 中文:产品、服务及办公流程的需求判断、深挖澄清、PRD、原型、变更与验收;一句话想法、表单/表格规则和微小改动也适用。明确的纯翻译、排版、抄录或既定步骤执行由对应工具直接处理。
---

# AI Delivery Spec 5.5.0 — 需求判断与交付

帮助用户作出当前需要的产品决定,让实施者准确理解,并在变更后保持有效。跟随用户语言;代码、字段和稳定 ID 保留原名。

面向业务/产品、设计、前后端、QA 与 Coding Agent;从想法、存量材料或变更进入,各角色共用业务约定,不重复建文档。

## 从当前目标进入

识别用户要解决问题、比较方案、明确规则、获得原型,还是审查已有改变。已有决定直接继承;不因模板要求重复批准。`/ads`、`/dig`、`/prd`、`/proto` 只表达意图,宿主是否支持裸命令由实际能力决定。

明确局部小改:读取相关基线,直接完成差异、继承边界、正反验收和未证明事项;没有关键未知就不提问、不建生命周期文件。复杂或模糊任务才读取对应参考,不默认走全流程。

办公任务涉及目标取舍、业务口径、权限或流程改变时同样适用;完成必要澄清后交给文档、表格或自动化工具执行。纯格式整理或既定步骤执行直接使用对应工具,不为命中本 Skill 制造问题。

| 当前需要 | 按需读取 |
|---|---|
| 判断问题、比较方案、澄清 | [discover.md](references/discover.md) |
| 明确业务行为与可实施规格 | [specify.md](references/specify.md) |
| 存量盘点、生成或修改可操作原型 | [prototype.md](references/prototype.md) |
| 用户需要双态评审 | [review-workspace.md](references/review-workspace.md) |
| 准入、处置、责任与基线 | [lifecycle.md](references/lifecycle.md) |
| 变更、交接反馈或验收 | [change-acceptance.md](references/change-acceptance.md) |
| 多文件、大上下文或跨会话 | [context.md](references/context.md) |
| 机器路由、模板或检查命令 | [stages.md](references/stages.md) |

不预加载全部模板或领域包。涉及行业规则,先按 [领域检索指引](references/stages.md#领域检索) 取当前问题切片和来源基线,再核实有权原文及版本;中英文同样执行。语言不决定法域,来源须匹配辖区与适用对象,不能照抄成项目真相。

## 保持业务含义与决定权

- 分清已核实事实、授权决定、观察、建议和未知。来源按主题、版本和授权范围判断;原型行为不自动成为产品规则。
- 最新有效决定覆盖同主题旧内容。文档待同步、旧评审待复验不使该决定重新变成待批准。真正超出授权或存在冲突时只处理相应范围。
- 建议暂缓、不做、缩范围写回现有产物;未获处置权不得改变需求状态。记录理由、依据和复议条件;已获授权不重复询问。
- 未定规则保持未定。退路可以限制执行,不能借“保守默认”选定补考、口径、权限或晚到数据政策。未知只阻断依赖它的交付。

## 最小充分规格

实施者仍可能作出互不兼容的关键业务选择时,补足该处语义;技术实现保留合理空间。说明行为前提、允许者、业务结果、失败恢复及可判验收。按实际风险补状态、权限、指标、外部数据或历史对象约定,不按角色数或旧等级加长文档。

一条业务事实只在一个位置人工定义;页面、流程、原型说明与交接引用同一含义。业务审批记录和需求评审记录是不同对象;审核通过是发布前提时,不擅自合并成自动发布。

对关键规则选少量业务反例;标签缺失不能掩盖内容中的风险。接收者复述一致还须核对来源,不能以模型多数票证明正确。明确小改不附加全角色冷读报告。

工具的正文 GAP 是待核实分歧,不是已证明缺陷;未命中也不是语义通过。模型须回读对应规则和真实来源,检查适用条件、相反路径及下游后果;不能为消除 GAP 编造政策、来源或评阅 pass。

## 变更与完成

存量原型先盘点受影响页面、角色、入口、动作/处理器、状态、实体、数据源和 Mock 边界;保护未经取消的基线功能与视觉约定。产品态默认可操作;双态评审按用户需要启用。

关键变更找到写入者、读取者、指标、入口、旧对象和受影响证据。候选依赖与核实结果分开,核实依赖不等于批准修改。多方修改前核对当前基线,不能静默覆盖漂移。

达到用户目标就停止。检查只在需要的里程碑执行,不默认 full/handoff。静态、语义评阅、浏览器、真实系统与业务签署分别说明范围、版本及结果;没运行写未运行。小范围通过不代表全项目完成,建议被采纳不代表实现已验收。

本 Skill 管需求及其产物;工程方案、排期、编码、部署和运营由相应工作流负责,只接收必要反馈与证据。私人材料与凭据不进入公共示例;外部写入遵守用户实际授权。