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 查询年报列表，以及读取具体年报的结构化数据。

本技能默认需要 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>。

任务	命令
查某公司某年年报	`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`

用户现在缺什么？
├── 缺年报定位结果 → annual-report latest
├── 已有 met_uuid → annual-report data
└── 其实要提交分析任务 → 先 latest，再切 annual-analysis

clawshire annual-report latest --year 2025 --keyword 平安银行 --page-size 3

clawshire annual-report latest --year 2025 --keyword 000001 --format json

clawshire annual-report data 10fd860b-c12e-54b3-a5b3-38c2ecdf5b2b --format json

clawshire-annual-report