3-4 references/templates/scripts子目录

Skill的目录结构

skills/
└── finance/
    └── stock-daily-analysis/
        ├── SKILL.md              # 核心文件，触发条件和流程
        ├── references/           # 参考文档，API文档，历史记录
        │   ├── baostock-api.md
        │   └── backtest-results-20260720.md
        ├── templates/            # 输出模板
        │   └── report-template.md
        └── scripts/              # 辅助脚本
            └── analyze_stock.py

三个子目录各自的用途

references/（参考文档）

存放AI执行任务时需要查阅的资料：

• API文档（如baostock的接口说明）
• 历史执行记录（如某次调试的解决方案）
• 业务规则文档
• 外部数据格式说明

templates/（输出模板）

存放固定格式的输出模板：

• 报告模板（Markdown格式）
• 邮件模板
• 数据提取模板

scripts/（辅助脚本）

存放可直接运行的脚本：

• 数据采集脚本
• 数据处理脚本
• 测试脚本

如何读取子目录内容

# 在Skill里引用子目录
skill_view(name="stock-daily-analysis")
# 返回：{"linked_files": {"references": [...], "templates": [...], "scripts": [...]}}

# 读取具体文件
skill_view(name="stock-daily-analysis", file_path="references/baostock-api.md")
skill_view(name="stock-daily-analysis", file_path="templates/report-template.md")

什么内容放子目录 vs 直接写在SKILL.md

原则：SKILL.md保持精简，只放核心流程和触发条件。把"重"的内容放进子目录，用skill_view()按需读取，避免每次加载Skill都要消耗大量token。