company-checkup
Company Checkup
从 GodKnows 投资分析平台获取公司综合体检报告。本技能为通用技能，安装到统一目录后可供 Cursor、Qoder 等多种 agent 引用。
安装
使用 skills CLI 从 registry 安装（全局安装到 ~/.agents/skills/）：
npx skills add http://skills.whatis.vip --skill company-checkup -g
安装后技能根目录为 ~/.agents/skills/company-checkup/。Cursor、Qoder 等可配置为直接引用 ~/.agents/skills/，或由 npx skills add 在安装时同步到各自 agent 目录（如 ~/.cursor/skills/、~/.qoder/skills/）。下文的 <SKILL_ROOT> 即该技能根目录（例如 ~/.agents/skills/company-checkup）。
配置（与安装位置解耦）
- 推荐：使用统一配置路径
~/.config/godknows/config.json（与技能安装位置无关，便于多端共用）。格式：{ "api_base": "http://money.whatis.vip", "username": "xxx", "password": "xxx", "token": "获取到的token" } - 运行时可将该文件中的
api_base、token通过环境变量 GODKNOWS_API_BASE、GODKNOWS_TOKEN 传给脚本；或调用脚本时直接传参[api_base] [token]。 - 也可在技能根目录下放置
config.json（技能根目录 = SKILL.md 所在目录，由安装环境决定）。
首次使用
若尚无 token，向用户询问用户名和密码，在技能根目录下执行登录脚本（将 <SKILL_ROOT> 替换为当前技能的安装根目录）：
bash <SKILL_ROOT>/scripts/login.sh <username> <password> [api_base]
将返回的 token 与 api_base 写入上述 config，并可在后续调用前设置 GODKNOWS_API_BASE、GODKNOWS_TOKEN 或通过参数传入。
后续使用
直接使用 config 中的 token；若 API 返回 errorCode: "NOT_LOGIN"，需重新执行 login.sh 并更新 config。
执行流程
1. 解析用户输入
用户可能输入股票代码（如 AAPL、00700.HK）或公司中文名（如苹果、腾讯）。若为中文名，先调用公司列表接口，在返回的 label 中模糊匹配得到 value（ticker）。
在技能根目录下执行（或由运行时注入 GODKNOWS_* 后执行）：
bash <SKILL_ROOT>/scripts/companies.sh [api_base] [token]
返回格式：{"success":true,"data":[{"value":"AAPL","label":"AAPL - Apple Inc."},...]}。
2. 调用体检接口
bash <SKILL_ROOT>/scripts/checkup.sh <ticker> [api_base] [token]
3. 格式化输出
将 JSON 格式化为易读中文报告：标题（公司名、ticker）、财年与综合评分/评级，以及巴菲特、Baillie Gifford、彼得·林奇三部分表格。状态映射：pass→✅、warning→⚠️、fail→❌。
4. 错误处理
errorCode: "NOT_LOGIN"→ 提示重新登录并更新 configsuccess: false→ 提示公司可能不在系统中- 网络超时 → 提示 API 不可达
- 中文名匹配不到 → 列出候选公司供用户选择