| name | clawshire-annual-report |
| version | 1.0.0 |
| description | ClawShire 年报查询技能。通过 clawshire CLI 查询年报列表与结构化年报数据，适合按年份、公司简称、证券代码快速定位年报。 |
| triggers | ["clawshire annual-report","年报查询","查年报","定位年报","annual-report latest","annual-report data","met_uuid","年报 pdf"] |
| invocable | true |
| argument-hint | [latest|data] [args...] |
| metadata | {"requires":{"bins":["clawshire"]},"cliHelp":"clawshire annual-report --help"} |
/clawshire-annual-report - Annual Report Query
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../clawshire-shared/SKILL.md，其中包含安装、认证、错误处理与安全规则。
通过 clawshire CLI 查询年报列表，以及读取具体年报的结构化数据。
Agent Invariants
- 本技能默认需要 API Key；若认证状态不明确，先回到 shared skill 检查。
- 用户想“先找到年报”时，优先
annual-report latest。
- 用户已经有
met_uuid 时，直接 annual-report data，不要重复检索列表。
- 如果用户最终目标是做分析，先用本技能找到目标年报，再切到
clawshire-annual-analysis。
- 返回给 Agent 时，优先
--format json，保留 met_uuid、company_code、pdf_url。
- Agent 调用 CLI 时，命令前必须带
--client skill --skill-name clawshire-annual-report --agent-name <agent-name-or-unknown-agent> --rationale <why-this-call>。
Quick Reference
| 任务 | 命令 |
|---|
| 查某公司某年年报 | clawshire annual-report latest --year <YYYY> --keyword <kw> |
| 按交易所过滤 | clawshire annual-report latest --year <YYYY> --exchange <ex> --keyword <kw> |
| 查结构化数据 | clawshire annual-report data <met_uuid> |
| 返回结构化 JSON | clawshire annual-report ... --format json |
Decision Tree
用户现在缺什么？
├── 缺年报定位结果 → annual-report latest
├── 已有 met_uuid → annual-report data
└── 其实要提交分析任务 → 先 latest，再切 annual-analysis
Common Workflows
先找到某公司的年报
clawshire annual-report latest --year 2025 --keyword 平安银行 --page-size 3
返回 JSON 供脚本继续处理
clawshire annual-report latest --year 2025 --keyword 000001 --format json
用 met_uuid 查询结构化年报
clawshire annual-report data 10fd860b-c12e-54b3-a5b3-38c2ecdf5b2b --format json
Output Rules
- 面向用户：至少给出公司名、证券代码、发布时间、PDF 链接。
- 面向脚本：保留
met_uuid 作为后续分析和追踪的主键。
- 若结果有多条，优先解释为什么命中多条，再建议用户缩小关键词或年份。
References
