Agent Skills
› zts212653/clowder-ai
› ttfund-skills
ttfund-skills
GitHub封装天天基金官方网关，提供基金净值、持仓、搜索及行情等结构化数据查询。严禁交易执行或投资建议，需配置API密钥并经由F207层处理。
Trigger Scenarios
查询基金净值、持仓、基金经理信息
搜索基金、指数、投顾策略
获取黄金、债市、活期宝行情
Install
npx skills add zts212653/clowder-ai --skill ttfund-skills -g -y
SKILL.md
Frontmatter
{
"name": "ttfund-skills",
"triggers": [
"天天基金 skills",
"ttfund",
"TTFUND_APIKEY",
"天天基金净值",
"天天基金搜索",
"天天基金经理",
"天天基金持仓",
"天天黄金",
"天天债市"
],
"description": "天天基金官方 Skills 网关调用封装。 Use when: 查询天天基金\/天天财富基金数据、基金搜索、基金净值、基金持仓、基金经理、指数、黄金、债市、活期宝或官方 ttfund skills。 Not for: 交易执行、券商\/银行账户操作、FRED\/Tushare\/yfinance\/AKShare 结构化数据源、投资建议。 Output: 通过官方网关返回的结构化 JSON 事实数据，带 source\/asOf 后再进入 F207 数据层。 GOTCHA: 必须有本机 `TTFUND_APIKEY`，且 key 只放环境变量或 gitignored `.env`，绝不写入 git 或回复全文。\n"
}
TTFund Skills
天天基金官方 Skills 是一个 HTTP 网关，不是开源 GitHub 包。所有能力共用 TTFUND_APIKEY，调用统一网关：
https://skills.tiantianfunds.com/ai-smart-skill-service/openapi/skill/invoke
官方安装说明：https://skills.tiantianfunds.com/ttfund-skills/ttfund-all-skills.md
When to Use
用它查天天基金体系内的基金事实数据：基金信息、历史净值、重仓持仓、基金经理、基金/指数搜索、黄金行情、债市行情、活期宝和模拟组合回测。
不要用它做真实交易、账户读取、买卖建议，也不要替代 FRED / Tushare / yfinance / AKShare 的市场宏观数据职责。F207 里它是基金数据 connector，进入 cat-cafe-finance 包装层后才能给分析层使用。
Quick Reference
# 列出已知 skill_id 和版本
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs list
# 基金搜索
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_SEARCH \
'{"query":"沪深300","search_type":"fund","page_index":1,"page_size":5}'
# 基金综合信息
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_BASE_INFOS \
'{"fcode":"000001","nav_range":"n"}'
# 基金净值
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_NAV_INFO \
'{"fund_id":"000001","range":"n"}'
脚本会按顺序读取：
- 当前进程环境变量
TTFUND_APIKEY - 仓库根目录
.env - 仓库根目录
.env
.env 已被 .gitignore 忽略；不要把 key 写进任何 tracked 文件。
Skill IDs
| skill_id | version | 用途 |
|---|---|---|
FUND_BASE_INFOS |
1.2.0 | 基金综合信息 |
FUND_MANAGER_INFO |
1.0.0 | 基金经理信息 |
FUND_CONDITION_SELECT |
1.1.0 | 条件选基 |
FUND_HOLDING_INFO |
1.0.0 | 基金持仓 |
FUND_HUAAN_GOLD_INFO |
1.0.0 | 黄金行情 |
FUND_TG_STRATEGY_INFO |
1.0.0 | 投顾策略 |
FUND_INDEX_INFO |
1.0.0 | 指数行情 |
FUND_NAV_INFO |
1.0.0 | 基金净值 |
MODEL_PORTFOLIO |
1.0.0 | 模拟组合回测/预览 |
FUND_FAVOR_ZX |
1.2.0 | 自选管理 |
BOND_MARKET |
1.0.0 | 债市行情 |
FUND_GROUP_BACKTEST |
1.0.0 | 组合回测 |
FUND_SEARCH |
1.0.0 | 基金/指数/经理/投顾搜索 |
FUND_STOCK_PRICE_QUERY |
1.0.0 | 股票实时行情 |
FUND_THEME_INFO |
1.0.0 | 基金主题 |
FUND_HUOQIBAO_LIST |
1.0.0 | 活期宝 |
Common Mistakes
| 错误 | 后果 | 修复 |
|---|---|---|
| 把 API key 写进命令历史、文档或 git | 凭证泄露 | 只放环境变量或 .env，回复中只写 masked key |
| 让猫猫直接长期调用裸 ttfund 网关 | 缺 source/asOf/cache/audit | Spike 可以直连；正式 Phase B 走 cat-cafe-finance 包装层 |
忘记 _skill_version |
网关可能拒绝或走旧版本 | 让脚本自动补版本，手写 curl 必须带版本 |
把 MODEL_PORTFOLIO 当真实交易 |
违反 F207 交易边界 | 只允许模拟/预览，不连接真实交易执行 |
| 把返回数据当投资建议 | 越过分析师边界 | 只作为事实数据，建议必须走 F207 分析/决策护栏 |
下一步
F207 B-spike 验证通过后，把这个 connector 纳入 cat-cafe-finance 的统一 schema / cache / provenance 层。
Version History
- 4167cb0 Current 2026-07-05 14:53
