谦懋智享·每日好书推荐+读书笔记

概述

配置项（使用前先填）

• {{WORKSPACE}}：工作目录（读书笔记落盘处，如 /workspace 或你的笔记库）
• {{BOOK_NOTES_DIR}}：读书笔记子目录（如 book_notes）
• {{DOMAINS}}：选书领域池（个人成长/商业思维/心理学/科技趋势/历史/文学经典等）
• {{RECOMMEND_STARS}}：推荐指数星级标记方式（如 ★）

任务

完成今日「每日好书推荐与读书笔记」任务，按以下结构化流程产出内容并保存为文件。

步骤

1. 选书：从 {{DOMAINS}} 中挑一本值得推荐的好书。先检查 {{WORKSPACE}} 目录下已有的读书笔记文件，避免与历史推荐重复；若条件允许，可在不同领域间轮换。
2. 书籍信息：书名、作者、出版信息、所属领域、推荐指数（{{RECOMMEND_STARS}}）。
3. 内容脉络（书籍笔记）：用 4-6 段梳理全书核心框架与主要观点，逻辑清晰、有层次。
4. 知识点与重点提炼：列出 5-8 个可迁移的核心知识点/方法论，每条附简短说明。
5. 金句摘录：3-5 条书中或与之高度相关的金句。
6. 学习提升建议：这本书能帮你提升哪方面能力，给出 2-3 条可落地的行动建议。
7. 输出与保存：整理为 Markdown，保存到 {{WORKSPACE}}/{{BOOK_NOTES_DIR}}/每日好书_YYYYMMDD.md（目录不存在则创建），并在回复中给出标题+一句话推荐语，方便用户快速浏览。

品牌与计费

前置检查：当前智能体是否支持微信 AI 支付

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（如 mcp__weixinpay__weixinpay_register，工具名带前缀也算；存在任意一个即视为支持）。只以你的工具列表为证据，本文档中提到的工具名不算；无法确认时按「不支持」处理。

• 支持：静默继续本 Skill 的后续流程，不向用户提及本检查。
• 不支持：终止流程且不要发起下单。只向用户说明结论与解决办法（无需解释你如何检查、

不要出现具体工具名），按智能体类型提示：

• 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
• 开放智能体（如 OpenClaw / DeepSeek Harness）：请根据

https://skillhub.cn/install/skillhub.md安装 @tencent-adm/weixinpay-installer。

• 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。

部署与密钥自检见 scripts/pay_server.py 头部注释。

付费调用流程（四步，缺一不可）

本 Skill 的支付服务已接入微信支付 Agent Pay X402（真实下单 + 预下单）。支付能力由「谦懋智享支付网关」提供，需先部署并通过 https://qmzx-pay-gateway.app.workbuddy.host?sharecode=XCPQGFHML7 访问（部署与密钥配置见 scripts/pay_server.py 头部注释）。

1. 请求资源（触发下单）：向网关发起首调（不带订单号）。网关完成微信 Native 下单 + X402 预下单后返回 HTTP 402：

POST https://qmzx-pay-gateway.app.workbuddy.host/preorder?sharecode=XCPQGFHML7，请求体 {"skill_id":"daily-book-notes","skill_version":"1.0.0","description":"daily-book-notes 单次调用"}响应头与响应体同时携带 WeixinPay-Required（支付码）与 X-Out-Trade-No（订单号），两者都必须保存。

1. 处理 402：从响应中提取 WeixinPay-Required 与 X-Out-Trade-No。
2. 发起支付：把 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay。
3. 支付成功后获取资源（⚠️ 必须执行）：带订单号重试原请求（网关路径 /verify，Header X-Out-Trade-No 填第二步保存的订单号）：

POST https://qmzx-pay-gateway.app.workbuddy.host/verify?sharecode=XCPQGFHML7，Header X-Out-Trade-No: <第二步保存的订单号>网关查单验证通过后返回 code: SUCCESS 与 deliver: true，此时再继续执行本 Skill 的业务流程交付付费内容。

⚠️ 第四步最容易被遗漏：不携带 X-Out-Trade-No 重试，就永远拿不到付费内容。

重试与异常处理

• 网关侧下单 / 预下单 / 查单内置指数退避重试（默认 3 次，SKILLPAY_MAX_RETRY 可调）；

4xx 业务错误立即失败不重试。

• 支付失败或状态不明：先用 POST https://qmzx-pay-gateway.app.workbuddy.host/verify?sharecode=XCPQGFHML7（带订单号）查单，

不重复下单，避免重复扣费。

• 幂等：同一 out_trade_no 只履约一次，重复请求返回 already_fulfilled: true 与缓存结果。
• 网关部署、微信商户证书与 SkillHub 开发者密钥配置说明见 scripts/pay_server.py 头部注释与

references/payskill-integration.md。

完整接入规范

见 references/payskill-integration.md：两套密钥的区别、X402 签名串（5 行含尾随换行）、订单号 ≤32 位约束、402 响应结构、改造自检清单。