ai-delivery-spec · git:20261026.cf5f1e9 · 2026-10-26 · sha256 9aa97b630a2ca01d
ai-delivery-spec git:20261026.cf5f1e9A
Immutable. This exact content never changes and is served at /api/v1/blob/9aa97b630a2ca01d.
--- name: ai-delivery-spec license: MIT 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.5 — 需求判断与交付 让产研和 AI 凭交付件实现业务,保留有效基线与稳定 ID。 ## 从当前目标进入 识别用户要解决问题、比较方案、明确规则、获得原型,还是审查已有改变。已有决定直接继承;不因模板要求重复批准。`/ads`、`/dig`、`/prd`、`/proto` 只表达意图,宿主是否支持裸命令由实际能力决定。 局部小改:读取相关基线,完成差异、继承边界和正反验收;没有关键未知就不提问、不建生命周期文件。不默认走全流程。 按依赖澄清、写规格/原型、追溯、验证;已有答案直接进入所需阶段。先解决业务分歧,标题用业务名称。 办公任务改变目标、口径、权限或流程同样适用;纯格式整理和既定步骤交对应工具。 | 当前需要 | 按需读取 | |---|---| | 判断问题、比较方案、澄清 | [discover.md](references/discover.md) | | 轻量规格、正式 PRD 与模块交接 | [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#领域检索) 取当前问题切片和来源基线,再核实有权原文及版本;中英文同样执行。语言不决定法域,来源须匹配辖区与适用对象,不能照抄成项目真相。 ## 保持业务含义与决定权 - 分清事实、授权决定、观察、建议和未知。硬条件核对当前来源;示例只借写法,不移植权限、状态或协议。原型行为不自动成为规则。 - 最新有效决定覆盖同主题旧内容。文档待同步、旧评审待复验不使该决定重新变成待批准。真正超出授权或存在冲突时只处理相应范围。 - 建议暂缓、不做、缩范围写回现有产物;未获处置权不得改变需求状态。记录理由、依据和复议条件;已获授权不重复询问。 - 未定规则保持未定。退路可以限制执行,不能借“保守默认”选定补考、口径、权限或晚到数据政策。未知只阻断依赖它的交付。 ## 最小充分规格 实施者仍可能作出互不兼容的关键业务选择时,补足该处语义;技术实现保留合理空间。说明行为前提、允许者、业务结果、失败恢复及可判验收。按实际风险补状态、权限、指标、外部数据或历史对象约定,不按角色数或旧等级加长文档。 按用户任务和对象集中写。字段对齐录入与展示;元素说明位置、类型、条件、权限、结果和恢复;验收用业务标题就地写前提、操作、预期,ID辅助追溯。复杂交接读[成品示例](examples/configuration-to-consumption.md),勿让人跨表拼读。说明规则不等于新增配置项;模板按需删减,变更回填原处。 用独立反例核对对象、操作者与触发事件;局部不变不冻结其他事件,允许等价实现。结构通过不证明业务正确,见[成品反例](examples/configuration-to-consumption.md#异步写入与真实接收)。 正文 GAP 是待核实分歧,未命中也不证明通过。回读规则与来源,检查条件、反向路径和下游;不能为消除 GAP 编造政策、来源或 pass。 ## 变更与完成 存量原型先盘点受影响页面、角色、入口、动作/处理器、状态、实体、数据源和 Mock 边界;保护未经取消的基线功能与视觉约定。产品态默认可操作;双态评审按用户需要启用。 关键变更找到最终处理器、写入者、读取者、指标、入口、旧对象和受影响证据。未读不等于缺失;旧定义不代表当前行为。候选依赖与核实结果分开,核实依赖不等于批准修改。多方修改前核对当前基线,不能静默覆盖漂移。 达到用户目标就停止。检查只在需要的里程碑执行,不默认 full/handoff。静态、语义评阅、处理器模拟、浏览器、真实系统与业务签署分别说明范围、版本及结果;没运行写未运行。小范围通过不代表全项目完成,建议被采纳不代表实现已验收。 本 Skill 管需求及其产物;工程方案、排期、编码、部署和运营由相应工作流负责,只接收必要反馈与证据。私人材料与凭据不进入公共示例;外部写入遵守用户实际授权。