bobo-ai-cli 3.0.4 → 3.0.5

package/knowledge/advanced-patterns.md

@@ -1,70 +1,70 @@
-# 高级工程模式（源自 Claude Code 架构）
-
-## 记忆类型学（四类型）
-
-记忆不是什么都存的垃圾桶。只存**不能从当前项目状态推导出来**的信息。
-
-### 存什么
-| 类型 | 说明 | 示例 |
-|------|------|------|
-| user | 用户的角色、目标、偏好、知识水平 | "用户是高级后端工程师，第一次碰 React" |
-| feedback | 用户给的行为指导（纠正 + 确认） | "不要在这些测试里 mock 数据库" |
-| project | 进行中的工作、目标、截止日期 | "Q2 目标是把延迟降到 200ms 以下" |
-| reference | 不在代码中的外部知识 | "生产数据库在 us-east-1 的 RDS 上" |
-
-### 不存什么（NOT-to-save）
-- ❌ 代码模式/架构（grep 能查到）
-- ❌ Git 历史（git log 能看到）
-- ❌ 文件结构（ls/find 能列出）
-- ❌ 已在 CLAUDE.md/AGENTS.md 中的规则
-- ❌ 调试中间步骤（只存最终教训）
-- ❌ 一次性信息（临时状态）
-
-### feedback 记忆格式
-```
-规则本身
-**Why:** 用户为什么这么说（事故/偏好/上下文）
-**How to apply:** 在什么场景下应用
-```
-
-**关键**：不只记纠正，也记确认。只记纠正 = 过度谨慎 + 偏离已验证的方法。
-
-## Compact 九段式（详细版）
-
-对话过长时的压缩输出结构：
-
-1. **主要请求和意图** — 用户所有明确请求的详细描述
-2. **关键技术概念** — 讨论过的所有重要技术/框架/概念
-3. **文件和代码** — 检查/修改/创建的具体文件和代码段，包含完整代码片段
-4. **错误和修复** — 遇到的所有错误及修复方式，特别是用户反馈
-5. **问题解决** — 已解决的问题和进行中的排错
-6. **所有用户消息** — 列出所有非工具结果的用户消息（**关键！理解用户反馈和变化的意图**）
-7. **待办任务** — 明确被要求做的待办事项
-8. **当前工作** — 摘要请求前正在做什么（含文件名和代码片段）
-9. **下一步** — 与最近工作直接相关的下一步，附原文引用防止意图漂移
-
-## 背景记忆提取模式
-
-每轮对话结束后自动检查是否有值得记录的信息：
-1. 第一轮：并行读取所有可能需要更新的记忆文件
-2. 第二轮：并行写入所有更新
-3. 不要交错读写 — 效率优先
-
-## 子代理架构模式
-
-### 内置代理类型
-- **Explore Agent** — 轻量搜索模式，最少 token 完成调研
-- **Verification Agent** — 对抗性验证，尝试打破而不是确认
-- **Plan Agent** — 任务规划和分解
-
-### Coordinator 模式
-大任务的四阶段：
-1. **研究**（并行）— 多个子代理同时调研不同方面
-2. **综合**（自己）— 汇总研究结果
-3. **实现**（可并行）— 分配子任务
-4. **验证**（独立）— 独立代理验证结果
-
-### 并发安全
-- 扇出并行 / 扇入汇总
-- 读写分离（多读串写）
-- 依赖串行（有依赖的步骤不并行）
+# 高级工程模式（源自 Claude Code 架构）
+
+## 记忆类型学（四类型）
+
+记忆不是什么都存的垃圾桶。只存**不能从当前项目状态推导出来**的信息。
+
+### 存什么
+| 类型 | 说明 | 示例 |
+|------|------|------|
+| user | 用户的角色、目标、偏好、知识水平 | "用户是高级后端工程师，第一次碰 React" |
+| feedback | 用户给的行为指导（纠正 + 确认） | "不要在这些测试里 mock 数据库" |
+| project | 进行中的工作、目标、截止日期 | "Q2 目标是把延迟降到 200ms 以下" |
+| reference | 不在代码中的外部知识 | "生产数据库在 us-east-1 的 RDS 上" |
+
+### 不存什么（NOT-to-save）
+- ❌ 代码模式/架构（grep 能查到）
+- ❌ Git 历史（git log 能看到）
+- ❌ 文件结构（ls/find 能列出）
+- ❌ 已在 CLAUDE.md/AGENTS.md 中的规则
+- ❌ 调试中间步骤（只存最终教训）
+- ❌ 一次性信息（临时状态）
+
+### feedback 记忆格式
+```
+规则本身
+**Why:** 用户为什么这么说（事故/偏好/上下文）
+**How to apply:** 在什么场景下应用
+```
+
+**关键**：不只记纠正，也记确认。只记纠正 = 过度谨慎 + 偏离已验证的方法。
+
+## Compact 九段式（详细版）
+
+对话过长时的压缩输出结构：
+
+1. **主要请求和意图** — 用户所有明确请求的详细描述
+2. **关键技术概念** — 讨论过的所有重要技术/框架/概念
+3. **文件和代码** — 检查/修改/创建的具体文件和代码段，包含完整代码片段
+4. **错误和修复** — 遇到的所有错误及修复方式，特别是用户反馈
+5. **问题解决** — 已解决的问题和进行中的排错
+6. **所有用户消息** — 列出所有非工具结果的用户消息（**关键！理解用户反馈和变化的意图**）
+7. **待办任务** — 明确被要求做的待办事项
+8. **当前工作** — 摘要请求前正在做什么（含文件名和代码片段）
+9. **下一步** — 与最近工作直接相关的下一步，附原文引用防止意图漂移
+
+## 背景记忆提取模式
+
+每轮对话结束后自动检查是否有值得记录的信息：
+1. 第一轮：并行读取所有可能需要更新的记忆文件
+2. 第二轮：并行写入所有更新
+3. 不要交错读写 — 效率优先
+
+## 子代理架构模式
+
+### 内置代理类型
+- **Explore Agent** — 轻量搜索模式，最少 token 完成调研
+- **Verification Agent** — 对抗性验证，尝试打破而不是确认
+- **Plan Agent** — 任务规划和分解
+
+### Coordinator 模式
+大任务的四阶段：
+1. **研究**（并行）— 多个子代理同时调研不同方面
+2. **综合**（自己）— 汇总研究结果
+3. **实现**（可并行）— 分配子任务
+4. **验证**（独立）— 独立代理验证结果
+
+### 并发安全
+- 扇出并行 / 扇入汇总
+- 读写分离（多读串写）
+- 依赖串行（有依赖的步骤不并行）

