Xpersona
agentCLAWHUBUnverified

AI Delivery Spec｜需求判断与交付

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、原型、变 Skill: AI Delivery Spec｜需求判断与交付 Owner: franklinxkk Summary: 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、原型、变 Tags: latest:5.5.2 Version history: v5.5.2 | 2026-09-29T23:

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

2.9k

Updated

Oct 9, 2026

Version

5.5.2

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 2.9K downloads reported by the source. Last updated 10/9/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
2.9K downloadsadoption · observed Oct 9, 2026
Latest release
5.5.2release · observed Sep 29, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s1788610zxyr699qednfs41d7n88xqj6:ai-delivery-spec
  1. Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-franklinxkk-ai-delivery-spec/snapshot"

Documentation

CLAWHUB

160,000 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
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.2 — 需求判断与交付

帮助用户管清需求，让产研和 AI 少猜、少漏、少返工。跟随用户语言；代码、字段和已有稳定 ID 保留原名。

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

## 从当前目标进入

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

明确局部小改：读取相关基线，完成差异、继承边界和正反验收；没有关键未知就不提问、不建生命周期文件。不默认走全流程。

按依赖推进：澄清当前决定 → 写清业务切片或走通原型 → 按需补追溯 → 验证。已有答案直接进入所需阶段。每阶段先解决业务分歧；编号、模板和门禁不能挤占业务内容。标题用业务名称，ID 留在引用位置。

办公任务的目标取舍、口径、权限或流程改变同样适用；澄清后交对应工具执行。纯格式整理或既定步骤执行无需制造需求问题。

