AI-原生构建模板
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/zcmfopc--ainative-artifacts.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcmfopc/ainative-artifacts。AI-Native 开发流程的六阶段产物模板:intent、spec、plan、review、bands、incident。说一句「帮我写份 spec」,即可得到该阶段可直接提交评审的完整文档,附提交前自检清单与未填占位符清单——缺什么一目了然,不用再猜格式。六个阶段首尾相接,每阶段产物即下一阶段输入,整条提交流水天然可审计。
按次 ¥1.8,支付完成即交付;同一订单重复取用不重复扣费。
阅读全文 (展开查看完整说明)
概述
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)。
- 一次只对一个阶段计费生成;跨阶段需分别调用。