package/knowledge/agent-directives.md

@@ -1,74 +1,74 @@
-# Agent Directives — 机械性覆盖规则
-
-在有限的上下文窗口和严格约束下，你必须遵守这些规则才能产出生产级代码。
-
-## 前置工作
-
-### 1. "第零步"规则
-死代码加速上下文衰减。对任何 >300 行的文件做结构性重构前，**先清理**：
-- 移除所有死代码（未使用的 props、exports、imports）
-- 移除 debug logs / console.log
-- **单独 commit 这次清理**，再开始真正的重构
-
-### 2. 分阶段执行
-**永远不要**在一次响应中做多文件重构。
-- 拆成明确的阶段
-- 每个阶段最多触碰 **5 个文件**
-- Phase 1 完成 → 验证 → 等待确认 → 才开始 Phase 2
-
-## 代码质量
-
-### 3. 高级开发者覆盖
-不要只做"最简单的方案"。如果发现：
-- 架构有缺陷 → 提出并实施结构性修复
-- 状态重复 → 统一
-- 模式不一致 → 对齐
-- 问自己："一个有经验的高级工程师在 code review 时会拒绝什么？" → 修掉它
-
-### 4. 强制验证
-工具标记文件写入成功 ≠ 代码正确。**禁止报告任务完成**除非：
-- 运行了 `npx tsc --noEmit`（或项目等效的类型检查）
-- 运行了 linter（如配置了）
-- **修复了所有错误**
-- 如果没有类型检查器，明确说明而不是假装成功
-
-## 上下文管理
-
-### 5. 子代理分群
-任务涉及 >5 个独立文件时，**必须**拆分为并行子任务。
-- 每个子任务 5-8 个文件
-- 串行处理大任务 = 保证上下文衰减
-
-### 6. 上下文衰减感知
-对话超过 **10 条消息**后：
-- **必须重新读取**任何要编辑的文件
-- 不要信任你对文件内容的记忆
-- 自动压缩可能已经静默销毁了上下文
-
-### 7. 文件读取预算
-- 每次文件读取上限 **2000 行**
-- 超过 500 行的文件 → 必须用 offset + limit 分段读取
-- **永远不要**假设一次 read 看到了完整文件
-
-### 8. 工具结果截断盲区
-- 超过 50000 字符的工具结果会被静默截断
-- 如果搜索/命令返回结果异常少 → 用更窄的范围重新搜索
-- 怀疑截断时明确说明
-
-## 编辑安全
-
-### 9. 编辑完整性
-- 每次编辑前 → **重新读取文件**
-- 编辑后 → **再读一次确认**变更正确应用
-- 不要对同一文件连续 batch 超过 3 次编辑而不验证读取
-- Edit 工具在 old_string 不匹配时会**静默失败**
-
-### 10. 无语义搜索
-你有 grep，没有 AST。重命名/修改任何函数/类型/变量时，**必须分别搜索**：
-- 直接调用和引用
-- 类型级引用（interfaces, generics）
-- 包含该名称的字符串字面量
-- 动态 import 和 require()
-- Re-exports 和 barrel file 条目
-- 测试文件和 mock
-→ **不要假设一次 grep 能捕获所有引用**
+# Agent Directives — 机械性覆盖规则
+
+在有限的上下文窗口和严格约束下，你必须遵守这些规则才能产出生产级代码。
+
+## 前置工作
+
+### 1. "第零步"规则
+死代码加速上下文衰减。对任何 >300 行的文件做结构性重构前，**先清理**：
+- 移除所有死代码（未使用的 props、exports、imports）
+- 移除 debug logs / console.log
+- **单独 commit 这次清理**，再开始真正的重构
+
+### 2. 分阶段执行
+**永远不要**在一次响应中做多文件重构。
+- 拆成明确的阶段
+- 每个阶段最多触碰 **5 个文件**
+- Phase 1 完成 → 验证 → 等待确认 → 才开始 Phase 2
+
+## 代码质量
+
+### 3. 高级开发者覆盖
+不要只做"最简单的方案"。如果发现：
+- 架构有缺陷 → 提出并实施结构性修复
+- 状态重复 → 统一
+- 模式不一致 → 对齐
+- 问自己："一个有经验的高级工程师在 code review 时会拒绝什么？" → 修掉它
+
+### 4. 强制验证
+工具标记文件写入成功 ≠ 代码正确。**禁止报告任务完成**除非：
+- 运行了 `npx tsc --noEmit`（或项目等效的类型检查）
+- 运行了 linter（如配置了）
+- **修复了所有错误**
+- 如果没有类型检查器，明确说明而不是假装成功
+
+## 上下文管理
+
+### 5. 子代理分群
+任务涉及 >5 个独立文件时，**必须**拆分为并行子任务。
+- 每个子任务 5-8 个文件
+- 串行处理大任务 = 保证上下文衰减
+
+### 6. 上下文衰减感知
+对话超过 **10 条消息**后：
+- **必须重新读取**任何要编辑的文件
+- 不要信任你对文件内容的记忆
+- 自动压缩可能已经静默销毁了上下文
+
+### 7. 文件读取预算
+- 每次文件读取上限 **2000 行**
+- 超过 500 行的文件 → 必须用 offset + limit 分段读取
+- **永远不要**假设一次 read 看到了完整文件
+
+### 8. 工具结果截断盲区
+- 超过 50000 字符的工具结果会被静默截断
+- 如果搜索/命令返回结果异常少 → 用更窄的范围重新搜索
+- 怀疑截断时明确说明
+
+## 编辑安全
+
+### 9. 编辑完整性
+- 每次编辑前 → **重新读取文件**
+- 编辑后 → **再读一次确认**变更正确应用
+- 不要对同一文件连续 batch 超过 3 次编辑而不验证读取
+- Edit 工具在 old_string 不匹配时会**静默失败**
+
+### 10. 无语义搜索
+你有 grep，没有 AST。重命名/修改任何函数/类型/变量时，**必须分别搜索**：
+- 直接调用和引用
+- 类型级引用（interfaces, generics）
+- 包含该名称的字符串字面量
+- 动态 import 和 require()
+- Re-exports 和 barrel file 条目
+- 测试文件和 mock
+→ **不要假设一次 grep 能捕获所有引用**

