关于 maintain-integration
用于审查和维护现有集成包，涵盖只读质量检查、修复及重新验证。它区分维护与新建集成或添加数据流，并提供委派专项任务的指导。
主要功能
- 01只读集成包审查
- 02分析、修复与重新验证
- 03清单和文档定向修复
- 04专项子 Agent 委派指导
- 05数据匿名化检查
适用场景
- 01审查现有集成包
- 02修复管道或 CEL 问题
- 03维护后验证更改
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/maintain-integration确认已加载。
附带文件references/improve-workflow.mdreferences/review-workflow.md
详细介绍
maintain-integration
何时使用此技能，何时使用 create-integration
当软件包已存在时使用此技能：
- 审查现有软件包的质量、ECS 合规性或正确性
- 修复具体问题：流水线错误、字段映射、ECS 分类、CEL 程序、清单
- 进行完整的质量改进（审查 → 修复 → 重新验证）
- 对现有数据流进行小幅调整
以下情况请改用 create-integration：
- 从头开始创建新的集成软件包
- 向现有软件包添加新的数据流（
create-integration→references/add-datastream-workflow.md）
模式
仅审查（只读，不做修改）
→ 开始前，请完整阅读 references/review-workflow.md。
运行自动化验证，将检查工作委派给子 Agent（参见 references/review-workflow.md 中的派发约定），并让其将 review-integration/references/reviewer-subagent-guidance.md 作为操作手册；只呈现检查结果，不更改文件。
完整改进（分析 → 修复 → 重新验证）
→ 开始前，请完整阅读 references/improve-workflow.md。
分析问题（来自先前的审查或新一轮审查），按严重程度排序，直接修复或委派给子 Agent，重新验证并汇报。
小幅直接修复（无需子 Agent）
对于可以直接处理的小型定向修改，无需加载完整工作流：
- 修正清单字段（title、description、format_version、conditions、owner）
- 添加变更日志条目并更新版本号——参见
package-spec技能 - 修改
_dev/build/docs/README.md中的文档占位文本 - 创建
_dev/build/build.yml或更新 ECS 引用 - 简单的字段文件修复（拼写错误、缺少条目、删除重复项）
- 仅格式化 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— 清单规则、版本更新和变更日志架构
不要将特定领域的技能（流水线、CEL、ECS、字段映射）加载到你自己的上下文中。应将任务委派给已具备相关知识的子 Agent。
子 Agent
所有专业任务都委派给平台的通用 / 多用途子 Agent（Cursor：generalPurpose Task agent；Claude Code：general-purpose Task agent；其他平台使用同等 Agent）。每个任务提示都必须提供相关 *-subagent-guidance.md 文件的路径，并要求子 Agent 在进行任何其他工作之前，从头到尾阅读该文件（以及其中“First steps”列出的技能 SKILL.md）。不要自行阅读指导文件，也不要将其内容粘贴到任务提示中——这会使上下文开销翻倍。只提供路径和任务特定的上下文。子 Agent 会在自己的全新上下文中加载手册。完整的派发规则和各工作流的详细信息见 references/review-workflow.md 和 references/improve-workflow.md。
| 子 Agent 指导文件 | 用途 |
|---|---|
review-integration/references/reviewer-subagent-guidance.md | 全面、只读的质量检查：按领域对文件分类，通过 review-integration 技能加载所有相关领域技能和检查清单，并返回按严重程度排序、带领域标签的检查结果 |
ingest-pipelines/references/builder-subagent-guidance.md | 流水线修复：JSE00001、错误处理、处理器标签、ECS 分类、字段定义、测试样例 |
cel-programs/references/builder-subagent-guidance.md | CEL 修复：程序逻辑、游标管理、错误处理、mito 验证、模拟 API、cel.yml.hbs 模板、清理清单变量 |
委派任务时，请向子 Agent 提供：软件包路径、数据流路径、需要修复的具体问题（粘贴检查结果）、相关样本数据以及任何约束条件。
数据匿名化
提交的所有数据都必须经过完全匿名化处理——任何已提交的文件中都不得包含真实 IP、主机名、电子邮件地址、令牌或组织标识符。修复或添加测试样例、模拟响应、示例事件或文档示例时，请确认所有值均为虚构内容。在改进过程中发现任何真实数据时，都必须将其匿名化。
参考资料
references/review-workflow.md— 只读审查工作流（阶段 1–4、必查清单、输出格式）references/improve-workflow.md— 完整改进工作流（分析 → 排定优先级 → 修复 → 重新验证 → 报告）