用途:这是一个仅作编排(orchestrator)的技能,负责调度事件描述审计,而不在技能本体中执行逐事件过滤、仓库搜索或描述撰写逻辑,这些工作交给 event-descriptions-worker 子代理完成。
主要能力:解析项目(projectId 或项目名经 get_context 解析);用短 git SHA 生成 runId(<projectId>-<sha>);在 runs/ 下建立运行目录;制定游标计划(默认 cursorStart=0、maxEvents=400、eventsPerWorker=50、maxParallelWorkers=4);按游标分块并行派生 worker;收集各 worker 摘要与输出路径;用压缩脚本合并分块 CSV;报告进度与下一个游标。
使用方式:需用户提供 projectId 或项目名,否则停止并询问。项目名有多个匹配时须由用户选择。运行根目录运行 git rev-parse --short HEAD 获取短 SHA 并创建 .agents/skills/event-description-generator/runs/<runId>/。worker 输出为 event-descriptions-<cursor>.csv。全部完成后运行 python3 .agents/skills/event-description-generator/scripts/compress-run.py <runId>,仅保留含 suggested_description 的行,脚本失败不阻塞报告。写入阶段仅在用户明确要求时执行,固定 eventsPerWriter=100、maxParallelWriters=4;先用 python3 .agents/skills/event-description-generator/scripts/writer-plan.py <csvPath> 计算分块,再派生 event-descriptions-writer。
限制:本技能为调度器,不得调用 set_event_metadata,不重新实现 worker 过滤逻辑,须保留用户对范围、游标、分块与并行度的控制。压缩文件不存在时需用户提供路径并停止。其他细节暂未提供。