mindos-zh

Category: Docs & Knowledge | Uploader: GeminiLight | Downloads: 0 | Version: v1.0（Latest）

MindOS 知识库中文操作指南，仅用于 MindOS 知识库内的 Agent 任务。说明核心概念：空间（按思维方式划分的知识分区）、指令（全 Agent 遵守的规则，常见为 INSTRUCTION.md）、技能（通过 SKILL.md 等教 Agent 如何读写整理知识库）。笔记可以承载指令与技能。仅当操作目标是 MindOS 知识库目录下的文件时触发，典型请求包括"更新笔记""搜索知识库" "整理文件""执行 SOP""按团队标准 review""把任务交接给另一个 Agent""同步决策" "追加 CSV""复盘这段对话""提炼关键经验""把复盘结果自适应更新到对应文档" "把这些信息路由到对应文件""同步更新所有相关文档"等。不触发：操作目标是本地代码仓库文件（如 /code/xxx/wiki/*.md）、用户给出的是绝对路径且不在 MindOS mindRoot 下、或任务是修改项目源码/文档。 --- # MindOS Skill 按以下规则执行用户任务。用户个性化规则（`user-skill-rules.md`）在 bootstrap 上下文中自动包含（若文件存在）。用户规则在冲突时覆盖默认规则。 ---  # MindOS 操作规则 ## MindOS 核心概念与知识库和接入 Agent 共用的术语说明： - **空间（Space）** — 按你的思维方式组织的知识分区。你怎么想，就怎么分，AI Agent 遵循同样的结构来自动读写和管理。 - **指令（Instruction）** — 一份所有 AI Agent 都遵守的规则文件。你写一次边界，每个连接到知识库的 Agent 都会照做。 - **技能（Skill）** — 教 Agent 如何操作你的知识库——读取、写入、整理。Agent 不是瞎猜，而是按你安装的 Skill 来执行。 **笔记即指令 / 技能** — 指令与技能在知识库里通常体现为 Markdown 文件（例如根或目录下的 `INSTRUCTION.md`、技能目录中的 `SKILL.md`）。笔记不只是随笔：可以是 Agent 必须遵守的治理层（指令），也可以是 Agent 加载后按步骤执行的程序包（技能）。 ## 核心原则 - 以仓库当前状态为唯一依据。 - **bootstrap 加载的目录树是一等语义资产。** 目录名、文件名及其层级结构编码了用户存了什么、如何组织思维。在调用搜索之前，先从这个结构推断内容位置——它往往不需要任何工具调用就能告诉你答案。 - 写入前先读取。 - 优先最小化、精确化修改。 - 变更结果应易于审阅与追踪。 ## 启动协议在进行实质编辑前执行以下流程： 1. 加载根级规则。 - 优先调用 `mindos_bootstrap`。 - 若不可用，直接读取根 `INSTRUCTION.md` 与根 `README.md`。 2. 动态发现当前结构。 - 使用 `mindos_list_spaces`（顶层分区与 README 摘要）、`mindos_list_files` 与按需 `mindos_search_notes`。 - 不假设固定一级目录名。 3. 加载目标路径附近的局部规则。 - 若存在，读取就近 `README.md` / `INSTRUCTION.md`。 - 优先遵循局部约定，而非全局假设。 4. 匹配已有 SOP。 - 若任务是流程性的（多步骤、可重复、或匹配已知工作流类别）：用任务关键词搜索 Workflows/ 目录 `mindos_search_notes(scope: "Workflows/")`。 - 若找到匹配的 SOP，读取并按其步骤执行（按需调整）。 - 若 SOP 步骤与实际执行产生偏差，任务完成后提议更新该 SOP。 5. 再执行编辑。若关键上下文缺失，按最佳努力继续，并明确写出假设。 ## 动态结构规则 - 不硬编码"标准目录树"。 - 创建或重写内容前，先从相邻文件推断约定。 - 命名、标题结构、CSV 字段顺序、引用格式均优先复用现有模式。 - 新建文件优先跟随同级风格，不引入新标准。 - **除非用户明确要求，不在根目录下创建文件或子目录。** 根目录仅保留顶层治理文件（README、INSTRUCTION、CONFIG）。新内容应放在语义最匹配的现有子目录下，从上下文中的目录树推断合适位置。 - 创建新文件或目录时，先根据现有结构确定最佳父目录。若没有明显匹配的目录，提出 1-2 个候选位置并询问用户后再创建。 - **文件增删/移动/重命名后，必须同步更新受影响的 README 文件。** README 是目录的索引与导航入口，任何改变目录内

Changelog: Source: GitHub https://github.com/GeminiLight/MindOS

Directory Structure

Current level: Root

📁 references/
- 📄 post-task-hooks.md 2.2 KB
- 📄 preference-capture.md 1.3 KB
- 📄 README.md 517 B
- 📄 sop-template.md 3.4 KB
📄 SKILL.md 15.6 KB

SKILL.md

---
name: mindos-zh
description: >
  MindOS 知识库中文操作指南，仅用于 MindOS 知识库内的 Agent 任务。
  说明核心概念：空间（按思维方式划分的知识分区）、指令（全 Agent 遵守的规则，常见为 INSTRUCTION.md）、
  技能（通过 SKILL.md 等教 Agent 如何读写整理知识库）。笔记可以承载指令与技能。
  仅当操作目标是 MindOS 知识库目录下的文件时触发，典型请求包括"更新笔记""搜索知识库"
  "整理文件""执行 SOP""按团队标准 review""把任务交接给另一个 Agent""同步决策"
  "追加 CSV""复盘这段对话""提炼关键经验""把复盘结果自适应更新到对应文档"
  "把这些信息路由到对应文件""同步更新所有相关文档"等。
  不触发：操作目标是本地代码仓库文件（如 /code/xxx/wiki/*.md）、
  用户给出的是绝对路径且不在 MindOS mindRoot 下、或任务是修改项目源码/文档。
---

# MindOS Skill

按以下规则执行用户任务。
用户个性化规则（`user-skill-rules.md`）在 bootstrap 上下文中自动包含（若文件存在）。
用户规则在冲突时覆盖默认规则。

---

<!-- version: 1.2.0 -->
# MindOS 操作规则

## MindOS 核心概念

与知识库和接入 Agent 共用的术语说明：

- **空间（Space）** — 按你的思维方式组织的知识分区。你怎么想，就怎么分，AI Agent 遵循同样的结构来自动读写和管理。
- **指令（Instruction）** — 一份所有 AI Agent 都遵守的规则文件。你写一次边界，每个连接到知识库的 Agent 都会照做。
- **技能（Skill）** — 教 Agent 如何操作你的知识库——读取、写入、整理。Agent 不是瞎猜，而是按你安装的 Skill 来执行。

**笔记即指令 / 技能** — 指令与技能在知识库里通常体现为 Markdown 文件（例如根或目录下的 `INSTRUCTION.md`、技能目录中的 `SKILL.md`）。笔记不只是随笔：可以是 Agent 必须遵守的治理层（指令），也可以是 Agent 加载后按步骤执行的程序包（技能）。

## 核心原则

- 以仓库当前状态为唯一依据。
- **bootstrap 加载的目录树是一等语义资产。** 目录名、文件名及其层级结构编码了用户存了什么、如何组织思维。在调用搜索之前，先从这个结构推断内容位置——它往往不需要任何工具调用就能告诉你答案。
- 写入前先读取。
- 优先最小化、精确化修改。
- 变更结果应易于审阅与追踪。

## 启动协议

在进行实质编辑前执行以下流程：

1. 加载根级规则。
- 优先调用 `mindos_bootstrap`。
- 若不可用，直接读取根 `INSTRUCTION.md` 与根 `README.md`。

2. 动态发现当前结构。
- 使用 `mindos_list_spaces`（顶层分区与 README 摘要）、`mindos_list_files` 与按需 `mindos_search_notes`。
- 不假设固定一级目录名。

3. 加载目标路径附近的局部规则。
- 若存在，读取就近 `README.md` / `INSTRUCTION.md`。
- 优先遵循局部约定，而非全局假设。

4. 匹配已有 SOP。
- 若任务是流程性的（多步骤、可重复、或匹配已知工作流类别）：
  用任务关键词搜索 Workflows/ 目录 `mindos_search_notes(scope: "Workflows/")`。
- 若找到匹配的 SOP，读取并按其步骤执行（按需调整）。
- 若 SOP 步骤与实际执行产生偏差，任务完成后提议更新该 SOP。

5. 再执行编辑。

若关键上下文缺失，按最佳努力继续，并明确写出假设。

## 动态结构规则

- 不硬编码"标准目录树"。
- 创建或重写内容前，先从相邻文件推断约定。
- 命名、标题结构、CSV 字段顺序、引用格式均优先复用现有模式。
- 新建文件优先跟随同级风格，不引入新标准。
- **除非用户明确要求，不在根目录下创建文件或子目录。** 根目录仅保留顶层治理文件（README、INSTRUCTION、CONFIG）。新内容应放在语义最匹配的现有子目录下，从上下文中的目录树推断合适位置。
- 创建新文件或目录时，先根据现有结构确定最佳父目录。若没有明显匹配的目录，提出 1-2 个候选位置并询问用户后再创建。
- **文件增删/移动/重命名后，必须同步更新受影响的 README 文件。** README 是目录的索引与导航入口，任何改变目录内容的操作都应自动检查并更新对应目录及其父目录的 README。

## 写前检查清单

在任何非 trivial 写入前，确认以下检查项：

1. 目标文件或路径已确认，且存在或应当创建。
2. **目标位置在合适的子目录下，而非根目录。** 若不确定哪个目录最合适，先提出候选并询问用户。
3. 现有内容已读取，或已明确确认不存在。
4. 已考虑目标路径附近的治理文档。
5. 修改范围最小化，且与用户意图一致。
6. 路径变更带来的引用/反链影响已评估。

## 工具选型指南

### 发现

- `mindos_bootstrap`：加载启动上下文。
- `mindos_list_files`：查看文件树。
- `mindos_list_spaces`：列出顶层心智空间及 README 摘要（比整棵树更轻）。
- `mindos_search_notes`：按关键词/范围/类型/日期定位文件。**搜索时，第一次就应并行发起多个关键词搜索**——同义词、缩写、中英文变体、更宽/更窄的表述。单一关键词很脆弱，一开始就撒网能避免多轮空搜。
- `mindos_get_recent`：查看近期活动。
- `mindos_get_backlinks`：重命名/移动/删除前评估影响。

### 读写

- `mindos_read_file`：读取文件内容。
- `mindos_write_file`：仅在确需整文件替换时使用。
- `mindos_create_file`：创建 `.md`/`.csv` 文件。
- `mindos_create_space`：新建心智空间（目录 + README + INSTRUCTION 脚手架）。新增整块分区时优先于只建 `某空间/README.md`。
- `mindos_rename_space`：重命名空间目录（文件夹）。不能用 `rename_file` 重命名目录。
- `mindos_delete_file`：仅在用户明确意图下删除。
- `mindos_rename_file`、`mindos_move_file`：结构变更后补做引用检查。

### 精确编辑

- `mindos_read_lines`：定位精确行。
- `mindos_insert_lines`：按索引插入。
- `mindos_update_lines`：替换指定行区间。
- `mindos_append_to_file`：文件末尾追加。
- `mindos_insert_after_heading`：标题后插入。
- `mindos_update_section`：替换单个 Markdown 章节。

### 历史与表格

- `mindos_get_history`、`mindos_get_file_at_version`：追踪/回溯历史。
- `mindos_append_csv`：读表头校验后追加单行。

## 回退规则

- 若部分 `mindos_*` 工具不可用，使用可用等效工具，但保持同样安全纪律。
- 若 `mindos_bootstrap` 不可用，改为手动读取启动文件。
- 若缺少行级/章节级工具，用"读取 + 受限重写"方式模拟最小化修改。
- 若 `mindos_search_notes` 无结果，不要放弃。bootstrap 时加载的目录树已经在你的上下文中。逐步升级：
  1. 先回顾上下文中已有的目录结构，根据命名、层级与主题相关性推断哪些目录和文件最可能相关。
  2. 直接读取最可能的候选文件确认内容。
  3. 若候选不明确，对特定子目录调用 `mindos_list_files` 获取更细粒度结构。
  4. 同时尝试替代关键词（同义词、更宽/更窄范围、中英文变体）作为并行策略。

## 安全规则

- 默认将根级 `INSTRUCTION.md`、根级 `README.md` 和其他目录下的 `INSTRUCTION.md` 治理文档视为高敏感，先确认再改。
- 执行高影响动作前先确认（批量删除、大规模重命名/移动、目录大重构、跨文件批量重写）。
- **当操作涉及多个文件时，必须先向用户展示完整的变更计划。** 列出每个目标文件、将做什么修改、为什么。等用户确认后再执行。
- 不写入密钥、Token、密码。
- 不执行超出用户意图的删除或覆写。

## 质量闸门

在结束任何操作前确认：

1. 结果直接回应用户意图。
2. 新增或修改内容符合局部风格与结构。
3. 结构调整后引用/链接仍有效。
4. 未引入敏感信息。
5. 给用户的总结足够具体，便于快速审计。

## 偏好捕获

### 何时捕获
用户在操作过程中表达偏好修正（如"以后不要…""下次记得…""这个应该放在…而不是…"）。

### 确认后写入流程
1. **某类偏好首次出现**：先提议，用户确认后再写入。
   - "记录此偏好到 `user-skill-rules.md`？规则：_{摘要}_"
   - 仅在用户确认后写入。
2. **同类偏好确认 3 次以上**：该类别标记 `auto-confirm: true`，后续同类偏好自动写入，不再询问。
3. **用户明确授权**（如"偏好直接记就行"）：设置顶层 `auto-confirm-all: true`，所有偏好跳过确认直接写入。

### 文件位置
- 目标：知识库根目录的 `user-skill-rules.md`（`mindos_bootstrap` 启动时自动读取）。
- 若文件不存在，在首次确认写入时按以下模板创建。

### 文件模板
```markdown
# User Skill Rules
<!-- auto-confirm-all: false -->

## Preferences
<!-- 按类别分组。确认 3 次以上的类别标记 auto-confirm: true。 -->

## Suppressed Hooks
<!-- 列出用户已关闭的 Post-Task Hooks。 -->
```

### 规则格式
每条规则以列表项写在对应类别下：
```markdown
### {类别名}
<!-- auto-confirm: false -->
- {规则描述} — _{记录日期}_
```

---

# 执行模式

选择匹配的模式。所有模式共享统一纪律：搜索 → 读取 → 最小化编辑 → 验证 → 总结。

## 核心模式（高频）

### 记录或更新笔记
搜索 → 读取目标 + 局部规则 → 最小化修改 → 路径变化时保持引用一致。

### 基于上下文的问答
从目录树推断 → 读取相关文件 → 基于存储内容回答并注明来源 → 信息缺失时明确告知。

### 结构感知的多文件联动更新
处理非结构化输入（会议纪要、braindump、聊天记录）分属多文件的场景：
1. 将输入解析为语义单元（事实、决策、行动项、想法等）。
2. 为每个单元搜索 + 读取候选目标文件。
3. **写入前向用户展示路由计划（表格：信息 → 目标文件 → 写入位置）并请求确认。**
4. 执行最小化编辑。仅当无匹配文件时才新建。
5. 汇总所有变更供审计。

### 对话复盘与自适应更新
1. 先让用户确认复盘范围。
2. 抽取可复用资产：决策、理由、踩坑、下一步动作。
3. 路由到最合适的现有文件（或在相邻位置新建）。
4. 补变更说明。路由置信度低时先问用户。

## 结构变更模式（文件增删/移动/重命名后必须执行）

- **重命名/移动**：`get_backlinks` → 报告影响 → 确认 → 执行 → 更新所有引用 → 验证无孤链。
- **同步 README**：任何结构变更后，自动更新受影响目录及父目录的 README。无需用户单独请求。

## 参考模式（任务匹配时使用）

| 模式 | 关键步骤 |
|------|----------|
| CSV 操作 | 读表头 → 校验字段 → 追加行 |
| TODO/任务管理 | 定位列表 → 读取格式 → 最小化编辑保持约定 |
| SOP/工作流执行 | 完整读取 → 分步执行 → 仅更新过时章节 |
| 跨 Agent 接力 | 读任务状态+决策 → 无需重复探索直接接续 → 回写进度 |
| 知识冲突联动 | 多关键词搜索旧信息 → 列出受影响文件 → 展示变更计划 → 确认后更新 |
| 经验提炼 SOP | 提取步骤 → 泛化 → 在 Workflows/ 下按 **SOP 模板**（见下方）创建，包含关键词元数据、适用场景、分支步骤、退出条件和踩坑记录 |
| 周期性回顾 | `get_recent`/`get_history` → 读变动文件 → 分类 → 结构化总结 |
| 交接文档合成 | 识别来源 → 读取 → 合成（背景、决策、状态、待办）→ 放项目目录 |
| 关系维护与跟进 | 从纪要提取更新 → 更新联系人记录 → 生成跟进策略 |
| 信息收集与外联 | 定位来源 → 读外联文档 → 按画像个性化 → 回写结果 |
| 项目启动 | 读偏好/技术栈 → 脚手架对齐标准 → 记录决策 |
| 代码审查 | 读审查规范 → 检查命名/安全/性能 → 输出可执行建议 |
| 沉淀跨 Agent 讨论 | 与用户确认决策 → 结构化为问题/决策/理由/下一步 → 最小化写回 |

### SOP 模板

通过"经验提炼 SOP"创建新 SOP 时，文件**必须**遵循以下结构：

```markdown
# SOP: {标题}
<!-- keywords: {3-5 个触发关键词，中英文} -->
<!-- last-used: {ISO date} -->
<!-- created: {ISO date} -->

## 适用场景
什么情况下该用这个 SOP。列出触发条件和前置依赖。

## 步骤
每步包含：
1. **做什么** — 具体操作
2. **判断分支** — 遇到 X 走 A，遇到 Y 走 B（无分支则标注"无"）
3. **失败处理** — 这步可能失败的情况和应对

## 退出条件
什么时候算完成，什么时候该放弃或升级。

## 踩坑记录
已知的边界 case 和教训。每次执行遇到新坑时追加。
```

元数据规则：
- `keywords` — 供启动协议步骤 4 的 SOP 召回搜索使用。同时包含中英文关键词。
- `last-used` — 每次按 SOP 执行后更新为当天日期。
- `created` — 创建时设置一次。

## 交互规则

- **当请求模糊或范围过大时（如"帮我整理一下"），先问清楚再动手。** 基于知识库现状（近期变动、目录结构）提出具体选项，但不要在理解用户意图和范围之前就开始重组或重写。
- 展示搜索结果或选项时，优先简洁和相关性，最可能的匹配排前面。
- 从存储内容回答问题时，始终注明来源文件路径，便于用户验证。

---

# 任务后 Hooks

任务完成后检查以下条件。命中则用一句话提议，不命中则安静结束。

## 纪律

1. 简单操作（改标题、追加一行、读取查询）完成后不提议
2. 每次最多 1 个提议，选优先级最高的
3. 一句话 + 具体目标。用户说"好"再展开
4. 检查 user-skill-rules.md 抑制区域，命中则跳过

## 默认 Hooks

### 经验沉淀（优先级：高）
- 条件：任务涉及调试、排错、踩坑，或找了多轮才解决
- 提议："要把这个经验记到 {相关经验文件} 吗？"
- 执行：问题 → 原因 → 解决 → 规则

### 一致性同步（优先级：高）
- 条件：编辑了文件 A，A 被其他文件引用（通过 get_backlinks 检查）
- 提议："{B} 引用了刚改的内容，要同步更新吗？"

### 联动更新（优先级：中）
- 条件：修改了 CSV/TODO 条目状态，存在关联文档
- 提议："{关联文档} 的对应信息要同步吗？"

### 结构归类（优先级：中）
- 条件：创建了新文件在临时位置或收件箱
- 提议："要归类到 {推荐目录} 吗？"

### 模式提炼（优先级：低）
- 条件：当前会话中 3+ 次结构相似的操作
- 提议："这个操作重复了多次，要整理成 SOP 吗？"

### SOP 偏差（优先级：中）
- 条件：任务按已有 SOP 执行，但实际步骤与文档步骤产生偏差
- 提议："执行过程与 {SOP 文件} 有偏差，要更新这个 SOP 吗？"
- 动作：更新偏差步骤、追加新踩坑记录、将 `<!-- last-used: -->` 设为今天。

### 对话复盘（优先级：低）
- 条件：会话 >10 轮且涉及决策、权衡或经验教训
- 提议："这段对话有些决策值得沉淀，要做个复盘吗？"

## 用户自定义 Hooks

<!-- 在此追加你自己的 hooks，格式同上 -->
<!-- 示例：
### 周报素材收集（优先级：中）
- 条件：更新了 Project 相关文件
- 提议："要把这个变更记到本周周报素材吗？"
-->

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

mindos-zh

Directory Structure

SKILL.md

Report

Notice