package/knowledge/api-integration-patterns.md

@@ -0,0 +1,102 @@
+# API 集成实战模式
+
+## RunningHub 平台
+
+### 三种执行路径
+| 路径 | 用途 | Endpoint |
+|------|------|----------|
+| 模板 + nodeInfoList | 标准工作流（换参数跑） | `POST /task/openapi/create` with `workflowId` |
+| AI App (webapp) | 封装好的应用（简化入参） | `POST /task/openapi/ai-app/run` with `webappId` |
+| Workspace setContent | ❌ 不可靠，不要用 | - |
+
+### 通用调用模式
+```python
+# 1. 上传素材
+upload_resp = POST /task/openapi/upload (multipart: apiKey + file)
+file_path = upload_resp["data"]["fileName"]  # "api/<hash>.<ext>"
+
+# 2. 创建任务
+create_resp = POST /task/openapi/create {
+    "apiKey": key,
+    "workflowId": "...",
+    "nodeInfoList": [{"nodeId": "85", "fieldName": "image", "fieldValue": file_path}]
+}
+task_id = create_resp["data"]["taskId"]
+
+# 3. 轮询状态（exponential backoff）
+status_resp = POST /task/openapi/status {"apiKey": key, "taskId": task_id}
+# QUEUING → GENERATING → SUCCESS/FAILED
+
+# 4. 获取输出
+outputs_resp = POST /task/openapi/outputs {"apiKey": key, "taskId": task_id}
+```
+
+### 关键注意
+- `fieldValue` 用上传返回的 `api/<hash>.<ext>` 整串，不要去前缀
+- payload 最精简就过，不加 `instanceType`/`usePersonalQueue` 等额外字段
+- 同 apiKey 同时 2 个 task 会排队（code 804），不是并行
+- 视频任务 ~17min/次，分钟级间隔才行
+
+## Modal gRPC API（历史数据拉取）
+
+### 关键发现
+CLI 只流实时，但 SDK 底层有完整历史 API：
+- `AppFetchLogsRequest(app_id, since, until, limit=1000, search_text=...)`
+- `AppCountLogsRequest(app_id, since, until, bucket_secs=3600)`
+- 分批游标：`max(timestamp) + 1us` 作下一批 since
+
+### 瞬时并发计算
+按 `function_call_id` 聚合 → 正则提 `task_cost_time` → 重建 (start, end) → 滑窗算重叠
+
+## Notion API
+
+### 文件上传限制
+- Integration bot token: 单文件 **20MB 上限**
+- 超过 → ffmpeg 重编码: `ffmpeg -i in.mp4 -vf scale=-2:832 -c:v libx264 -b:v 12M -c:a aac -b:a 128k out.mp4`
+- 批量绑定：同一 upload id 要绑定所有引用行（不只主行）
+
+### Database 操作
+- 用 `Bot_ID`（rich_text）精确匹配，不按名字（名字经常不同）
+- `multi_select` 字段：添加 tag 时保留已有 tags + append 新的
+- `data_source_id` 获取 schema（properties 在 page 级别已空）
+
+## Semrush SEO API
+
+### 双流并行（不可合并）
+1. `domain_organic` → 竞品长尾词（11 家竞品 Top 500）
+2. `phrase_these` → 热点大词种子扩展（新模型词 2025-2026）
+
+### 过滤规则
+- vol < 10K → 剔除
+- IP/明星名 → 2-3 word 纯字母无品类词启发式
+- 对手品牌/拼写错误 → NAV_BLACKLIST
+- 站内已有 → CMS canonical 去重（4 层: exact_core_kw / ai 前缀 / slug / token subset）
+
+### KD 策略
+- KD ≤60 → 开 landing bot
+- KD 60-80 → 对比教程/alternative 页
+- KD >80 → 周边工具吸相关流量
+
+## Base44 CMS
+
+### 查询命令
+```bash
+bash company-skills/base44/scripts/query.sh cms LandingPage list "environment=production-porn&limit=1000"
+```
+返回 `core_keyword + slug_id + bot_name` 用于站内去重。
+
+## MyShell Workshop API
+
+### Bot 创建（不需要 UI）
+```
+POST /shell_agent/api/app/v3/create {name, description, cover, nsfw, template_id:"", creator_name}
+→ app_id (UUID)
+```
+
+### 两阶段 ID
+- 阶段 1: `app_id` = UUID（开发版，workshop 内部用）
+- 阶段 2: `bot_id` = 整数（publish 后分配，线上用）
+- LP 只有 bot publish 后才应该建
+
+### 审核是自己人
+submit_review 后贴 workshop_url 给审核人（冲哥/bobooo/Amy），点通过 → 自动 publish → 分配 int bot_id。

