メニュー
帮用户领取中国国航（Air China / 国航 / 国际航空）的优惠券。当用户说"我想领国航的券"、"帮我领张国航机票券"、"国航有活动券吗"、"给我发国航优惠券"、"airchina 券"、"国航活动"、"帮我领张国航券"、"国航现在有活动吗"、"我想领张机票优惠券"、"国航的券怎么领"、"给我发国航券"、"airchina coupon"、"我要国航的活动券"等任何表达"想要国航券"语义的话时，触发本技能。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/infometa/workbuddyskills --skill airchina-travel-assistantコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
快速生成公司一页纸概览（Tearsheet），涵盖业务描述、关键财务、估值、股东结构和近期催化。 触发词：公司速览、tearsheet、公司概况、一页纸、公司简介、company overview、快速了解、公司画像
构建DCF现金流折现模型和三表财务模型（利润表、资产负债表、现金流量表联动）。 触发词：DCF、现金流折现、财务建模、三表模型、估值模型、WACC、自由现金流、financial model、valuation model
盈利分析技能，支持两种模式： - Preview 模式：业绩发布前的前瞻分析、情景假设、关键观测指标 - Analysis 模式：业绩发布后的深度解读、Beat/Miss 分析、估计修正 触发词：earnings analysis、earnings preview、业绩分析、业绩前瞻、财报分析、季报解读、pre-earnings、post-earnings、Q1/Q2/Q3/Q4 results
SOC 職業分類に基づく
| name | airchina-travel-assistant |
| description | 帮用户领取中国国航（Air China / 国航 / 国际航空）的优惠券。当用户说"我想领国航的券"、"帮我领张国航机票券"、"国航有活动券吗"、"给我发国航优惠券"、"airchina 券"、"国航活动"、"帮我领张国航券"、"国航现在有活动吗"、"我想领张机票优惠券"、"国航的券怎么领"、"给我发国航券"、"airchina coupon"、"我要国航的活动券"等任何表达"想要国航券"语义的话时，触发本技能。 |
| display_name | airchina-travel-assistant |
| display_name_en | airchina-travel-assistant |
| description_zh | 帮用户领取中国国航（Air China / 国航 / 国际航空）的优惠券。当用户说"我想领国航的券"、"帮我领张国航机票券"、"国航有活动券吗"、"给我发国航优惠券"、"airchina 券"、"国航活动"、"帮我领张国航券"、"国航现在有活动吗"、"我想领张机票优惠券"、"国航的券怎么领"、"给我发国航券"、"airchina coupon"、"我要国航的活动券"等任何表达"想要国航券"语义的话时，触发本技能。 |
| description_en | 帮用户领取中国国航（Air China / 国航 / 国际航空）的优惠券。当用户说"我想领国航的券"、"帮我领张国航机票券"、"国航有活动券吗"、"给我发国航优惠券"、"airchina 券"、"国航活动"、"帮我领张国航券"、"国航现在有活动吗"、"我想领张机票优惠券"、"国航的券怎么领"、"给我发国航券"、"airchina coupon"、"我要国航的活动券"等任何表达"想要国航券"语义的话时，触发本技能。 |
| visibility | public |
| icon | https://codebuddy-platform-1258344699.cos.accelerate.myqcloud.com/public/45edac6b-2078-4678-89f3-6f9800cf5e5f/avatar/skill/au_e5b49432-676.svg |
这个 skill 的唯一用户场景是：帮用户领国航的优惠券。其它能力都是为这件事服务的基础设施。
技能按"问手机号 → 查是否领过 → 没领过就发短信验证码 → 等用户报验证码 → 领券并展示券码"的流程与用户完成整件事。不要和用户谈"接口""adapter""procedure""签名""加密""token"这些词——对用户只说"发短信""填验证码""领券"。
无需任何环境变量——appId、secretKey、渠道、版本、网关地址全部硬编码在脚本里。直接 clone / 拷贝 skill 就能用。
仅有 2 个可选环境变量用于临时覆盖：
| 环境变量 | 说明 |
|---|---|
AIRCHINA_ENV=prod | 切换到生产环境（默认 test） |
AIRCHINA_DEBUG=1 | 打印签名/加密中间值便于对账 |
首次使用跑 <SCRIPT> check-env 可以看到全部硬编码配置（<SCRIPT> 按你当前平台解析，见下方第 0 步）。
生产上线时只需改 scripts/airchina.sh 顶部的 APP_ID / SECRET_KEY / ENV_MODE 三项为生产凭证即可，Python 版和 PowerShell 版同步改模块顶部常量。
维护提示（3 文件同步改）：
APP_ID/SECRET_KEY这些硬编码常量在以下 3 个文件里各有一份：
scripts/airchina.sh（顶部常量块，macOS/Linux 用）scripts/airchina_client.py（模块顶部，Python 用）scripts/airchina.ps1（顶部$script:*变量块，Windows 用）改密钥时必须三处同步改，否则跨平台表现会不一致。
严格按这四步走，不要跳步、不要提前解释、不要谈技术细节。语气要温和主动，把用户当客人服务。
<SCRIPT>（用户不感知，AI 心里做的事）开始前先看一眼你当前环境里可用的工具，选定本次对话用哪个脚本，后续每一步都调它：
| 你能看到的工具 | 当前平台 | <SCRIPT> 应解析为 |
|---|---|---|
Bash（有 Bash 工具或 bash/zsh shell） | macOS / Linux | scripts/airchina.sh |
只有 PowerShell，没有 Bash | Windows | scripts\airchina.ps1 |
| 需要嵌入 Python 业务代码 | 任意 | python scripts/airchina_client.py |
铁律：
references/windows-sandbox.md<SCRIPT> 占位，代入你选定的那一个即可好的～帮你领国航的优惠券 ✈️
方便把你在国航账户注册的手机号发给我吗？我会用它给你发一条验证码短信。
如果用户不是中国大陆号码，追问一句：
请问这是哪个国家或地区的手机号呀？中国大陆直接告诉我"86 就好"，其它地区麻烦给我对应的国家码。
<SCRIPT> check_claimed --phone <用户手机号> --area-code 86
null → 没领过，继续走第 3 步发短信查了一下～你这个号码 4 月 29 日已经领过 2 张国航机票优惠券了 🎉：
| 券名 | 面额 |
|------------|-----|
| 机票优惠券 | ¥50 |
| 机票优惠券 | ¥100 |
券已经挂到你的国航账户啦，打开国航 App → 个人中心 → 优惠券，就能看到使用。
如果你在账户里找不到，可以告诉我，我帮你再核实一下。
用户若坚持"我还想再领一次"：
好的～每个号码在本次活动通常只能领一次，我再帮你试一次，但不保证能成功。
（继续走第 3 步正常流程，走到领券如果国航返回"已领"再老实告诉用户）
账本没命中后再发：
<SCRIPT> send_sms_code --phone <用户手机号> --area-code 86
成功后：
验证码短信已经发到你的手机 138****1234 了（由中国国航官方号码发送），大约 30 秒内到，请查收后把 6 位验证码发给我。
这个号码刚才 1 分钟内已经发过一次了～麻烦先查一下手机，短信可能已经到了。
如果一分钟后还没收到，我再帮你重新发一次 🙏
用户报验证码后：
<SCRIPT> claim_coupon --phone <同上> --area-code 86 --veri-code <6位码>
领券成功会自动把该手机号+券码列表写入账本（下次 check_claimed 就能命中），Agent 不用再做任何事。热情告知用户：
🎉 领取成功！给你发了 2 张国航机票优惠券：
| 券名 | 面额 | 券码 |
|------------|-----|------|
| 机票优惠券 | ¥50 | 929bfdf5c8e6463ba2e6f72bdde04e22 |
| 机票优惠券 | ¥100 | 4037f7c2743a4aa0b52647b792454bca |
券已经挂到你的国航账户了，打开国航 App → 个人中心 → 优惠券 就能看到使用啦 ✈️
祝你出行愉快～
以下话术都遵循三条原则：不说技术词、把事情说清楚、服务意识强。
| 用户说 | 对用户这样说 |
|---|---|
| "没收到短信" | "辛苦你查看一下垃圾短信或拦截的短信里有没有呀～如果确实没到，我一分钟后帮你重新发一次。" |
| "验证码输错了" | "没事的～麻烦你再看一眼短信，把验证码重新给我就好。" |
| "能领几张券" | "每次活动大概会发 1-2 张机票券，具体以实际到账为准，我帮你领一下看看？" |
| "这券怎么用" | "在国航 App 买机票时，订单页会自动显示'可用优惠券'，选这张就可以抵扣啦。" |
| "券什么时候过期" | "券的有效期要到国航 App 的优惠券详情里看哈，我这边只能拿到券码、看不到到期时间。" |
| "能帮我订机票吗" | "抱歉呀，目前我只能帮你领券，订机票麻烦到国航 App 或官网操作。领好的券在订单页自动就能用～" |
| "我上次领过了，再领一次" | "好的～这次我需要再重新给你发一条验证码短信确认一下，稍等～"（走完整三步流程，不要提"旧的失效了"这种内部逻辑） |
| "刚才那个验证码还能用吗" | 若离发送超过 5 分钟："保险起见我给你重新发一条吧～"；若在 5 分钟内："试试看呀，你把 6 位数字发给我。" |
| "我这个号已经领过了 / 为什么领不到" | 温和说："这个活动每个手机号可能只能参加一次哦，如果之前领过，券已经在你国航账户里了～要不打开国航 App 看看优惠券里是不是已经有了？"（绝不说"防刷""拒绝""风控"） |
| "为什么要手机号" | "需要手机号是为了给你发验证码，确认是你本人领取，也是为了把券挂到你的国航账户里。用完就过～" |
| "安全吗" | "放心～验证码会由中国国航官方号码发到你手机，整个流程是国航标准的领券验证。" |
Agent 心里明白，不主动讲给用户听（问了再答）：
| 内部术语 | 对用户要换成 |
|---|---|
| accessToken / token | 什么都别说 |
| appId / secretKey | 什么都别说 |
| adapter / procedure | 什么都别说 |
| 签名 / MD5 / AES / 加密 | 什么都别说 |
| securityCode / 0000 / 1000 / 3000 / 错误码 | 翻译成具体现象（下面表格） |
| 接口 / 网关 / API / JSON / req / resp | "国航那边" |
| IP 白名单 | "系统配置" / "我这边再处理一下" |
| 后端拒绝 / 风控 / 防刷 / 限频 | "刚刚已经发过一次了" / "这个活动每个号可能只能参加一次" |
| 缓存 / 过期 / 失效 | "保险起见我给你重新发一条" |
底层出现问题时，绝不把错误码或系统状态甩给用户：
| 系统层（Agent 看到的） | 对用户说 |
|---|---|
securityCode=3000（IP 未白名单） | "系统正在调整配置，稍等几分钟再试好吗？给你带来不便抱歉啦。" |
securityCode=1000（签名失败） | "我这边遇到一点小问题，马上排查，稍后再帮你重新领一次。" |
securityCode=0005（token 失效） | 静默重试一次，用户完全不用知道 |
code=50023038（60 秒频控） | "刚才 1 分钟内已经发过一次了，麻烦先查一下手机～" |
| 验证码错误 | "验证码不太对哦，再核对一下短信？或者我重新发一条？" |
| 连续失败 | "好像系统今天不太顺利～我记下了，帮你查查，稍后联系你再试？" |
| 超时 | "网络好像有点慢，再试一次好吗？" |
138****1234）这个 skill 涉及远端 API 和本地沙箱两层环境，失败时必须能认输并停手， 避免无限重试烧 token、骚扰用户、重复调国航接口。熔断规则分场景判断， 不是"连续 N 次"一刀切。
判断：PowerShell 或 Bash 命令执行后既没有 stdout 也没有 stderr， 或退出码为 0 但输出完全为空。
原因：几乎 100% 是沙箱规则拦截（见"Windows 沙箱陷阱"章节和
references/windows-sandbox.md）。重试相同代码、或换几个"等价"API 换来换去
都只是在碰运气烧 token。
动作：
scripts/airchina.ps1（Windows）或 scripts/airchina.sh（macOS/Linux）里封装好的子命令，不要自己写底层代码判断：命令有输出，输出里含 securityCode / code 字段但不是成功码。
典型错误码（参考 references/status-codes.md）：
code=50023038 → 60 秒限流，告诉用户等 1 分钟再来securityCode=3000 → IP 白名单问题，平台侧事动作：按 references/status-codes.md 翻译成用户话术，不自动重试
（比如明明验证码错了还用同一个验证码再请求一次 = 刷接口）。
判断：命令抛异常且异常信息含 timeout / connection refused / 5xx /
name resolution failure 等字样。
动作：可以重试，但最多 3 次，每次间隔至少 2 秒。3 次仍失败告诉用户 "网络好像有点抖，等会儿再试一次好吗？"。
claim_coupon 成功送达但本地解密失败 → 视为已领，停止重试关键认知：claim_coupon 只要 HTTP 返回 200 且 securityCode=0000，
国航账户侧已经领到券了（2026-04-29 trace 证据在案）。哪怕本地解密失败
看不到券码，也不要再用同一个手机号+验证码重领——国航会判重复，
反而让用户以为"没领到又领了一堆"。
动作：告诉用户"券应该已经发到你国航账户了，打开国航 App → 个人中心 → 优惠券 看一下；如果没看到我再帮你找维护同学确认"。 同时在 stderr 打印原始加密响应供运维排查。
根据当前环境可用的工具选择对应脚本：
| 用户系统 | 推荐脚本 | 可用工具 |
|---|---|---|
| macOS / Linux | scripts/airchina.sh | Bash |
| Windows | scripts/airchina.ps1 | PowerShell |
| 其它 / 需融入 Python 业务代码 | scripts/airchina_client.py | Bash 或 PowerShell 调 python |
判断方法：看你当前环境里哪些工具可用——只有 PowerShell 没有 Bash 就是 Windows。
WorkBuddy 的 Windows PowerShell 沙箱会静默拦截若干 .NET API——命令既不报错也不输出， 看起来像代码写错实际是被沙箱吃掉。已知被拦 API：
| 被拦截的 API | 替代方案 |
|---|---|
[Convert]::FromBase64String(...) | 用 System.Security.Cryptography.FromBase64Transform |
[Convert]::ToBase64String(...) | 用 System.Security.Cryptography.ToBase64Transform |
完整清单和踩坑排查流程见 references/windows-sandbox.md。
铁律（Windows 下做加解密必守）：
scripts/airchina.ps1 封装好的命令[Convert]::FromBase64String(...) 代码——这是已知陷阱，写多少次都会静默失败airchina.ps1 某个操作失败时立刻停止重试，去读它 stderr 的错误信息，不要改内部实现scripts/airchina.sh check-env # 检查配置
scripts/airchina.sh send_sms_code --phone <号> --area-code 86
scripts/airchina.sh claim_coupon --phone <号> --area-code 86 --veri-code <码>
scripts/airchina.sh invoke --adapter <X> --procedure <Y> --req '{...}' # 扩展新接口
AIRCHINA_DEBUG=1 scripts/airchina.sh send_sms_code --phone <号> # 对账调试
依赖：curl openssl jq base64 awk od（类 Unix 自带）
scripts\airchina.ps1 check-env # 检查配置
scripts\airchina.ps1 send_sms_code --phone <号> --area-code 86
scripts\airchina.ps1 claim_coupon --phone <号> --area-code 86 --veri-code <码>
scripts\airchina.ps1 invoke --adapter <X> --procedure <Y> --req '{...}'
$env:AIRCHINA_DEBUG='1'; scripts\airchina.ps1 send_sms_code --phone <号>
依赖：PowerShell 5.1+（Windows 自带），零外部依赖。 脚本已内置 Base64/AES 沙箱规避，调用者不用也不应该关心底层怎么实现。
python scripts/airchina_client.py send_sms_code --phone <号> --area-code 86
# 或 import
from scripts.airchina_client import AirChinaClient
client = AirChinaClient()
client.send_sms_code(phone="...", area_code="86")
依赖：pip install requests pycryptodome
所有对接参数都写死在 scripts/airchina.sh 和 scripts/airchina_client.py 顶部，不读任何环境变量。想改就直接改这两个文件的顶部常量块：
| 常量 | 值 | 含义 |
|---|---|---|
APP_ID | iU4qgwcjS6vWkDOTsVKX3zQe | 国航签发的 appId |
SECRET_KEY | qOtUj1yAg3h9rYvEWsN8XluM | 国航签发的 secretKey |
CHANNEL | TENCENT | 国航给腾讯 WorkBuddy 的渠道 |
SUB_CHANNEL | OTA | 固定 |
SERVICE_VERSION | 10100 | 文档 v1.0.0 当前版本 |
ENV_MODE | test / prod | 切换测试/生产网关 |
两个可选临时覆盖的环境变量（日常不用）：
AIRCHINA_ENV=prod — 切换到生产环境AIRCHINA_DEBUG=1 — 打印中间值用于对账上生产时：只改 APP_ID / SECRET_KEY / ENV_MODE 三项。
下面两条是文档没写明、我们联调踩坑后才定位到的隐藏约定。skill 已内置处理，新加接口或自己改实现时必须保留。
国航 MD5Util.Md5 返回大写，小写会稳定返回 securityCode=1000（签名验证失败）。Bash 版在 md5_of() 里 tr 'a-f' 'A-F'，Python 版 .hexdigest().upper()。
resp 解密后还需 URL-decodeAES 解密后得到的是 %7B%22msg%22%3A%22ok%22%7D 这种 URL-encoded 字符串，必须再 urldecode 一次才能得到 JSON。Bash 版用 awk 实现，Python 版用 urllib.parse.unquote。
下面是文档明确写出的规范，理解用：
按 key 升序拼 lang=zh_CN&req=<JSON裸值>×tamp=<毫秒>，整串 MD5，结果转大写。
accessToken[8:24]（16 字节，AES-128）AES/ECB/PKCS5Padding-nosaltresp.code == "0"resp.code == "00000000"Bash 版文件缓存在 $TMPDIR/airchina_token_${env}.json，缓存 110 分钟，过期自动刷新。
| 层级 | 缓存对象 | 位置 | 有效期 | 用户感知 |
|---|---|---|---|---|
| L1 | accessToken（应用级凭证） | $TMPDIR/airchina_token_*.json (Bash) / 进程内 (Python) | 110 分钟（国航标 2h 减 10min 余量） | 无感，Agent 和国航之间的事 |
| L2 | 短信验证码 60 秒频控 | 国航后端 | 60 秒 | 有感（重发被拒） |
| L3 | 短信验证码本身 | 国航后端 | 推测 5–10 分钟（文档没写） | 有感（超时领券失败） |
| L4 | 活动领券记录 | 国航账户 | 永久（按活动规则可能限每人一次） | 有感（重复领可能被拒） |
accessToken 是应用级凭证（腾讯 WorkBuddy 这个 appId 的通行证），不是用户身份。1 个 accessToken 可以给 N 个用户发短信、领券。不要在对话里把它暴露给用户。
国航后续会补接口（文档暗示有 ACOTATrip / getRecycleTripData 等）。扩展步骤：
invoke
scripts/airchina.sh invoke --adapter <X> --procedure <Y> --req '{...}'
scripts/airchina.sh 加 cmd_xxx() 函数 + main() 的 case 分支references/api-xxx.md 写一份字段表references/protocol.md — 协议细节references/api-send-sms-code.md — 短信接口字段references/api-claim-coupon.md — 领券接口字段references/status-codes.md — 错误码对照references/troubleshooting.md — 7 关卡诊断流程references/windows-sandbox.md — Windows PowerShell 沙箱已知限制与规避方案examples/curl-demo.sh — 手工 curl 示例⚠️ 本 skill 基于国航 B2C 接口规范 v1.0.0（2026-04-29）。v2.x 升级时重点核对签名、加密、channel 值是否变化。