| 当前需要 | 按需读取 |
|---|---|
| 判断问题、比较方案、澄清 | [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#领域检索) 取当前问题切片和来源基线，再核实有权原文及版本；中英文同样执行。语言不决定法域，来源须匹配辖区与适用对象，不能照抄成项目真相。

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

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

## 最小充分规格

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

事实只在一处人工定义，模块内就近引用或展开，使接收者连续读懂任务。业务审批和需求评审是不同对象；审核通过仅为发布前提时，不擅自合并成自动发布。

关键规则用能区分错误实现的反例验证；标签缺失不能掩盖风险，模型一致不能代替来源。小改不附加全角色报告。

正文 GAP 是待核实分歧，未命中也不证明通过。回读规则与来源，检查条件、反向路径和下游；不能为消除 GAP 编造政策、来源或 pass。

## 变更与完成

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

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

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

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

examples/minimal-v5/README.md

# 最小需求示例

这个虚构示例说明如何为制度列表增加“仅看当前有效”筛选。现有权限、时间边界、正常/空/失败结果与验收仍需说清，但不需要完整生命周期。

```powershell
python scripts/ai_delivery_spec_cli.py triage --input examples/minimal-v5/intake.yaml --format json
python scripts/ai_delivery_spec_cli.py gate --profile prd --prd examples/minimal-v5/requirement-card.md --stage specify
```

预期为 card 路由建议及静态 PASS。建议不改变需求状态；PASS 不能证明自然语言风险发现完整、浏览器交互、真实系统或客户验收。

示例保留一份可读取的旧式卡片，演示 5.4.x 内容兼容。新任务可用更短的模板或直接答复；状态、集成、指标等复杂点只补相关语义，不自动升级长 PRD。

README.md

# AI Delivery Spec 5.5.2

**帮你管清需求，让产研和 AI 少猜、少漏、少返工。**<br>
**Manage requirements with less guesswork, fewer omissions and less rework—for your team and AI.**

面向**产研团队与 AI Agent**的需求管理内核，以 Skill 形式使用。从一句话、现有材料或变更进入，帮你定清该做什么、交代清楚业务规则、找出改动影响。按当前任务生成或维护需求卡、PRD、可操作原型与验收条件，让接手者知道依据什么做、哪些还没定。

A requirements management core for **product teams and AI agents**, delivered as a skill. Start with an idea, existing material or a change. Decide what needs doing, make business rules clear and identify change impacts. Create or update only the requirement cards, PRDs, interactive prototypes and acceptance criteria the task needs, so whoever takes over knows what to work from and what remains undecided.

[![ClawHub downloads: 2.6k](https://img.shields.io/badge/ClawHub-2.6k_downloads-2563eb)](https://clawhub.ai/franklinxkk/skills/ai-delivery-spec)
[![SkillHub AI score: 4.7/5](https://img.shields.io/badge/SkillHub_AI-4.7%2F5-f59e0b)](https://skillhub.cn/skills/user_12c92261/ai-delivery-spec)
[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-64748b)](LICENSE)

<sub>2026-09-13 社区快照：ClawHub 约 2.6k 次下载；SkillHub 4.7/5 为 v5.4.8 历史 AI 评分，非当前版本新评测。 / Community snapshot: approximately 2.6k ClawHub downloads; SkillHub's 4.7/5 is a historical AI rating of v5.4.8, not a new evaluation of this release.</sub>

**[角色价值 / Role value](#roles) · [中文上手](#zh) · [English guide](#en) · [四个快捷入口 / Shortcuts](#shortcuts) · [安装 / Install](#install) · [示例 / Examples](#examples) · [中英社区 / Community](#community)**

<a id="roles"></a>

## 各产研角色能得到什么

| 核心用户 | 经常遇到的问题 | 这次能拿走什么 |
|---|---|---|
| **初级产品经理** | 收到一句需求，不知道该问什么、写到多细 | 关键问题、范围与边界、能开始评审的需求卡或 PRD |
| **中高级产品 / 产品负责人** | 需求都合理，但优先做什么、跨模块如何一致还没定 | 问题证据、方案取舍、最小验证、当前决定与变更影响 |
| **业务 / 售前 / 实施 / 设计** | 客户说法、业务规则和页面体验之间有断层 | 可确认的业务行为、可操作的产品原型、待决定事项 |
| **前端研发** | 页面有了，入口、状态、权限和失败反馈仍不明确 | 与规格一致的交互路径、状态结果与验收条件 |
| **后端 / 架构** | 同一句话会推导出不同口径、状态或写入方式 | 数据权威、允许的状态变化、副作用、恢复与集成边界 |
| **QA / 验收方** | “显示正确”无法变成可重复的验收 | 正反例、权限与边界场景、变更回归范围和证据缺口 |
| **Coding Agent** | 换个会话就丢背景，或自行补出业务政策 | 当前有效规则、来源与稳定引用、未知及可接续的任务范围 |

适用于 ToC 产品、ToB/ToG 业务系统及 AI Native 场景。这些角色共用同一份业务约定，各自按需要读取；已有 PRD、需求系统和批准基线可以继续作为权威位置。

## 从决定到交付，重点做好三件事

**1. 更快找到当前要决定什么。** 从目标、受影响的人和事实出发，比较方案与最小验证。有依据的“先验证、暂缓、缩范围或不做”也可以完成分析；改变需求状态仍取决于实际授权。

**2. 让规格可以体验，让评审有具体落点。** PRD 说明业务规则，原型呈现操作与结果，验收条件判断是否符合约定。“审批通过后可发布”要在规则、按钮行为与验收中区分发布资格和发布动作。需要双态评审时，可以边操作产品，边在当前页面旁查看规则、边界与验收依据。只补影响关键业务选择的内容，保留合理的工程实现空间。

**3. 变更之后，相关产物仍然说同一件事。** 沿写入者、读取者、入口、指标和旧对象找具体依赖；区分候选影响与已核实影响，让 PRD、原型和交接引用同一规则。

清晰小改直接完成；复杂需求按问题深入。工作量跟随当前目标，不要求先选 L0–L4、跑完整生命周期或填完全部模板。产品态原型默认可操作；需要面向产研的双态评审时，再开启评审标记与工作区。

**先把业务讲清、操作走通，再补必要的追溯。** PRD 标题用业务名称，编号放在引用位置；快速原型不先搭全套评审设施。已定规则、待决影响和研发可自行选择的实现分别说清，避免把“有待决记录”误当成“已经可以开发”。<br>
**Explain the business and make the task work before adding traceability.** Use business titles, keep IDs in references, and distinguish settled behavior, unresolved dependencies and engineering choices. A recorded question is not implementation readiness.

<a id="install"></a>

## 安装到

_meta.json

{
  "ownerId": "kn7789n9h3n4chvd2jehwxy2jh88w52h",
  "slug": "ai-delivery-spec",
  "version": "5.5.2",
  "publishedAt": 1790726245062
}

references/change-acceptance.md

# 变更、交接反馈与验收

## 从一个有效决定开始

记录来源、授权、基线、前后变化与影响种子；继承已有决定。写入前核对版本，按主题合并并发变化，不以最后写入者胜出。

一条规则只改一个权威定义。页面、流程、原型说明、AC 与交接引用同步。显示序号变化不等于业务身份变化；需要替换身份时保存旧 ID 与替代关系，不改写历史。

## 找消费者并保留依据

从规则找到写入者、读取者、指标、操作入口、事件/通知、旧数据、进行中流程、验收与接收者。每项说明依赖链；区分直接、传递、仅回归和有理由的无影响。

推测消费者记为候选，核实后更新同项及依据，排除保留理由。核实依赖不代表批准修改；高影响候选未核实就限制相应完成声明。

`impact` 仅沿已登记关系找候选，暴露缺种子、未解析关系和深度截断；命令见 [工具](stages.md)，输入见 [变更模板](templates/change-request-template.yaml)。复杂审计才用 change-package Schema；小改写在当前产物。

已有对象如何处理须依授权决定；不能默认全部迁移或沿用。记录哪些证据仍适用、哪些失效以及谁接收新版本。工程反馈回链为规格缺陷、实现缺陷、来源失效或新增范围，不把它们混成同一种返工。

## 证据按主张、范围、版本成立

| 证据 | 能证明 | 不能替代 |
|---|---|---|
| 静态检查 | 指定声明、引用、结构及可确定约束 | 自然语言业务真值和实际行为 |
| 语义评阅 | 指定对象的来源核对、反例及处置 | 运行验证；两模型一致也不是真值 |
| 浏览器原型 | 指定环境的操作、可见/Mock结果 | 真实接口、持久、并发与生产权限 |
| 真实系统 | 指定版本环境中的实际对象与结果 | 客户批准规则或验收签署 |
| 业务/客户确认 | 有权人在对应范围作出的决定或接受 | 实现已完成、范围外能力或上线 |

关键主张绑定范围、版本、证据类型、环境/责任人、结果与位置。验证后修改重验受影响范围；未执行、缺来源、不适用分开。

断言数、唯一 AC 数和已验证行为分开；编号注释不算覆盖。按同一输入核对来源→PRD→原型实际操作→实现结果，检查对象/字段含义、状态、权限、口径、拒绝和副作用，允许有明确映射的不同命名。AC 前提须能独立造数或重置；删除对象使旧 AC 失效。声明可配置的规则，用改值前后样本验证各消费者响应及生效时点，不把所有阈值升级成配置平台。

复用 ARUN/EVD；真实验收保留 acceptance_ref、requirement_refs、result、actual_result、evidence_refs，见 [验收模板](templates/acceptance-run-template.yaml)。本地证据可解析且不越出记录目录；远程链接或字符串不证明执行。

## 关闭

实际验证覆盖指定主路径及高价值拒绝/恢复；验收接受需相应有权签署。残留问题明确范围、责任及复议条件；有条件批准到期重新处理，不用条件措辞掩盖未完成的关键规则。

需求通过验收不等于已经发布。外部上线、运营和结果反馈只记录引用，必要时作为新来源或 CHG 返回；不由需求状态自动驱动生产操作。

Related agents

Same protocol, similar job.

Github ReposUpdated 5h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/franklinxkk/skills/ai-delivery-spec",
      "sourceUrl": "https://clawhub.ai/franklinxkk/skills/ai-delivery-spec",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:56:40.890Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-franklinxkk-ai-delivery-spec/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-franklinxkk-ai-delivery-spec/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:56:40.890Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "2.9K downloads",
      "href": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceUrl": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T10:56:40.890Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "5.5.2",
      "href": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceUrl": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-29T23:57:25.062Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-franklinxkk-ai-delivery-spec/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-franklinxkk-ai-delivery-spec/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 5.5.2",
      "description": "- Major cleanup: reduced file count significantly by removing legacy, maintainer, and workflow files. - Added runtime-manifest.json and build_review_workspace.py script to support review workspace operations. - Updated and streamlined example requirements documentation for medium-review-handoff. - Improved documentation focusing on clarity, minimal duplication, and directly actionable requirements for all roles. - Specification emphasizes direct business intent, reduces procedural overhead, and clarifies boundaries for requirement management.",
      "href": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceUrl": "https://clawhub.ai/franklinxkk/ai-delivery-spec",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-09-29T23:57:25.062Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to AI Delivery Spec｜需求判断与交付 and adjacent AI workflows.