Skip to content

Commit f2a5a16

Browse files
webkuborclaude
webkubor
and
claude
committed
refactor: 精简入口文件，三层渐进加载
AGENTS.md: 从 40 行展开 → 20 行极简入口，只告诉 agent 去 router.md 快照区 router.md: 精简为 快照区 + 目录导航 + 别名速查，去掉展开内容 各 agent 配置: 统一指向 AGENTS.md 入口 启动流程：agent → AGENTS.md (20行) → router.md 快照区 (25行) → 按需读具体文件 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 929dcba commit f2a5a16

File tree

2 files changed

+65
-100
lines changed

2 files changed

+65
-100
lines changed

‎AGENTS.md‎

Lines changed: 22 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,33 @@
1-
# 🧠 CortexOS 助理接入指南 (Assistant Guide)
1+
# 🧠 CortexOS — 助理启动入口
22

3-
> **CortexOS 核心定位**: 这是一个专门为 **用户 (The User / Creator)** 量身定制的 **“大脑知识库”** 与 **“任务执行规则集”**。
4-
> 所有的 Agent (Gemini, Codex, Claude) 都应将此处视为 **SSOT (唯一真理源)**。
3+
> 你是用户的 AI 助理。开工前**按需读取**下面的步骤，不要一次全读。
54
6-
---
7-
8-
## 🚀 助理冷启动协议 (Cold Start Protocol)
9-
10-
作为用户的助理，你在任何时候开工前，**必须且仅须** 执行以下三步：
5+
## Step 1：快速同步（必做，<20行）
116

12-
1. **读取路由**: `get_context_brief()` (极简摘要) -> `read_router()` (全量协议)。
13-
2. **对齐状态**: 了解当前大脑的版本、用户的最新战略意图。
14-
3. **获取任务**: 如果你支持多 Agent 协同，请从外部调度引擎（如 `AetherFleet`）获取你的具体 `task_id`。
7+
读 `docs/router.md` 的 **"🧠 快照区"** 部分（约 30 行），了解：
8+
- 大脑版本
9+
- 用户当前状态
10+
- 你该做什么
1511

12+
## Step 2：按需深入（只在需要时读）
1613

17-
---
14+
| 如果你要做... | 读这个文件 |
15+
|---|---|
16+
| 了解行为规范 | `docs/rules/engineering_baseline.md` |
17+
| 发推 / 发小红书 | `docs/sops/` 下对应 SOP |
18+
| 了解用户偏好 | `.memory/persona/` |
19+
| 看过去做了什么 | `.memory/logs/` |
20+
| AetherFleet 任务 | `AetherFleet/.memory/plans/projects/` |
1821

19-
## 📚 知识分层架构 (Knowledge Layers)
22+
## Step 3：开工
2023

21-
| 目录 | 角色 | 用途 |
22-
| :--- | :--- | :--- |
23-
| **`docs/rules/`** | **律法 (Laws)** | 绝对禁止的行为、工程规范、安全边界。 |
24-
| **`docs/sops/`** | **教条 (SOPs)** | 具体的任务执行步骤（如何发推、如何发布）。 |
25-
| **`.memory/persona/`** | **灵魂 (Soul)** | 助理的人格调教、老爹的个人偏好、重试模式。 |
26-
| **`.memory/logs/`** | **轨迹 (Traces)** | 过去执行的详细记录，用于提取进化经验。 |
24+
读完上面该读的就开工。不要为了"了解系统"而读一堆文件。
2725

2826
---
2927

30-
## 🛠 核心工具链 (Core Toolsets)
31-
32-
CortexOS 通过 MCP (Model Context Protocol) 暴露以下核心能力：
33-
34-
- **`read_router()`**: 读取最高协议。
35-
- **`get_context_brief()`**: 快速同步当前大脑状态。
36-
- **`search_knowledge()`**: 在老爹的本地知识库中进行语义检索。
37-
- **`load_rule("<name>")`**: 按需加载特定规则文件（省 Token）。
38-
- **`log_task()`**: 记录你当下的工程轨迹。
28+
**不要做的事：**
29+
- ❌ 不要一次读完所有 docs/rules/
30+
- ❌ 不要读 .memory/logs/ 除非需要查历史
31+
- ❌ 不要把配置文件当文档通读
3932

