agentsclimarketplace

Ai delivery spec

Skill franklinxkk/ai-delivery-spec

Requirement management Skill for one human-readable, AI-coding-ready baseline: intake, clarification, PRD/prototype contracts, change, traceability, and acceptance for ToC/ToB/ToG.

Install
npx -y skills add franklinxkk/ai-delivery-spec

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

将一句话想法、客户材料、存量系统或 ToC/ToB/ToG 需求，按使用者指定的进入阶段和停止阶段，转化为可评审、可实施、可追溯、可验收的人类与 Coding Agent 共用需求产物。支持问题定义、方案探索、需求准入、澄清、统一 PRD、工程原型、评审基线、变更影响和验收证据；不负责排期、编码、CI/CD、部署和运营。

SKILL.md

7.0 KB, as published. Nobody here has run it

AI Delivery Spec 5.4.0 — Requirement Lifecycle Workstations｜需求全生命周期工作站

本 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 仅在法规、安全或行业物理约束会改变选项时加载领域知识。

默认最小产物，不为阶段机械建文件

  • frame：一份 problem-brief.md，说清用户、痛点时刻、成功信号、事实/假设和下一步。
  • explore：一份 solution-sketch.md，至少两个选项和不做选项，包含可证伪 ASM-*、最小验证与停止条件。
  • intake：复用 triage 结果与 requirement register；Start with intake for formal governed requirements。
  • clarify：一份 requirement-brief.md，内嵌 DEC-*、规则、开放 UNK-* 和退路；多决策人/审计才拆侧车。
  • specify：一份需求卡或 one human-readable 统一 PRD；Product Truth 只在受控多投影、反复跨模块变更、血缘或强审计时按需启用。
  • review/baseline：复用同一规格；required_review_types 全部结构化签署后绑定权威来源、版本/hash 和消费方。
  • change/acceptance：现有 CHG-* 与 ARUN-* 回链当前基线。

假设寄存器仅在跨会话、跨角色复用或治理时单独导出。YAML/JSON 是工具投影，不是另一份 PRD。

需求闭环与禁止推断

  1. 先检查用户材料、现有产物、权威层级和适用领域；存量 HTML/系统重写前先执行 Stage 0。
  2. 事实问题按依赖成批澄清；方向、冲突和路线逐项给出推荐、依据与取舍。无法取得的事实登记 UNK-*，包含责任人、范围、blocks_stage 和回退路径。
  3. ASM-* 是待验证解释；UNK-* 是缺失事实/决策。两者不得互换。P0 未知项只阻断受影响且已到达的阶段。
  4. 规格按模块纵切闭环：目标 → 角色旅程 → 页面/数据 → 规则/状态 → 指标口径 → 异常恢复 → 验收；横切权限、接口、事件、审计、兼容和 NFR 作为同一基线合同。
  5. 每个 REQ-* 绑定来源、行为、字段/规则、AC、测试与证据，并支持 both directions 追溯；缺少语义时开发与 Agent 必须回报 GAP，不能发明。
  6. 评审后才基线；变更必须登记 diff、影响、审批、同步、回归和版本；验收记录执行结果、证据、缺陷、条件和签署。

门禁只做轻量守门员

统一状态只有 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，不能把结构通过宣传为领域正确、真实运行或客户签收。

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，并保留人类问责。

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.