中医节气养生

解决什么问题

传统节气养生内容大多散落在科普文章、养生栏目和口口相传的经验里，开发者想做一个“今天是什么时候、该吃什么、怎么起居”的查询能力时，很快会遇到三类问题：节气交节时刻靠常识或农历书不够精确；同一节气下的建议往往泛泛而谈，缺少食材、做法和注意事项的结构化输出；当这类指南放在 Agent 或工作流里调用时，接入付费、返回状态和异常路径也比较繁琐。中医节气养生 的目标是把这些能力封装成一个可调用的指南生成服务，输入日期就能拿到顺时养生的骨架与细节。

核心能力与工作方式

技能以日期为输入，默认当天，并基于天文历法推算节气时刻，输出当前节气、精确交节时间、农历日期、物候、下一节气倒计时，以及当季食材清单、起居作息、情志、运动建议和具体食谱做法。如果调用方传入 constitution，结果会结合用户自述体质或近期状况生成更有针对性的建议。

调用流程围绕 X402 协议展开。首次请求后若服务返回 HTTP 402，WeixinPay-Required header 中的 preview 会给出该日期真实的节气定位，包括节气名、交节时刻、物候、下一节气倒计时和食材预告，用于先向用户展示真实数据，再说明支付后可解锁的完整内容。支付成功后，Agent 必须用相同的请求 body 和商户订单号 X-Out-Trade-No 重新调用技能 API，并间隔轮询任务结果；result 中包含 current_jieqi、next_jieqi、wuhou、knowledge 和 advice 等字段。

异常状态也需要显式处理：NOT_PAID 应提示支付未完成且不要重试；REFUNDED 要告知服务异常并已自动退款；FULFILL_AND_REFUND_FAILED 需要引导用户联系客服。展示结果时，建议按节气总览、倒计时、时令饮食、起居养生、AI 建议的顺序组织，并原样展示免责声明。

适用边界

这个技能适合做传统文化视角下的日常参考和 Agent 内的顺时生活指南，不做疾病诊断、治疗方案或精准药膳食疗处方。输入日期无效时应返回并转达 400 信息；同一输入在 10 分钟内重复请求会复用同一订单，属预期行为。结果中若出现交节当天，应优先提示当天节气变化。