AI 智能体技能包与 llms.txt

安装

手动安装（版本 2.1.7），共三条命令：

curl -sO https://api.astrum.shop/v1/skill/astrum-partner-api-2.1.7.zip
curl -s https://api.astrum.shop/v1/skill/astrum-partner-api-2.1.7.zip.sha256 | shasum -a 256 -c -
unzip -q astrum-partner-api-*.zip -d .claude/skills/

来自同一主机的 sha256 只能验证压缩包的完整性，不能证明其真实性：压缩包和校验和来自同一台服务器。…-latest.zip 始终是最新版本；已下架的版本会返回 410，并附最新版本的链接。

AGENTS.md 说明段落

可放入您项目 AGENTS.md 或 CLAUDE.md 的一段说明：

与 Astrum Shop 的集成请按照技能包 astrum-partner-api 进行。先用沙盒：密钥
ask_test_… 只能从环境变量 ASTRUM_KEY 读取，Webhook 签名密钥从 ASTRUM_WEBHOOK_SECRET 读取。
正式环境密钥不得出现在代码、聊天和日志中。当 astrum_check.py webhook 和
astrum_check.py sandbox 全部为 ok 时，即视为完成。

交给智能体的任务

交给智能体的任务：「把 Astrum 的订阅下单接入我们基于 FastAPI 的商店」「在 Express 服务中添加 Astrum Webhook 接收端」「查明为什么我们的接收端会拒绝已签名的 Astrum Webhook」。

自检

astrum_check.py 报告 — 每项检查一行：ok 或带原因的 FAIL，最后给出汇总；退出码为 0 表示全部 ok。webhook <地址> 会向您的接收端发送已签名的测试事件：签名正确以及同一 id 的重复投递应返回 2xx；请求体被篡改、时间过旧、缺少签名、请求头格式错误应返回 4xx 而不是 5xx；响应时间超过 5 秒即为失败。sandbox 会在沙盒中走一遍真实流程：/account、测试 USDT、订单、客户信息、开通、当日订单和余额流水。如果使用正式环境密钥 ask_live_…、签名密钥 whsec_live_… 或指向其他环境的 Base URL，检查会在发出第一个请求之前停止。

不使用技能包

不使用技能包：面向智能体的目录见 https://api.astrum.shop/llms.txt，指南和接口契约的单文件版本见 https://api.astrum.shop/llms-full.txt。