package/knowledge/code-review-protocol.md

@@ -0,0 +1,69 @@
+# Code Review 结构化协议
+
+## 五维审查
+
+| 维度 | 关注点 |
+|------|--------|
+| Security | 注入/XSS/密钥泄露/权限绕过 |
+| Performance | N+1/大表扫/无缓存/阻塞主线程 |
+| Quality | 死代码/类型错位/未处理边界 |
+| Accessibility | 语义HTML/ARIA/键盘导航 |
+| AI Residuals | 硬编码/skip test/mock残留 |
+
+## AI Residuals 扫描
+
+| severity | 模式 | 判定 |
+|----------|------|------|
+| major | localhost/127.0.0.1 硬编码 | 1件即FAIL |
+| major | it.skip/describe.skip/test.skip | 1件即FAIL |
+| major | 硬编码密钥/token | 1件即FAIL |
+| major | dev/staging 固定URL | 1件即FAIL |
+| minor | mockData/dummy/fake 残留 | 标注不FAIL |
+| minor | TODO/FIXME 未处理 | 标注不FAIL |
+| recommendation | "temporary" 注释 | 建议清理 |
+
+## Verdict 规则
+
+- critical/major ≥1 → `REQUEST_CHANGES`
+- minor/recommendation only → `APPROVE`
+- 不因"改了更好"而 REQUEST_CHANGES
+
+## 输出格式
+```json
+{
+  "verdict": "APPROVE | REQUEST_CHANGES",
+  "observations": [
+    {
+      "severity": "major|minor|recommendation",
+      "category": "security|performance|quality|accessibility|ai-residuals",
+      "location": "file:line",
+      "issue": "问题描述",
+      "suggestion": "修复建议"
+    }
+  ]
+}
+```
+
+## Git Guard Rules
+
+| Rule | 动作 |
+|------|------|
+| `git push --force` / `-f` | 拒绝（无例外）|
+| `--no-verify` / `--no-gpg-sign` | 拒绝 |
+| `git reset --hard main/master` | 拒绝 |
+| 直推 main/master | 警告 |
+| 改 package.json/Dockerfile/CI | 警告 |
+
+## "第零步"规则
+
+对 >300 行文件做结构性重构前，先清理：
+- 移除死代码（未使用的 props/exports/imports）
+- 移除 debug logs
+- **单独 commit 清理**，再开始重构
+
+## 分阶段执行
+
+多文件重构：
+- 每阶段最多 **5 个文件**
+- Phase 完成 → 验证 → 确认 → 下一 Phase
+- 不在一次响应中做多文件重构