40-
---
41-
42-
## ⚠️ 禁令与红线 (The Red Lines)
43-
44-
- ❌ **禁止直接操作舰队调度**: 任务认领、状态上报已剥离至 `aetherfleet-engine`。
45-
- ❌ **禁止污染用户记忆**: 任何非资产性的日志，严禁进入 `~/Documents/memory/`。
46-
- ✅ **优先使用共享技能**: 所有跨 Agent 通用工具，必须存放在 `~/.agents/skills/`。
47-
48-
---
49-
*Last Updated: 2026-03-17 | 大脑版本: v6.0.0 (Pure Brain Mode)*
33+
**记住：** 先干活，遇到问题再查对应文件。

‎docs/router.md‎

Lines changed: 43 additions & 62 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,58 @@
11
---
2-
description: 大脑最高协议与知识路由 (Pure Brain Mode)。
2+
description: CortexOS 大脑路由（精简版）
33
---
4-
# CortexOS Brain Router (Universal Protocol)
54

6-
> 🧠 **本文件是 CortexOS 大脑的唯一入口。** 任何助理助理开工前必读。
5+
# 🧠 CortexOS Brain Router
76

8-
## 0. 助理信条 (The Assistant Creed)
9-
... (保持不变)
7+
## 🧠 快照区（每次必读，约 25 行）
108

11-
## 1. 别名映射 (Shortcuts Map) - [New: Token Optimizer]
9+
```
10+
大脑版本: v6.0.0 (Pure Brain Mode)
11+
用户: 王爷 | 对外 ID: webkubor
12+
时区: Asia/Shanghai (UTC+8)
13+
工作时间: ~10:00-20:00
1214
13-
| 别名 | 映射路径 | 业务含义 |
14-
| :--- | :--- | :--- |
15-
| **`@fe/std`** | `docs/rules/frontend/standard.md` | 前端 200/500/8 硬约束准则 |
16-
| **`@fe/base`** | `docs/rules/frontend/baseline.md` | 前端 Vue3/Vite/TS 技术基线 |
17-
| **`@fe/rev`** | `docs/rules/frontend/templates/review.md` | 代码审查输出模板 (Findings-First) |
18-
| **`@fe/cmt`** | `docs/rules/frontend/templates/comment.md` | 函数/组件注释规范模板 |
19-
| **`@fe/rel`** | `docs/rules/frontend/templates/release.md` | 版本发布记录模板 (Changelog) |
20-
| **`@core`** | `docs/rules/engineering_baseline.md` | 核心工程准则 (Safety & Security) |
15+
当前重点:
16+
- 沸腾之雪 AI 武侠微电影（正片 1-9 集完结）
17+
- 小红书运营：司南烛(主号 654 粉) + 小烛(新号)
18+
- nanobanana-plus v1.5.0 已发布（HTTP API 模式）
19+
- AetherFleet 舰队调度系统
20+
- 氛围壁纸工坊 https://wallpaper.webkubor.online/
2121
22-
---
23-
24-
## 2. 大脑目录分层 (Brain Architecture)
25-
... (保持不变)
26-
27-
1. **极简快照**: `get_context_brief()` (获取大脑最新动态、用户近期意图)。
28-
2. **完整对齐**: `read_router()` (了解最新规则、目录结构、禁令)。
29-
3. **任务上下文**: 关联外部调度系统（如 `AetherFleet`）或用户直接指派。
30-
31-
---
32-
33-
## 2. 大脑目录分层 (Brain Architecture)
34-
35-
| 层级 | 路径 | 归属 | 核心职能 |
36-
| :--- | :--- | :--- | :--- |
37-
| **规则层 (Rules)** | `docs/rules/` | 大脑主权 | 提供禁令、规范、工程基线。 |
38-
| **操作层 (SOPs)** | `docs/sops/` | 大脑方案 | 提供特定场景的“标准执行步骤”。 |
39-
| **逻辑层 (Refined)** | `.memory/sqlite/knowledge.db` | 大脑右脑 | **[New]** 结构化存储栖洲的代码模式与架构决策。 |
40-
| **进化层 (Traces)** | `.memory/logs/` | 助理轨迹 | 记录执行过程，用于后期经验提取。 |
41-
| **灵魂层 (Soul)** | `.memory/persona/` | 助理人格 | 存放 `retry_patterns.md`、人格调教、用户偏好。 |
42-
| **知识层 (Assets)** | `~/Documents/memory/` | 用户资产 | **只读** 用户长期记忆（复盘、笔记、灵感）。 |
22+
关键资源:
23+
- 私钥/凭证: ~/Documents/memory/secrets/ (chmod 600)
24+
- 项目路径: ~/Documents/CortexOS/
25+
- 舰队状态: AetherFleet/.memory/cache/
26+
- 个人记忆: ~/Documents/memory/
27+
- 助手日志: ~/clawd/memory/
28+
```
4329

