其他
维护已有 Elastic 集成包时,做质量审查…
适用于已有 Elastic integration package 的评审、修复、改进和细微调整。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 38/100 ×0.15
适用场景
维护已有 Elastic 集成包时,做质特定
解决思路
- 在开始只读审查模式前,完整阅读 `references/review-workflow.md`。
- 只读审查:运行自动化验证;将检查委派给子代理,并让其以 `review-integration/references/reviewer-subagent-guidance.md` 作为操作手册;只呈现发现,不做任何文件修改。
- 在开始全量改进模式前,完整阅读 `references/improve-workflow.md`。
- 全量改进:分析问题(来自之前的 review 或新的 reviewer 运行),按严重程度排序,直接修复或委派给子代理,重新验证并报告。
- 微小直接修复无需加载完整工作流,可内联处理:修正 manifest 字段(title、description、format_version、conditions、owner)。
- 处理 changelog 条目和版本提升;参考 `package-spec` 技能。
- 修复 `_dev/build/docs/README.md` 中的文档占位文本。
- 创建 `_dev/build/build.yml` 或提升 ECS 引用版本。
- 做简单 field 文件修复(拼写错误、缺失条目、删除重复项)。
- 仅做 CEL 格式化时,在流的 `agent/stream/` 目录运行 `celfmt -s -agent -i cel.yml.hbs -o cel.yml.hbs`。
- 任何直接编辑后运行 `elastic-package lint` 和 `elastic-package check` 确认无回归。
- 直接工作时加载 `elastic-package-cli` 技能,获取验证和测试命令。
- 直接工作时加载 `package-spec` 技能,获取 manifest 规则、版本提升和 changelog schema。
- 不要将领域特定技能(pipelines、CEL、ECS、field mappings)加载到自己的上下文中;委派给已具备这些知识的子代理。
- 所有专门工作都委派给平台的通用/一般用途子代理(Cursor: `generalPurpose` Task agent;Claude Code: `general-purpose` Task agent;或其他平台等价物)。
- 每个任务提示必须按路径指向子代理相关的 `*-subagent-guidance.md` 文件,并指示其在做其他工作前端到端阅读该文件(以及其“First steps”中列出的技能 SKILL.md)。
- 不要自己阅读 guidance 文件,也不要将其内容粘贴到任务提示中;只传路径和任务特定上下文。
- 让子代理在自己的全新上下文中自行加载手册。
- 完整 dispatch 规则和各工作流细节见 `references/review-workflow.md` 和 `references/improve-workflow.md`。
- 审查用 `review-integration/references/reviewer-subagent-guidance.md`:按域分类文件,通过 `review-integration` 技能加载所有相关领域技能和检查清单,返回按严重程度排序、带领域标签的发现,进行彻底只读质量检查。
- Pipeline 修复用 `ingest-pipelines/references/builder-subagent-guidance.md`:处理 JSE00001、错误处理、processor tags、ECS categorization、field definitions、test fixtures。
- CEL 修复用 `cel-programs/references/builder-subagent-guidance.md`:处理程序逻辑、cursor management、error handling、mito validation、mock API、`cel.yml.hbs` 模板、manifest var cleanup。
- 委派时给子代理提供:package path、data stream path、要修复的具体问题(粘贴 findings)、相关 sample data,以及任何约束。
- 所有提交的数据必须完全匿名化:任何提交文件中不得出现真实 IP、主机名、电子邮件、令牌或组织标识符。
- 修复或添加 test fixtures、mock responses、sample events 或文档示例时,验证所有值均为合成数据。
- 在改进过程中发现任何真实数据时,将其匿名化。
适用边界 · 注意事项
- 创建新的 integration package 时不要用本技能,改用 `create-integration`。
- 向已有 package 添加新 data stream 时不要用本技能,改用 `create-integration` 并参考 `references/add-datastream-workflow.md`。