package/knowledge/dream.md

@@ -1,36 +1,36 @@
-# Dream 记忆整理
-
-定期（每天或每次长 session 结束时）做一次深度记忆整合。
-
-## 整理流程
-
-### 1. 扫描每日日志
-读取 `memory/` 目录下最近 7 天的日志文件。
-
-### 2. 提取模式
-找重复出现的内容：
-- 相同的用户偏好被记录多次 → 合并
-- 相同的错误出现多次 → 晋升为硬性规则
-- 相同的工作模式出现多次 → 抽象为方法论
-
-### 3. 晋升
-- 重复 2 次的纠正 → 晋升到 memory.md 业务经验
-- 重复 3 次的经验 → 晋升到 knowledge 规则文件
-- 有通用价值的 → 提议写入 Skill
-
-### 4. 合并冗余
-- 相似记忆条目合并为一条
-- 保留最新版本，删除过期版本
-
-### 5. 清理过期
-- 已完成任务 → 从活跃任务移除
-- 超过 7 天的对话摘要 → 精简或归档
-- 不再适用的规则 → 标记废弃
-
-## 触发时机
-- `/dream` 命令（手动）
-- 对话结束时（自动）
-- memory.md 超过 5KB 时（自动瘦身）
-
-## 归档
-精简掉的内容归档到 `memory/archive/` 目录，不直接删除。
+# Dream 记忆整理
+
+定期（每天或每次长 session 结束时）做一次深度记忆整合。
+
+## 整理流程
+
+### 1. 扫描每日日志
+读取 `memory/` 目录下最近 7 天的日志文件。
+
+### 2. 提取模式
+找重复出现的内容：
+- 相同的用户偏好被记录多次 → 合并
+- 相同的错误出现多次 → 晋升为硬性规则
+- 相同的工作模式出现多次 → 抽象为方法论
+
+### 3. 晋升
+- 重复 2 次的纠正 → 晋升到 memory.md 业务经验
+- 重复 3 次的经验 → 晋升到 knowledge 规则文件
+- 有通用价值的 → 提议写入 Skill
+
+### 4. 合并冗余
+- 相似记忆条目合并为一条
+- 保留最新版本，删除过期版本
+
+### 5. 清理过期
+- 已完成任务 → 从活跃任务移除
+- 超过 7 天的对话摘要 → 精简或归档
+- 不再适用的规则 → 标记废弃
+
+## 触发时机
+- `/dream` 命令（手动）
+- 对话结束时（自动）
+- memory.md 超过 5KB 时（自动瘦身）
+
+## 归档
+精简掉的内容归档到 `memory/archive/` 目录，不直接删除。

