القائمة
将一句话想法、客户材料、存量系统或 ToC/ToB/ToG 需求，按使用者指定的进入阶段和停止阶段，转化为可评审、可实施、可追溯、可验收的人类与 Coding Agent 共用需求产物。支持问题定义、方案探索、需求准入、澄清、统一 PRD、工程原型、评审基线、变更影响和验收证据；不负责排期、编码、CI/CD、部署和运营。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | ai-delivery-spec |
| description | 将一句话想法、客户材料、存量系统或 ToC/ToB/ToG 需求，按使用者指定的进入阶段和停止阶段，转化为可评审、可实施、可追溯、可验收的人类与 Coding Agent 共用需求产物。支持问题定义、方案探索、需求准入、澄清、统一 PRD、工程原型、评审基线、变更影响和验收证据；不负责排期、编码、CI/CD、部署和运营。 |
本 Skill 是 Requirement Management Kernel：让业务、产品、设计、前后端、架构、需求交付/技术负责人、测试、合规和 Coding Agent 在需求任一阶段进入，得到当前需要的最小合格产物后离开；也可在用户明确要求时持续完成端到端闭环。
默认跟随用户当前语言生成标题、正文、表格、问题与测试；稳定 ID、代码、API/字段名和专有名词保持原样。双语必须由用户明确要求。
只使用 Agent 完成需求工作不要求安装 Python；运行本地零模型门禁时需要 Python 3.10+：python -m pip install -r scripts/requirements.txt。Stable ID 是长期不变的需求编号；Gate 是静态结构门禁，不等于业务、浏览器、实现或客户验收。
内部识别两个字段，不要求用户学习参数：
entry_stage：从现有材料和当前工作位置进入。target_stage：本次要拿到的产物/停止点。工作站为 frame → explore → intake → clarify → specify → review → baseline，基线可进入 change 或 acceptance，变更须重新基线。frame/explore 是准入前工作区；正式 REQ-* 生命周期从 intake 开始。用户可从任意有证据的阶段进入，不强迫补跑无关前序。
显式目标最高优先；“不要写 PRD，只做澄清”等否定约束高于关键词。目标未明时选择能解决当前问题的最小产物，并继续可逆工作；只有产物选择会实质改变范围时才提问。单次任务到目标即停，明确端到端任务则持续到目标且不得把中间模板或静态 PASS 当成完成。
需要跨会话或检查旧产物时才运行确定性路由；它不解析自然语言：
python scripts/ai_delivery_spec_cli.py route-stage --target <stage> --artifact <path>
| 当前任务 | 只读取 |
|---|---|
| 任意阶段进入/停止、角色交接、断点 | references/stages.md |
| 来源盘点、问题发现、竞品/现状研究 | references/discover.md |
| 正式生命周期、准入、评审、基线 | references/lifecycle.md |
| PRD、字段、规则、指标、接口、机器附录 | references/specify.md |
| 页面合同、Stage 0、原型、视觉路线 | references/prototype.md |
| 变更、双向追溯、验收结果 | references/change-acceptance.md |
| 大输入、ID 切片、检查点、Agent 工作区 | references/context.md |
| Coding/需求协作工具投影 | references/tool-adapters.md |
| 故障恢复、FAQ、反模式 | references/troubleshooting.md |
| 领域证据 | scripts/query_domain.py --domain <pack> --section "<heading>" |
| 私有领域/模板/规则 | `init-custom --sharing local |
一次只加载当前阶段参考、一个精确领域章节和当前 ID 切片。不要加载 README、maintainer/、全模板/示例/领域包或整个仓库。frame/explore 仅在法规、安全或行业物理约束会改变选项时加载领域知识。
problem-brief.md，说清用户、痛点时刻、成功信号、事实/假设和下一步。solution-sketch.md，至少两个选项和不做选项，包含可证伪 ASM-*、最小验证与停止条件。requirement-brief.md，内嵌 DEC-*、规则、开放 UNK-* 和退路；多决策人/审计才拆侧车。required_review_types 全部结构化签署后绑定权威来源、版本/hash 和消费方。CHG-* 与 ARUN-* 回链当前基线。假设寄存器仅在跨会话、跨角色复用或治理时单独导出。YAML/JSON 是工具投影，不是另一份 PRD。
UNK-*，包含责任人、范围、blocks_stage 和回退路径。ASM-* 是待验证解释；UNK-* 是缺失事实/决策。两者不得互换。P0 未知项只阻断受影响且已到达的阶段。REQ-* 绑定来源、行为、字段/规则、AC、测试与证据，并支持 both directions 追溯；缺少语义时开发与 Agent 必须回报 GAP，不能发明。统一状态只有 PASS、REVIEW_COMPLETE_WITH_GAPS、BLOCKED_BY_P0_UNKNOWN、BLOCKED。早期阶段：
python scripts/ai_delivery_spec_cli.py gate --profile frame --artifact problem-brief.md
python scripts/ai_delivery_spec_cli.py gate --profile explore --artifact solution-sketch.md
python scripts/ai_delivery_spec_cli.py gate --profile clarify --artifact requirement-brief.md
正式规格沿用 gate --profile requirement|prd|prototype|handoff|full。静态门禁必须输出 not_proven，不能把结构通过宣传为领域正确、真实运行或客户签收。单产物 PASS 不等于交付闭环；宣称最终完成前必须 gate --profile full（或 handoff）组合门禁通过。
5.4 模板用语言无关的 <!-- ADS:* --> 锚点，标题可按团队语言/模板改变。resume_context 记录相对路径、阶段和 SHA-256；漂移、缺失和路径越界必须阻断。大项目仍用执行检查点和 ID Slice，产物断点不能替代执行状态。
schemas/agent-handoff.schema.json 只把已基线需求投影给 Coding Agent；schemas/domain-candidate.schema.json 只登记本地候选知识。私有扩展优先于官方默认，但绑定规则冲突必须形成 DEC-CONFLICT-*，禁止静默覆盖或联网外发。
研发排期、Sprint/任务、代码生成、CI/CD、部署、监控和运营属于下游系统。本 Skill 管到需求验收；外部状态只记引用，线上反馈以新来源回流 intake/CHG，并保留人类问责。