codeact-script-writer

name	codeact-script-writer
description	提供CodeAct脚本编写、调试、优化和审查的渐进式规则路由，按任务类型加载核心、联网、并发、报告、状态和Skill/CLI规范，保证脚本可运行、可复用、可追踪；当用户需要生成脚本、修复脚本、优化脚本或评估脚本合规性时使用

CodeAct 脚本编写器

使用本 Skill 编写、调试、优化或审查 CodeAct Python 脚本。

核心原则是渐进式加载规则：不要一开始读取全部规则文件。先判断用户需求类型，再只读取当前任务需要的 reference 分片；如果任务范围扩大，再追加读取对应分片。

必须先做

1. 将用户请求分类为一个或多个任务类型。
2. 所有任务都先读取 references/core.md。
3. 只读取下表中与任务类型匹配的 reference 文件。
4. 如果任务功能接近 assets/script/ 目录内的参考脚本，读取对应脚本作为实现参考。
5. 如果是编写或修改脚本，除非用户明确只要分析，否则需要实现并运行验证后再交付。

任务类型路由

用户意图	需要加载的规则
通用 CodeAct 脚本生成、调试、合规检查	references/core.md
联网搜索、网页抓取、API 数据、新闻、政策、行情、榜单	references/web-data.md
批量抓取、多次 LLM 调用、长文本分块、多文件/多 item 处理	references/concurrency.md
日报、周报、监控简报、调研报告、分析报告	references/reporting.md
定时/重复执行、去重、增量运行、历史基线库	references/state.md
跨来源报告、增量报告、带状态库的 agentic reporting	references/agentic-report-blocks.md
任务需要使用其他 Skill、Skill CLI、本地脚本、飞书 lark-cli	references/skill-cli.md

参考脚本索引

assets/script/ 目录保存可复用的 CodeAct 脚本参考实现。写相近功能时先读规则，再按需打开对应脚本：

功能类型	参考脚本	重点学习点
天气查询、确定 URL 抓取、搜索兜底	assets/script/weather_query.py	codeact_fetch_web 主源、codeact_search_web 兜底、ResponseFormat 抽取、用户简报
行情/价格监控、阈值告警	assets/script/gold_price_monitor.py	schema version、主源 + 搜索兜底、数值解析、auto 分流和 @主人
长文翻译/改写/多块 LLM	assets/script/long_text_translate.py	Markdown 分块、术语表、上下文窗口、LLM 并发、失败块回填
飞书文档监控、lark-cli、增量 diff	assets/script/feishu_doc_watch.py	CLI 边界、授权检查、SQLite 状态、冷启动基线、内容快照、diff 分块总结
跨来源报告、增量报告、agentic reporting	assets/script/moore_threads_daily_briefing.py + references/agentic-report-blocks.md	动态检索、候选筛选、内容获取、事实抽取、信息单元聚合、SQLite 状态、冷启动基线、短 message + 长报告
数据+新闻融合日报、多章节长报告、带图表	assets/script/daily_stock_summary.py	DomainConfig 领域配置集中管理、CLI 行情 + 分章节搜索、分块串行章节化写作（滚动上下文）、matplotlib 生成图表→上传→Markdown 引用、版本化缓存、baseline/增量双检索窗口、正文直喂+prompt 质量约束的简化取舍
定时提醒、轻量 scaffold	assets/script/reminder.py	最小脚本结构、display_only 提醒、@主人、安装时自定义文案

分类启发式

• 出现“最新、今日、近期、政策、新闻、榜单、价格、行情、网页、搜索、抓取、API”等意图时，加载 web-data.md。
• 脚本会处理多个 URL、query、文件、item、chunk 或多次 LLM 抽取时，加载 concurrency.md。
• 用户期待可读的日报、周报、摘要、调研结论或分析报告时，加载 reporting.md。
• 用户要做跨来源信息聚合、增量报告、带状态库的日报/周报/监控简报时，追加加载 agentic-report-blocks.md。
• 脚本会定时运行、重复运行、监控、增量更新，或需要避免重复通知时，加载 state.md。
• 输出较长、有表格、有附件、有报告文件或需要下载链接时，使用 core.md 中的输出与提交规则；如属于报告类，再加载 reporting.md。
• 用户指定某个 Skill，或任务需要使用 Skill 提供的 CLI、本地脚本、飞书 lark-cli 等能力时，加载 skill-cli.md。

执行风格

• 优先遵循当前仓库和工作区已有约定。
• 可变业务值需要抽象为命令行参数，并提供安全默认值。
• 脚本内只能使用 CodeAct SDK 侧工具；不得在脚本里调用 Agent 侧工具。
• 工具 schema version 必须使用实际版本常量，并按工具分别引用。
• 批量独立 SDK 调用默认使用 asyncio.gather + asyncio.Semaphore 并发执行。
• 所有代码路径都必须 submit_result；错误提交必须使用 result_mode="notify"。

交付格式

完成后说明：

• 脚本路径或修改文件
• 已实现或已审查的内容
• 验证结果
• 如相关，说明 result_mode 行为

资源索引

• 参考:见 references/core.md(何时读取:所有 CodeAct 脚本任务先读取)
• 参考:见 references/web-data.md(何时读取:联网搜索、网页抓取、API 数据、新闻、政策、行情、榜单)
• 参考:见 references/concurrency.md(何时读取:批量抓取、多次 LLM、长文本分块、多文件或多 item 处理)
• 参考:见 references/reporting.md(何时读取:日报、周报、监控简报、调研报告、分析报告)
• 参考:见 references/state.md(何时读取:定时/重复执行、去重、增量运行、历史基线库)
• 参考:见 references/agentic-report-blocks.md(何时读取:跨来源报告、增量报告、带状态库的 agentic reporting)
• 参考:见 references/skill-cli.md(何时读取:任务需要使用其他 Skill、Skill CLI、本地脚本、飞书 lark-cli)
• 资产:见 assets/script/(用途:CodeAct 脚本参考实现，按“参考脚本索引”选择读取，不直接作为 Skill 工具执行)