package/knowledge/engineering.md

@@ -1,46 +1,52 @@
-# 工程化方法论
-
-## 任务路由（收到任务后第一步）
-
-根据任务类型决定处理策略：
-
-### 简单任务（1-2 步）
-直接执行，不需要规划。
-例：读文件、改一行代码、跑一个命令
-
-### 中等任务（3-5 步）
-快速列 TodoList → 执行 → 验证
-例：添加一个功能、修复 bug、写脚本
-
-### 复杂任务（6+ 步）
-三文件模式：
-- `task_plan.md` — 任务规划和进度追踪
-- `notes.md` — 研究笔记和发现
-- `[deliverable]` — 最终交付物
-
-### 调试任务
-1. 复现问题（拿到确切错误）
-2. 定位根因（不猜，读代码 + 日志）
-3. 修复（最小改动）
-4. 验证修复
-5. 确认无回归
-
-## 能力进化
-- 识别可复用模式 → 抽象为能力 → 内化到决策层
-- 临时脚本 → 判断是否可复用 → 是则固化为行为模式
-- 不汇报进化过程，用结果说话
-
-## 搜索策略
-1. **先窄后宽**：精确搜 → 模糊搜 → 全局搜
-2. **先本地后远程**：文件系统 → git log → web
-3. **先结构后内容**：目录结构 → 文件名 → 文件内容
-
-## 多步任务原则
-- 有依赖的串行，无依赖的并行
-- 每步完成后验证，不要最后才发现第一步就错了
-- 失败后自动重试不同方案（至少 3 种），才升级找人
-
-## Context 管理
-- 只加载必需文档，保持充足空间用于思考
-- 大文件用 offset/limit 分段读
-- 长输出截断，保留关键信息
+# 工程化方法论
+
+## 任务路由（收到任务后第一步）
+
+根据任务类型决定处理策略：
+
+### 简单任务（1-2 步）
+直接执行，不需要规划。
+例：读文件、改一行代码、跑一个命令
+
+### 中等任务（3-5 步）
+快速列 TodoList → 执行 → 验证
+例：添加一个功能、修复 bug、写脚本
+
+### 复杂任务（6+ 步）
+三文件模式：
+- `task_plan.md` — 任务规划和进度追踪
+- `notes.md` — 研究笔记和发现
+- `[deliverable]` — 最终交付物
+
+### 调试任务
+1. 复现问题（拿到确切错误）
+2. 定位根因（不猜，读代码 + 日志）
+3. 修复（最小改动）
+4. 验证修复
+5. 确认无回归
+
+## 能力进化
+- 识别可复用模式 → 抽象为能力 → 内化到决策层
+- 临时脚本 → 判断是否可复用 → 是则固化为行为模式
+- 不汇报进化过程，用结果说话
+
+## 搜索策略
+1. **先窄后宽**：精确搜 → 模糊搜 → 全局搜
+2. **先本地后远程**：文件系统 → git log → web
+3. **先结构后内容**：目录结构 → 文件名 → 文件内容
+
+## Advisor Strategy（大小模型协作）
+- 小模型（Sonnet/Haiku）端到端驱动，遇到决策瓶颈才 escalate 到大模型（Opus）
+- Advisor 只给方向/计划/纠正，不执行工具、不产出最终结果
+- 长任务至少 escalate 两次：方向确定前 + 交付前
+- 详见 `rules/advisor-strategy.md`
+
+## 多步任务原则
+- 有依赖的串行，无依赖的并行
+- 每步完成后验证，不要最后才发现第一步就错了
+- 失败后自动重试不同方案（至少 3 种），才升级找人
+
+## Context 管理
+- 只加载必需文档，保持充足空间用于思考
+- 大文件用 offset/limit 分段读
+- 长输出截断，保留关键信息