Doc Setup — 文档设置

文档设置概述 将原始文档转换为可导航的、基于主题的知识库。本技能提取关键概念，将其结构化为编号文件，保留源链接，并创建可执行的步骤指南。

工作流 源文档 ↓

• MAP — 识别所有主题和子主题 ↓
• EXTRACT — 从原始源获取内容 ↓
• STRUCTURE — 组织为编号文件（00-index，01-topic，02-topic...） ↓
• SUMMARIZE — 提供简洁的解释和必要的逐字引用 ↓
• LINK — 始终引用原始源 URL ↓
• UPDATE — 标记为活文档以便于未来修订

核心能力

• 文档映射

在编写任何内容之前，映射完整的结构： 源：https://github.com/user/repo/tree/main/docs ↓ 识别的主题：

• 安装和设置
• 架构
• 配置
• 数据摄取
• 搜索和嵌入
• 技能和自动化
• MCP 和集成
• 评估和质量
• 安全和权限
• 实践指南

输出：00-index.md — 主索引，包含所有主题和文件引用。

• 主题提取

为每个主题创建一个编号文件：01-instalacao-e-setup.md，02-arquitetura.md，03-configuracao-operacao.md... 每个文件必须包含： 源归属（> 源：URL） 简洁的摘要（不是原始复制） 关键表/决策矩阵 适用的逐步命令 链接回原始文档

• 源链接规则

始终包含原始源：

源： github.com/user/repo/docs/INSTALL.md
提取： 2026-05-22

对于逐字引用：

源引用：
"大脑连接自己。每页写入提取实体引用..."
— 源

• 活文档标记

标记将被更新的文件： --- 状态： 🟢 活文档 — 更新源更改 最后同步： 2026-05-22 下次审查： 需要或源更新时

• 步骤式安装指南

在记录安装时，使用清单：

快速开始清单

• [ ] 步骤 1：安装依赖项
• [ ] 步骤 2：配置 API 密钥
• [ ] 步骤 3：初始化数据库
• [ ] 步骤 4：使用健康检查验证

验证：

命令 -- 验证 # 应该输出：✅ OK
文件命名约定
模式
用例
00-index.md
主索引，包含所有主题
01-topic-name.md
第一个主题（安装）
02-topic-name.md
第二个主题（架构）
NN-topic-name.md
第 N 个主题
规则：
两位数字前缀用于排序
小写字母和连字符
与用户首选语言（葡萄牙语或英语）匹配
目录结构
second-brain/
└── {项目名称}/
├── 00-index.md
├── 01-topic.md
├── 02-topic.md
└── ...
模板
索引模板（00-index.md）

markdown # {项目} - 文档组织

源： URL 主要
生成： {日期}
状态： 🟢 活文档

---

主题索引

#	文件	内容
00	00-index.md	本索引
01	01-{主题}.md	{描述}

--- _最后更新：{日期}

主题模板（NN-topic.md） # {N}. {主题标题}

源： URL 具体
提取： {日期}

---

{子主题 1}

{简洁的摘要}

{子子主题}

``bash # 相关命令 命令示例 决策表 选项 A 优点 缺点 _最后更新：{日期}

资源

references/

• workflow-patterns.md — 常见文档结构
• output-examples.md — 示例组织文档

scripts/

• validate_structure.py — 验证文件命名和索引完整性

重要注意事项

• 永远不要复制原始文档。 总结和结构化。
• 始终链接源。 每个声明都需要一个 URL。
• 使用表格进行比较。 比段落更容易扫描。
• 包含决策矩阵。 帮助用户在选项之间进行选择。
• 标记活文档。 文档会演变；标记它。
• 更喜欢葡萄牙语。 匹配用户的语言偏好。
• 保持 SKILL.md 精简。 将详细示例移动到 references/。

示例

示例 1：组织 GBrain 文档

用户请求： "映射 GBrain 文档" 结果：

• 00-index.md — 11 个主题映射
• 01-instalacao-e-setup.md — 安装路径、提供程序、配置
• 02-arquitetura.md — 拓扑、检索、自动链接
• ... 通过 10-guias-praticos.md

示例 2：组织 OpenClaw 配置

用户请求： "总结 OpenClaw 的所有配置" 结果：

• 00-indice.md — 29 个配置主题
• 01-gateway.md — 核心运行时设置
• 02-canais.md — 通道配置
• ... 通过 29-secrets-management.md`

--- 何时更新： 在以下情况下重新运行此技能： （1）源文档更改， （2）用户需要添加新主题， （3）安装步骤需要修订， （4）发布新配置选项。