> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 初始化（/init）

> 在 AI SRE 会话中输入 /init，由 Agent 以访谈的方式带你从零搭建运维知识库（DUTY.md + runbook + 服务清单等）并按需接入 MCP——每一项写入都需你逐条确认。

<Info>
  **内测功能**：AI SRE 目前处于内测阶段，仅对受邀账户开放。如需参与白名单测试，请联系 Flashduty 商务团队申请开通；内测期间功能与界面可能调整。
</Info>

## 概述

***

在任意 AI SRE 会话的输入框中输入 `/init`，Agent 会切换成一名**运维 onboarding 访谈者**，带你从零搭建一份运维知识库——也就是这个团队的「运营作战图」。它会扫描你的 Flashduty 故障与通知渠道、向你提问、把你口述的服务拓扑、排查手册、集群访问方式等沉淀成知识文件，并在需要时帮你接入外部工具（MCP）。

`/init` 是知识库的**起点**。AI SRE 的诊断质量直接取决于它能读到多少关于你系统的真实知识：[知识库](/zh/ai-sre/knowledge)维护得越完整、越准确，Agent 定位根因就越快、越靠谱。`/init` 就是把这份知识从零建立起来的引导流程，建完之后每一次会话都会自动加载它。

<Note>
  `/init` **不会**在未经你同意的情况下写入或安装任何东西。每个阶段在写入文件前都会列出「将要创建/更新哪些文件」的清单，由你逐条确认后才执行。凭证（token、密码、AK/SK）永远不会在对话里明文回显，只记为 `<已记录（长度=N）>`。详见 [安全与同意](#安全与同意)。
</Note>

## 何时用 /init，何时直接说

***

`/init` 解决的是**结构化的从零搭建 / 系统性补全**；零散的小修小补不需要它。

| 场景                                       | 用法                                                |
| ---------------------------------------- | ------------------------------------------------- |
| 第一次给某个账户 / 团队搭知识库                        | **`/init`**——它会成体系地走完服务、可观测性、runbook、常见故障、集群访问等主题 |
| 系统性地补全或重整一个已有知识库                         | **`/init`**——可随时重跑，它会基于现有内容继续，而非推倒重来              |
| 「补一篇 runbook」「更新 services.md」「记一下这个故障模式」 | **直接用自然语言说**，无需 `/init`——Agent 会就当前会话作用域读取、编辑、保存  |

<Tip>
  `/init` 与零散的自然语言编辑是互补的：用 `/init` 把底子打全，之后在日常排障里随手让 Agent「把这条经验记进知识库」做增量维护。两者写入的是同一个知识库。
</Tip>

## 如何运行

***

<Steps>
  <Step title="在会话中输入 /init">
    在任意一个 AI SRE 会话的输入框输入 `/init` 并发送。无需参数。
  </Step>

  <Step title="确认作用域">
    `/init` 先锁定本次要写入的范围：**账户级**（账户内所有会话可见）或**某个团队级**（仅该团队会话加载）。范围由当前会话是否绑定团队决定，Agent 会先反问你确认；一次会话只锁定一个范围，中途不切换。
  </Step>

  <Step title="跟着访谈走">
    Agent 按主题逐阶段提问（服务与拓扑、可观测性、runbook、常见故障、集群访问……），把你的回答整理成知识文件草稿。每个阶段结束都会问你「继续下一项，还是先停在这里」。
  </Step>

  <Step title="逐项确认后写入">
    每个阶段写入文件前，Agent 会给出一份「将创建/更新哪些文件」的清单，每个文件配 3–5 行摘要。你确认后它才写入知识库，并把新文件链接进 `DUTY.md` 目录。
  </Step>

  <Step title="随时暂停或重跑">
    你可以随时说「跳过这项」「回到第 N 步」「先到这里」。`/init` 不是一次性的——之后任何时候重新输入 `/init` 都能基于已有知识继续补全。
  </Step>
</Steps>

## 访谈流程

***

`/init` 按固定顺序走一套阶段，每个阶段有明确的进入与退出条件。你可以随时跳过、回退或叫停。

<AccordionGroup>
  <Accordion title="阶段 0 — 锁定作用域" icon="crosshairs">
    读取当前会话绑定的团队：若绑定了团队，本次 `/init` 落在该团队级；若是账户级会话，则落在账户级（对所有团队可见）。Agent 会先和你确认这一点，确认后整场会话固定使用这个范围。想换团队范围，需退出后从目标团队重新打开 `/init`。
  </Accordion>

  <Accordion title="阶段 1 — 扫描" icon="radar">
    通过 Flashduty MCP 拉取你的渠道、近 30 天故障、团队与成员，归纳出你在用的集成类型与高频故障标签。若扫描结果为空（全新账户），切换到「冷启动」模式，改为完全靠访谈采集。
  </Accordion>

  <Accordion title="阶段 1.5 — 从本地 AI 编程工具导入（可选）" icon="file-import">
    可选步骤，需你主动同意，绝不自动触发。如果你已经在 Claude Code / Codex / Cursor / Windsurf / Copilot / Gemini CLI 等本地工具里积累了知识与记忆，可一次性导入，避免后续被反复追问。当 Runner 能直接访问到这些文件时（装在你本机的自托管 Runner），Agent 直接读取 `~/.claude/CLAUDE.md`、各仓库的 `CLAUDE.md` / `AGENTS.md`、`.cursor/rules`、记忆库等；否则（云端沙箱或装在另一台机器上）Agent 给你两段通用提示词，你在本地工具里运行后把结果粘贴 / 上传回来。导入内容按其性质分流：运维 / 服务知识写入知识库文件，个人偏好 / 可复用习惯写入 Agent 记忆，重复或无用的则丢弃。所有导入内容在预览或写入前都会先做**密钥脱敏**，密钥永远不会落盘。
  </Accordion>

  <Accordion title="阶段 2 — 归纳与校正" icon="circle-check">
    Agent 用一段话回述它看到的画面：「我看到 N 个渠道、近 30 天 M 个故障、你似乎在用 \[列表]、高频标签包括 \[列表]。对吗？还缺什么？」等你确认或纠正，**此时还不写入任何文件**。
  </Accordion>

  <Accordion title="阶段 3–7 — 主题逐项采集" icon="layer-group">
    按主题逐阶段采集并成文，每一阶段都遵循「采集 → 草拟文件 → 出清单预览 → 你确认 → 写入并更新 DUTY.md 目录」：

    | 阶段 | 主题         | 产出                                         |
    | -- | ---------- | ------------------------------------------ |
    | 3  | 服务与拓扑      | `services.md`（+ 可选 `topology.md`）          |
    | 4  | 可观测性栈      | `observability.md` + 在 `tools.md` 登记相关 MCP |
    | 5  | 运行手册       | `runbooks/<主题>.md`，一类故障一文件                 |
    | 6  | 常见故障       | `common-failures.md`                       |
    | 7  | 集群访问与运行时探查 | `clusters.md`（k8s）/ 追加到 `tools.md`（MCP）    |

    <Note>
      阶段 7 中，**原生 kubectl 是首选的集群访问方式**，k8s-MCP 为兜底（同一集群二者不同时配置）。该路径仅适用于自托管 Runner：在 Runner 上为每个集群放置一份**只读** kubeconfig（`<工作区>/.kube/<名称>.config`），`clusters.md` 只记录其**路径**，绝不记录 token。
    </Note>
  </Accordion>

  <Accordion title="阶段 8 — 收尾" icon="flag-checkered">
    当你表示完成时，Agent 给出一段小结：本次创建/更新了哪些文件、登记了哪些 MCP，并提示「任何时候重跑 `/init` 都能继续」。知识库本身就是这次会话的持久成果。
  </Accordion>
</AccordionGroup>

## 安全与同意

***

`/init` 会写知识、可能装 MCP、还会碰到凭证，因此同意与最小权限是它的硬性约束：

<AccordionGroup>
  <Accordion title="逐项显式同意" icon="hand">
    任何写入或安装都必须经你明确同意。每个采集阶段在写入文件前都会列出「将创建/更新哪些文件」的清单（每项配 3–5 行摘要），你点头后才执行——绝不会拿一句模糊的「好」直接触发写入。
  </Accordion>

  <Accordion title="凭证永不明文回显" icon="key">
    当你提供 token、密码、AK/SK 等敏感信息时，Agent 只确认「已记录（长度=N）」，绝不在对话里重复打印明文。
  </Accordion>

  <Accordion title="最小权限凭证" icon="lock">
    每当需要你提供或生成凭证（kubeconfig、云 AK/SK、数据库账号、API token），Agent 都会要求你按**只读 / 最小权限**来配置；在边界可机器校验时，它会先做一次只读边界检查再记录。
  </Accordion>

  <Accordion title="极简原则" icon="filter">
    不是所有信息都值得写进知识库。Agent 只写「缺了它，AI 在故障里会做出更糟决定」的内容——可有可无的细节不会被塞进去，避免知识库变臃肿。
  </Accordion>
</AccordionGroup>

## 产出什么

***

`/init` 的成果是一份可被后续每次会话自动加载的[知识库](/zh/ai-sre/knowledge)：

* **`DUTY.md`**——知识库的目录入口，只放一句话导引和一份 `@文件名` 链接清单，指向各主题文件；
* **主题文件**——`services.md`、`topology.md`、`observability.md`、`runbooks/<主题>.md`、`common-failures.md`、`clusters.md` 等，实质内容都在这里；
* **MCP 登记**（可选）——若访谈中接入了外部工具，会在 `tools.md` 记录并完成 MCP 服务器注册。

<Note>
  `/init` 的主要产出是**知识**，不是 Skill。它不会把内容存成 Skill，除非你明确要求。它也不会自动安装 Agent——这类资源目前需你在控制台手动添加。
</Note>

## /init 与 /insight：一对最佳实践

***

`/init` 和 [`/insight`](/zh/ai-sre/insight) 是运维知识「建立 → 打磨」闭环的两端：

<CardGroup cols={2}>
  <Card title="/init — 建底子" icon="seedling">
    从零把知识库搭起来：服务、拓扑、runbook、集群访问一次成体系地沉淀，让 Agent 一上来就懂你的系统。
  </Card>

  <Card title="/insight — 持续打磨" icon="gauge-high">
    回看近 30 天会话，找出反复粘贴的上下文、缺失的 runbook、用错的数据源，告诉你**下一步该往知识库里补什么**。
  </Card>
</CardGroup>

<Tip>
  推荐的节奏：先用 `/init` 打好底子，跑几次真实排障后再用 `/insight` 复盘，把它指出的摩擦补回知识库——必要时重跑 `/init` 做系统性整理。知识库越完善，AI SRE 越精准好用。
</Tip>

## 相关页面

***

<CardGroup cols={2}>
  <Card title="管理知识" icon="book" href="/zh/ai-sre/knowledge">
    `/init` 的产出落在这里——了解 DUTY.md 结构、文件约束，以及如何手动编辑与维护。
  </Card>

  <Card title="使用洞察" icon="gauge-high" href="/zh/ai-sre/insight">
    用 `/insight` 复盘会话、发现运维摩擦，指导你持续补全知识库。
  </Card>

  <Card title="MCP（外部工具）" icon="plug" href="/zh/ai-sre/mcp">
    `/init` 可在访谈中帮你接入的外部工具，了解 MCP 的连接与管理。
  </Card>
</CardGroup>