用途:协助撰写或更新 Elastic Workflows 文档集(docs-content 中 explore-analyze/workflows/)的页面,包括步骤参考、用例、操作指南、概念、总览、参考及迁移指南,以及以新增或修改 Workflows 页面为交付物的文档 issue。范围之外(如 Security Cases UI、Fleet、APM、Kibana 应用指南,或把功能内容硬塞进 Workflows 路径)应直接拒绝,不重构成 Workflows 内容。
主要流程:输入可为文档 issue(GitHub URL 或 owner/repo#number)、页面想法或提纲、待起草/更新的文件路径,或工作流 YAML 示例;若为空则从 Step 0 接入开始。先做范围检查,再从 issue 提取页面范围、类型、目标路径、受众、来源材料、验收标准、建议的文档工作、时间线和开放问题,并阅读评论。开放问题分为已解决、未解决、可研究三类;未解决项需先向用户确认,或经用户同意按明示假设继续。随后分类页面类型并研究事实,禁止猜测步骤类型、参数名或 UI 标签。
研究来源:优先使用已发布文档(elastic-docs MCP 端点 https://www.elastic.co/docs/_mcp/,不可用时用 WebFetch 抓取 https://www.elastic.co/docs/... 页面),需阅读 Workflows hub、cheat-sheet、step-types、anatomy、choose-the-right-step 等锚点页;再查 Kibana 源码,优先查 kbn-workflows/spec/ 下的 schema.ts、builtin_step_definitions.ts、builtin_trigger_definitions.ts 与各命名空间目录,并按步骤类型标识搜索注册插件;官方示例在 kbn-workflows/spec/examples/。若本地有 docs-content 检出,可参考同目录页面风格、_snippets/ 可复用片段与 toc.yml 导航位置。
编写规则:YAML 示例对步骤类内容使用 steps: 块,仅在触发器、输入或设置重要时给完整工作流;两空格缩进,保持可复制粘贴;步骤命名具描述性(如 search_for_alerts);显式展示步骤间数据流(steps.<name>.output)。cheat-sheet 是注意事项的权威依据。
限制与要求:可选配套技能 elastic-docs MCP、docs-content-type-checker、docs-syntax-help 仅在已安装时使用,缺失不视为失败;安装命令 npx skills@latest add elastic/elastic-docs-skills --skill docs-content-type-checker -g。不得引用或链接已弃用的 Keep HQ 工作流文档。不编造功能、参数或平台信息;未提供的事实(如具体收费、价格、支持平台与效果)暂未提供。