44-
---
45-
46-
## 3. 动态大脑切换 (Brain Switching Protocol)
30+
## 📂 目录导航（按需读取）
4731

48-
> 💡 **CortexOS 支持多套“大脑”快速切换。**
32+
| 路径 | 用途 | 何时读 |
33+
|---|---|---|
34+
| `docs/rules/` | 行为规范、安全红线 | 开始修改代码前 |
35+
| `docs/sops/` | 具体操作步骤 | 发推/发小红书/发布前 |
36+
| `.memory/persona/` | 用户偏好、助手人格 | 首次使用或忘了偏好时 |
37+
| `.memory/logs/` | 过往执行记录 | 查历史问题 |
38+
| `AetherFleet/` | AI 航队调度 | 有 AetherFleet 任务时 |
4939

50-
- **当前大脑**: `CortexOS` (默认通用助理大脑)。
51-
- **双引擎驱动**: 语义检索 (ChromaDB) + 逻辑检索 (SQLite)。
52-
- **切换指令**: 使用 `scripts/core/switch_brain.py <name>`。
40+
## 🏷️ 别名速查
5341

54-
---
42+
| 别名 | 映射 | 用途 |
43+
|---|---|---|
44+
| `@fe/std` | `docs/rules/frontend/standard.md` | 前端规范 |
45+
| `@fe/base` | `docs/rules/frontend/baseline.md` | Vue3/Vite/TS 基线 |
46+
| `@core` | `docs/rules/engineering_baseline.md` | 核心工程准则 |
5547

56-
## 4. 核心工具协议 (Core MCP Tools)
48+
## 🔧 核心工具
5749

58-
| 工具 | 协议说明 |
59-
| :--- | :--- |
60-
| **`read_router`** | 返回本协议内容。 |
61-
| **`get_context_brief`** | 返回大脑状态摘要（含当前活跃大脑）。 |
62-
| **`search_knowledge`** | **[RAG]** 在用户知识资产中进行语义检索。 |
63-
| **`get_refined_logic`** | **[Logic]** 检索结构化的代码模式与硬约束（来自 knowledge.db）。 |
64-
| **`load_rule`** | **[Lazy Load]** 按名称精确加载规则文件。 |
65-
| **`log_task`** | 记录执行轨迹，支持 `[[task-XXX]]` 双链。 |
66-
| **`log_relationship`** | **[关系记忆]** 将有情感价值的事件沉淀到 `.memory/persona/relationship.md`（私有，绝不 git）。每次会话结束前必须调用。 |
50+
- MCP Server: `mcp_server/server.py`（14 个工具）
51+
- 舰队引擎: `AetherFleet`
52+
- AI 舰队: Gemini / Codex / Claude / Kimi
6753

68-
---
54+
## 🚫 红线
6955

70-
## 5. 禁令与边界 (Red Lines)
71-
72-
- ❌ **严禁写回用户资产**: 助理产生的中间过程文件、日志，严禁直接写入用户记忆目录，应保存在 `.memory/logs/`。
73-
- ❌ **严禁冗余调度**: CortexOS 不再承接任务打卡，任何相关修改应向 `AetherFleet` 提交。
74-
- ✅ **唯一真理源 (SSOT)**: 所有的工程规则以 `docs/rules/engineering_baseline.md` 为准。
75-
76-
---
77-
*Last Updated: 2026-03-17 | Version: v6.0.0 (Decoupled & Pure)*
56+
- 不直接操作舰队调度（交给 AetherFleet）
57+
- 不把敏感信息写回公开配置
58+
- 不一次读完所有规则（按需加载）

0 commit comments

Comments
 (0)