memect/clawshire-cli/clawshire-annual-report

/clawshire-annual-report - Annual Report Query

CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../clawshire-shared/SKILL.md`](../clawshire-shared/SKILL.md)，其中包含安装、认证、错误处理与安全规则。

通过 clawshire CLI 查询年报列表，以及读取具体年报的结构化数据。

Agent Invariants

1. 本技能默认需要 API Key；若认证状态不明确，先回到 shared skill 检查。
2. 用户想“先找到年报”时，优先 annual-report latest。
3. 用户已经有 met_uuid 时，直接 annual-report data，不要重复检索列表。
4. 如果用户最终目标是做分析，先用本技能找到目标年报，再切到 clawshire-annual-analysis。
5. 返回给 Agent 时，优先 --format json，保留 met_uuid、company_code、pdf_url。
6. Agent 调用 CLI 时，命令前必须带 --client skill --skill-name clawshire-annual-report --agent-name <agent-name-or-unknown-agent> --rationale <why-this-call>。

Quick Reference

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

• 命令与示例：`references/commands.md`
• 输出规则：`references/output.md`