메뉴
帮用户领取中国国航（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명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? 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 值是否变化。