@geminilight/mindos 0.5.56 → 0.5.58

package/skills/mindos/SKILL.md

@@ -2,6 +2,8 @@
 name: mindos
 description: >
   MindOS knowledge base operation guide, only for agent tasks on files inside the MindOS knowledge base.
+  Explains core concepts: Space (partitions by how you think), Instruction (agent-wide rules, often in INSTRUCTION.md),
+  Skill (how agents read/write/organize the KB via SKILL.md packages). Notes can embody Instructions and Skills.
   Trigger only when the target files are inside the MindOS knowledge base directory.
   Typical requests: "update notes", "search knowledge base", "organize files", "execute SOP",
   "review with our standards", "handoff to another agent", "sync decisions", "append CSV",
@@ -20,9 +22,19 @@ context automatically when present. User rules override default rules on conflic
 
 ---
 
-<!-- version: 1.1.0 -->
+<!-- version: 1.2.0 -->
 # MindOS Operating Rules
 
+## MindOS concepts
+
+Shared vocabulary for the knowledge base and connected agents:
+
+- **Space** — Knowledge partitions organized the way you think. You decide the structure, and AI agents follow it to read, write, and manage automatically.
+- **Instruction** — A rules file that all AI agents obey. You write the boundaries once, and every agent connected to your knowledge base follows them.
+- **Skill** — Teaches agents how to operate your knowledge base — reading, writing, organizing. Agents don't guess; they follow the skills you've installed.
+
+**Notes as Instruction and Skill** — Instructions and Skills are usually expressed as Markdown in your tree (e.g. root or directory `INSTRUCTION.md`, `SKILL.md` under a skill folder). A note is not only free-form text: it can be the governance layer agents must follow (Instruction) or a procedure package agents load to execute (Skill).
+
 ## Core Principles
 
 - Treat repository state as source of truth.
@@ -93,6 +105,8 @@ Before any non-trivial write, confirm all checks:
 - `mindos_read_file`: Read file content.
 - `mindos_write_file`: Use only for true full replacement.
 - `mindos_create_file`: Create `.md`/`.csv` files.
+- `mindos_create_space`: Create a Mind Space (directory + README + INSTRUCTION scaffold). Prefer over `create_file` when adding a new cognitive zone.
+- `mindos_rename_space`: Rename a Space folder (directory). Do not use `rename_file` for folders.
 - `mindos_delete_file`: Delete only with explicit user intent.
 - `mindos_rename_file`, `mindos_move_file`: Structural edits with follow-up reference checks.
 

package/skills/mindos-zh/SKILL.md

@@ -2,6 +2,8 @@
 name: mindos-zh
 description: >
   MindOS 知识库中文操作指南，仅用于 MindOS 知识库内的 Agent 任务。
+  说明核心概念：空间（按思维方式划分的知识分区）、指令（全 Agent 遵守的规则，常见为 INSTRUCTION.md）、
+  技能（通过 SKILL.md 等教 Agent 如何读写整理知识库）。笔记可以承载指令与技能。
   仅当操作目标是 MindOS 知识库目录下的文件时触发，典型请求包括"更新笔记""搜索知识库"
   "整理文件""执行 SOP""按团队标准 review""把任务交接给另一个 Agent""同步决策"
   "追加 CSV""复盘这段对话""提炼关键经验""把复盘结果自适应更新到对应文档"
@@ -18,9 +20,19 @@ description: >
 
 ---
 
-<!-- version: 1.1.0 -->
+<!-- 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 加载后按步骤执行的程序包（技能）。
+
 ## 核心原则
 
 - 以仓库当前状态为唯一依据。
@@ -91,6 +103,8 @@ description: >
 - `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`：结构变更后补做引用检查。