AI-Native 产物模板
AI-Native SDLC 的主轴是提交产物链：intent.md → spec.md → plan.md →（代码+测试）→ PR → incident.md → 回写 intent.md。每个阶段结束时提交一件产物，下一阶段从读取这件产物开始；这条 commit 链本身就是审计链。
本技能的六份产物模板只保存在服务端，所有产物正文都经付费接口返回 —— 这是 Pay Skill「源文件依赖后端服务，脱离后端无法独立使用」的判定依据。
30 秒速览
| 项 | 内容 |
|---|---|
| 能力 | 六阶段 committed-artifact：intent / spec / plan / review / bands / incident |
| 一次调用产出 | 该阶段完整产物正文 + Pre-commit 自检清单 + 未填占位符清单 |
| 单价 | ¥1.8 / 次（180 分），一次收取，套内件数不计费 |
| 支付协议 | 微信 Agent Pay X402（WeixinPay-Required / X-Out-Trade-No） |
| 能否离线使用 | 不能：模板与渲染均在服务端，必须联网调用付费接口 |
服务端返回什么
| 字段 | 含义 |
|---|---|
stage |
产物阶段 |
artifact |
渲染好的产物正文（Markdown / YAML） |
pre_commit_checklist |
该产物的提交前自检项，逐项勾完才算通过人工门禁 |
total_placeholders / filled |
模板占位符总数与已填数 |
remaining_placeholders |
未填项清单（编号 + 提示），补齐后可再次请求 |
complete |
占位符是否已全部落实 |
使用工作流
Step 1（免费）：确认阶段与素材
判断用户处于哪个阶段（intent / spec / plan / review / bands / incident），收集素材，并明确告知本次将调用付费服务 ¥1.8/次。
> 这一步不触碰计费：说明阶段、解释会产出什么、列出素材清单，全部免费。
Step 2（付费门控，必经）：请求资源并完成支付
前置检查：当前智能体是否支持微信 AI 支付
发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（工具名带前缀也算，如 mcp__weixinpay__weixinpay_register；存在任意一个即视为支持）。
只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。
- 支持：静默继续本 Skill 的后续流程，不向用户提及本检查。
- 不支持：终止流程且不要发起下单。只向用户说明结论与解决办法（无需解释你如何检查、不要出现具体工具名），按智能体类型提示：
- 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
- 开放智能体（如 OpenClaw / DeepSeek Harness）：请根据 <https://skillhub.cn/install/skillhub.md>，安装
@tencent-adm/weixinpay-installer。 - 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。
第一步：请求资源（首次不要携带 X-Out-Trade-No）
POST https://pay.zcmfopc.com/wxpay/api/skillhub/pay/ainative-artifacts
Content-Type: application/json
{
"stage": "intent",
"author": "张三 <zhangsan@example.com>",
"date": "2026-10-26",
"answers": ["让用户自助查看订单状态", "平台组 张三", "2026-10-26", "下单后看不到配送进度", "门户可看订单状态与预计时间"]
}
answers 按模板占位符出现顺序逐个对应（P1…Pn）；不确定的项直接跳过，服务端会把未填编号回传在 remaining_placeholders。
第二步：处理 402 支付响应
HTTP/1.1 402 Payment Required
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
必须同时记下两个值：WeixinPay-Required 作为 paymentCode 交给 weixinpay_pay；X-Out-Trade-No 作为支付成功后的重试凭证。
第三步：发起微信支付授权
调用 weixinpay_pay(paymentCode=<WeixinPay-Required>)，由用户在微信支付 AI 专属卡确认支付。支付未完成、取消或失败时停止交付，只返回可读的失败说明，不得进入第四步。
> 付费门控：未拿到服务端 200 响应前，Agent 不得自行拼装或离线生成近似内容交付。
Step 3（付费后必须执行）：取回产物
支付成功后，用完全相同的请求体重试，并携带订单号：
POST https://pay.zcmfopc.com/wxpay/api/skillhub/pay/ainative-artifacts
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>
（请求体与第一步逐字节相同）
服务端向微信查单，确认 trade_state=SUCCESS 后才返回产物。未确认支付时返回 PAYMENT_NOT_CONFIRMED，此时保留订单号重试原请求，不得重新下单。
Step 4：交付与下一步
把 artifact 落盘到建议路径，逐项过 pre_commit_checklist 并给出结论；remaining_placeholders 非空时列出缺口让用户补齐后再次调用（新一轮按次计费）。最后给出「下一步该做什么」，通常是下一阶段的门禁动作。
Pay Skill 服务接口
| 项 | 值 |
|---|---|
| 服务入口 | https://pay.zcmfopc.com/wxpay/api/skillhub/pay/ainative-artifacts |
| 健康检查 | GET https://pay.zcmfopc.com/wxpay/api/skillhub/pay/health → status=ok |
| Skill ID | ainative-artifacts |
| Skill Version | 1.1.0 |
| 计费模式 | 按次调用，¥1.8 / 次（180 分） |
| 支付协议 | 微信 Agent Pay X402 |
| 支付触发 Header | WeixinPay-Required |
| 订单重试 Header | X-Out-Trade-No |
| Platform Product ID | 见 frontmatter pricing.product_id |
微信支付 API 证书、SkillHub 开发者私钥与商户配置只保存在服务端，不进入 Skill ZIP、前端、日志或对话。
排障速查
| 现象 | 含义 | 处置 |
|---|---|---|
402 + WeixinPay-Required |
尚未支付 | 走第三步 weixinpay_pay，不要重复下单 |
402 + PAYMENT_NOT_CONFIRMED |
微信侧未确认收款 | 稍后携同一 X-Out-Trade-No 重试原请求 |
409 + ORDER_REQUEST_MISMATCH |
重试请求体与首次不一致 | 用完全相同的请求体重试，不要修改任何字段 |
404 + ORDER_NOT_FOUND |
订单不存在或已过期（15 分钟） | 重新走第一步创建订单 |
200 + REFUNDED |
履约不可恢复失败，已自动全额退款 | 说明已退款，修正入参后可重新调用 |
remaining_placeholders 非空 |
素材不足 | 列出缺口让用户补齐后再次付费生成 |
边界与限制
- 本技能不替用户做需求判断：占位符内容由用户提供，服务端只做模板渲染与占位符核算。
- 产物是「可直接提交的草案」，仍需过对应阶段的人工门禁（G1–G6）。
- 一次只对一个阶段计费生成；跨阶段需分别调用。
