| name | clawshire-annual-analysis |
| version | 1.0.0 |
| description | ClawShire 年报分析技能。通过 clawshire CLI 发起年报分析任务，支持本地 PDF、PDF 直链、按公司定位年报三种方式，并可查询任务状态与下载报告。 |
| triggers | ["clawshire annual-analysis","年报分析","分析年报","pdf 分析","annual-analysis company","annual-analysis pdf-file","annual-analysis pdf-url","annual-analysis get"] |
| invocable | true |
| argument-hint | [company|pdf-file|pdf-url|get] [args...] |
| metadata | {"requires":{"bins":["clawshire"]},"cliHelp":"clawshire annual-analysis --help"} |
/clawshire-annual-analysis - Annual Analysis
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../clawshire-shared/SKILL.md，其中包含安装、认证、错误处理与安全规则。
通过 clawshire CLI 发起年报分析任务，并查询分析状态或下载报告。
Agent Invariants
- 本技能会触发真实分析任务，可能消耗额度；用户意图不明确时不要自动提交。
- 用户只给公司代码或简称时，优先
annual-analysis company，这是最稳定入口。
- 用户给本地 PDF 时，才用
pdf-file；给 PDF 直链时，才用 pdf-url。
- 用户已经有
task_id 或 job_id 时，优先 get，不要重复提交。
pdf-url 依赖上游 PDF 可访问；失败时优先回退到 company 模式。- 如果服务端提示“已有分析任务在进行中”，这通常说明链路已到达服务端，重复提交没有意义。
- Agent 调用 CLI 时，命令前必须带
--client skill --skill-name clawshire-annual-analysis --agent-name <agent-name-or-unknown-agent> --rationale <why-this-call>。
Quick Reference
| 任务 | 命令 |
|---|
| 按公司提交分析 | clawshire annual-analysis company <kw> --year <YYYY> |
| 用本地 PDF 提交 | clawshire annual-analysis pdf-file <path> |
| 用 PDF 链接提交 | clawshire annual-analysis pdf-url <url> |
| 查询任务状态 | clawshire annual-analysis get <task_or_job_id> |
| 下载完成后的 HTML 报告 | clawshire annual-analysis get <id> --save-report-to report.html |
Decision Tree
用户手里有什么？
├── 证券代码或公司简称 → annual-analysis company
├── 本地 PDF 文件 → annual-analysis pdf-file
├── PDF 直链 → annual-analysis pdf-url
└── task_id / job_id → annual-analysis get
Common Workflows
最推荐：按公司提交分析
clawshire annual-analysis company 000001 --year 2025 --format json
用本地 PDF 提交
clawshire annual-analysis pdf-file ./report.pdf --format json
查询任务状态
clawshire annual-analysis get 74 --format json
下载已完成报告
clawshire annual-analysis get 74 --save-report-to report.html
Output Rules
- 面向用户：至少说明当前分析对象、任务 ID、状态、下一步命令。
- 面向脚本：优先
--format json。
- 如果提交结果里带
next_command，优先直接提示执行它。
References
