@rdmind/rdmind 0.0.9-alpha.1 → 0.0.9

package/.knowledge/.ext/coding/thrift-service.md

@@ -0,0 +1,292 @@
+# Thrift服务实现规范
+
+## 强制要求
+
+### 重要约束
+
+**重要：绝对禁止使用Object类型作为Thrift服务的参数和返回值类型**
+
+#### 禁止行为
+
+- ❌ **禁止**使用`Object`类型作为Thrift服务方法的参数类型
+- ❌ **禁止**使用`Object`类型作为Thrift服务方法的返回值类型
+- ❌ **禁止**使用`Object`类型作为App层服务方法的参数类型
+- ❌ **禁止**使用`Object`类型作为App层服务方法的返回值类型
+
+#### 必须行为
+
+- ✅ **必须**使用Thrift生成的正确类型（如`CreateCircleReq`、`CreateCircleResp`等）
+- ✅ **必须**使用`Context`类型作为Thrift服务的第一个参数
+- ✅ **必须**使用具体的Thrift DTO类型作为业务参数和返回值
+- ✅ **必须**在方法签名中明确指定Thrift类型，不得使用泛型或Object
+
+---
+
+## Thrift服务实现通用规则
+
+### Start层实现规范
+
+#### 强制要求
+
+- 必须实现 Thrift 生成的 `xxxService.Iface` 接口，方法签名与 `service.thrift` 严格一致
+- 必须使用 `@RedRPCService` 注解对外暴露 RPC 服务，参数需显式配置：
+  - `port`：服务端口
+  - `threadSize`：工作线程数
+  - `interfaceClass`：指向对应的 `xxxService.Iface.class`
+  - `timeout`：超时时间（毫秒）
+- Start层仅负责 RPC 暴露、日志、错误处理与结果封装，禁止编写业务逻辑；业务调用必须委托 App 层
+- 方法内必须使用 try-catch：
+  - `log.info` 记录请求参数（必要时脱敏）
+  - 捕获异常后 `log.error` 记录堆栈
+  - 组装统一的失败响应（`base.Result`：`success=false`、`code`、`message`）
+
+#### 代码结构示例
+
+```java
+@Slf4j
+@RedRPCService(port = 9966, threadSize = 200, interfaceClass = CircleService.Iface.class, timeout = 3000)
+public class CircleThriftServiceImpl implements CircleService.Iface {
+	@Resource
+	private CircleAppService circleAppService;
+
+	@Override
+	public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) throws TException {
+		CreateCircleResp resp = new CreateCircleResp();
+		try {
+			log.info("createCircle req:{}", request);
+			// 调用 App 层（Start层不做业务）
+			CreateCircleResp result = circleAppService.createCircle(request);
+			resp.setResult(new Result(true));
+			return resp;
+		} catch (Exception e) {
+			log.error("createCircle failed, req={}", request, e);
+			Result fail = new Result(false);
+			fail.setCode(500);
+			fail.setMessage("服务器错误");
+			resp.setResult(fail);
+			return resp;
+		}
+	}
+}
+```
+
+### 服务配置规范
+
+#### @RedRPCService注解配置
+
+```java
+@RedRPCService(
+    port = 9966,                                    // 服务端口
+    threadSize = 200,                              // 工作线程数
+    interfaceClass = CircleService.Iface.class,    // 接口类
+    timeout = 3000                                 // 超时时间（毫秒）
+)
+```
+
+#### 日志记录规范
+
+```java
+// 请求日志（必要时脱敏）
+log.info("createCircle req:{}", request);
+
+// 异常日志（包含堆栈信息）
+log.error("createCircle failed, req={}", request, e);
+```
+
+#### 错误响应规范
+
+```java
+Result fail = new Result(false);
+fail.setCode(500);
+fail.setMessage("服务器错误");
+resp.setResult(fail);
+```
+
+---
+
+## App层DTO使用规范
+
+### 重要约束
+
+**App层必须严格复用Start层的Thrift入参和出参，禁止创建新的DTO对象**
+
+#### 禁止行为
+
+- ❌ **禁止**在App层创建新的入参DTO（如 `CreateCircleRequest`）
+- ❌ **禁止**在App层创建新的出参DTO（如 `CreateCircleResult`）
+- ❌ **禁止**向Domain层传入Thrift DTO（绝对禁止）
+
+#### 必须行为
+
+- ✅ **必须**直接使用Start层的Thrift入参/出参
+- ✅ **必须**在App层进行Thrift DTO与领域对象的转换
+- ✅ **必须**调用Domain层时传入领域对象，绝对禁止传入Thrift DTO
+
+### 正确的分层调用流程
+
+```
+Start层 (Thrift DTO) → App层 (DTO转换) → Domain层 (领域对象) → Infrastructure层
+```
+
+### DTO转换示例
+
+```java
+// App层实现示例
+@Service
+public class CircleAppServiceImpl implements CircleAppService {
+
+    @Resource
+    private CircleDomainService circleDomainService;
+
+    @Override
+    public CreateCircleResp createCircle(CreateCircleReq request) {
+        // DTO转换为领域对象
+        Circle circle = new Circle();
+        circle.setName(request.getName());
+        circle.setDescription(request.getDescription());
+
+        // 调用Domain层
+        circleDomainService.createCircle(circle);
+
+        // 构建响应
+        CreateCircleResp resp = new CreateCircleResp();
+        resp.setResult(new Result(true));
+        return resp;
+    }
+}
+```
+
+---
+
+## 常见Thrift错误
+
+### Object类型使用错误
+
+❌ **错误**：Thrift服务使用Object类型作为参数或返回值  
+✅ **正确**：必须使用具体的Thrift类型
+
+**解决方案**：
+
+```java
+❌ 错误示例：
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    public Object createCircle(Context ctx, Object request) { // 错误：使用Object类型
+        // 业务逻辑
+    }
+}
+
+✅ 正确示例：
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) { // 正确：使用具体类型
+        // 业务逻辑
+    }
+}
+```
+
+### 缺少错误处理错误
+
+❌ **错误**：Thrift服务缺少完整的错误处理  
+✅ **正确**：必须包含try-catch、日志记录和失败响应
+
+**解决方案**：
+
+```java
+❌ 错误示例：
+public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) {
+    // 直接调用业务逻辑，没有错误处理
+    return circleAppService.createCircle(request);
+}
+
+✅ 正确示例：
+public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) {
+    CreateCircleResp resp = new CreateCircleResp();
+    try {
+        log.info("createCircle req:{}", request);
+        CreateCircleResp result = circleAppService.createCircle(request);
+        resp.setResult(new Result(true));
+        return resp;
+    } catch (Exception e) {
+        log.error("createCircle failed, req={}", request, e);
+        Result fail = new Result(false);
+        fail.setCode(500);
+        fail.setMessage("服务器错误");
+        resp.setResult(fail);
+        return resp;
+    }
+}
+```
+
+### 缺少注解配置错误
+
+❌ **错误**：缺少@RedRPCService注解或配置不完整  
+✅ **正确**：必须包含完整的注解配置
+
+**解决方案**：
+
+```java
+❌ 错误示例：
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    // 缺少@RedRPCService注解
+}
+
+✅ 正确示例：
+@RedRPCService(port = 9966, threadSize = 200, interfaceClass = CircleService.Iface.class, timeout = 3000)
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    // 正确的注解配置
+}
+```
+
+### 跨层调用错误
+
+❌ **错误**：Start层直接调用Domain层  
+✅ **正确**：Start层只调用App层
+
+**解决方案**：
+
+```java
+❌ 错误示例：
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    @Resource
+    private CircleDomainService circleDomainService; // 错误：直接依赖Domain层
+
+    public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) {
+        circleDomainService.createCircle(request); // 错误：跨层调用
+    }
+}
+
+✅ 正确示例：
+public class CircleThriftServiceImpl implements CircleService.Iface {
+    @Resource
+    private CircleAppService circleAppService; // 正确：依赖App层
+
+    public CreateCircleResp createCircle(Context ctx, CreateCircleReq request) {
+        return circleAppService.createCircle(request); // 正确：调用App层
+    }
+}
+```
+
+---
+
+## 质量检查清单
+
+### Thrift服务检查
+
+- [ ] 类是否 `implements xxxService.Iface`？
+- [ ] 是否使用 `@RedRPCService` 且参数正确？
+- [ ] 是否严格使用 Thrift DTO 作为入参/出参？
+- [ ] 是否仅调用 App 层，不包含业务逻辑？
+- [ ] 是否全量覆盖 try-catch、日志与失败响应？
+- [ ] 是否无 Domain 层对 Thrift DTO 的依赖？
+- [ ] Thrift服务是否使用正确的类型而非Object？
+- [ ] App层服务是否使用正确的Thrift类型？
+- [ ] 是否避免了Object类型的使用？
+- [ ] 是否使用了Context类型作为第一个参数？
+- [ ] 是否在方法签名中明确指定了Thrift类型？
+- [ ] 是否避免了泛型或Object的使用？
+
+### 服务实现检查
+
+- [ ] 是否记录了请求参数（必要时脱敏）？
+- [ ] 是否捕获异常后记录了堆栈？
+- [ ] 是否组装了统一的失败响应？
+- [ ] 是否设置了正确的错误码和消息？

package/.knowledge/BMAD.md

@@ -0,0 +1,255 @@
+# BMAD 扩展知识库索引
+
+## 📚 快速导航
+
+### 🎯 精准定位指南
+
+**重要：Agent角色文件已移动到扩展知识库，请使用 `read_knowledge_ext` 工具获取**
+
+| 用户意图     | 对应文件                    | 触发命令             | 获取方式             |
+| ------------ | --------------------------- | -------------------- | -------------------- |
+| **全栈开发** | agents/dev.md               | `*dev`               | `read_knowledge_ext` |
+| **系统架构** | agents/architect.md         | `*architect`         | `read_knowledge_ext` |
+| **质量保证** | agents/qa.md                | `*qa`                | `read_knowledge_ext` |
+| **敏捷管理** | agents/sm.md                | `*sm`                | `read_knowledge_ext` |
+| **产品管理** | agents/po.md                | `*po`                | `read_knowledge_ext` |
+| **产品策略** | agents/pm.md                | `*pm`                | `read_knowledge_ext` |
+| **需求分析** | agents/ra.md                | `*ra`                | `read_knowledge_ext` |
+| **用户体验** | agents/ux-expert.md         | `*ux-expert`         | `read_knowledge_ext` |
+| **系统编排** | agents/bmad-orchestrator.md | `*bmad-orchestrator` | `read_knowledge_ext` |
+
+---
+
+## 🔍 场景化精准查找
+
+### 我需要...
+
+#### 💻 **进行软件开发**
+
+- **场景**：代码实现、调试、重构、开发最佳实践
+- **文件**：`agents/dev.md`
+- **触发命令**：`*dev`
+- **关键内容**：全栈开发者Agent定义、开发流程、任务执行
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🏗️ **设计系统架构**
+
+- **场景**：系统设计、架构文档、技术选择、API设计、基础设施规划
+- **文件**：`agents/architect.md`
+- **触发命令**：`*architect`
+- **关键内容**：系统架构师Agent定义、架构原则、技术选择
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🧪 **进行质量保证**
+
+- **场景**：测试架构审查、质量门决策、代码改进
+- **文件**：`agents/qa.md`
+- **触发命令**：`*qa`
+- **关键内容**：测试架构师Agent定义、质量分析、风险评估
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🏃 **管理敏捷流程**
+
+- **场景**：故事创建、史诗管理、敏捷流程指导
+- **文件**：`agents/sm.md`
+- **触发命令**：`*sm`
+- **关键内容**：Scrum Master Agent定义、故事准备、流程管理
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 📝 **管理产品需求**
+
+- **场景**：待办事项管理、故事细化、验收标准、冲刺规划、优先级决策
+- **文件**：`agents/po.md`
+- **触发命令**：`*po`
+- **关键内容**：产品负责人Agent定义、需求管理、流程遵守
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 📋 **制定产品策略**
+
+- **场景**：创建PRD、产品策略、功能优先级、路线图规划、利益相关者沟通
+- **文件**：`agents/pm.md`
+- **触发命令**：`*pm`
+- **关键内容**：产品经理Agent定义、产品策略、市场研究
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 📊 **分析技术需求**
+
+- **场景**：将PRD转化为技术需求文档、需求分析、技术规格制定、架构指导
+- **文件**：`agents/ra.md`
+- **触发命令**：`*ra`
+- **关键内容**：需求分析师Agent定义、技术需求分析、TRD文档创建
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🎨 **设计用户体验**
+
+- **场景**：UI/UX设计、线框图、原型、前端规范、用户体验优化
+- **文件**：`agents/ux-expert.md`
+- **触发命令**：`*ux-expert`
+- **关键内容**：UX专家Agent定义、用户研究、交互设计
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🎭 **协调多Agent工作**
+
+- **场景**：工作流协调、多Agent任务、角色切换指导、不确定选择哪个专家时
+- **文件**：`agents/bmad-orchestrator.md`
+- **触发命令**：`*bmad-orchestrator`
+- **关键内容**：BMAD编排器Agent定义、工作流管理、角色协调
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🔧 **了解系统工具**
+
+- **场景**：工具使用说明、扩展知识库访问、目录结构探索
+- **文件**：本文件（BMAD.md）
+- **关键内容**：工具使用指南、目录结构、最佳实践
+- **获取方式**：直接查看本文件
+
+---
+
+## 📖 优化后的文件结构
+
+```
+.knowledge/
+├── BMAD.md                     ← 本索引文件（包含工具说明）
+└── .ext/
+    └── .bmad-core/
+        └── agents/
+            ├── dev.md          ← 全栈开发者Agent
+            ├── architect.md    ← 系统架构师Agent
+            ├── qa.md           ← 测试架构师Agent
+            ├── sm.md           ← Scrum Master Agent
+            ├── po.md           ← 产品负责人Agent
+            ├── pm.md           ← 产品经理Agent
+            ├── ux-expert.md    ← UX专家Agent
+            ├── bmad-orchestrator.md ← BMAD编排器Agent
+            └── ...             ← 其他Agent角色
+```
+
+---
+
+## 🚀 快速开始
+
+### 按需加载策略
+
+1. **首次使用**：查看本索引文件了解可用Agent
+2. **选择角色**：根据具体需求选择对应Agent角色文件
+3. **激活Agent**：使用对应的触发命令激活Agent
+4. **获取帮助**：激活后使用`*help`命令查看可用功能
+
+### 扩展知识库使用说明
+
+**重要：Agent角色文件已移动到扩展知识库，需要使用专用工具获取**
+
+#### 工具使用说明
+
+BMAD系统提供了两个专用工具来访问扩展知识库：
+
+##### 1. `read_knowledge_ext` - 读取扩展知识库文件
+
+- **用途**: 按需读取`.knowledge/.ext`目录中的文件内容
+- **参数**: `relativePath` - 相对于`.knowledge/.ext/`的路径
+- **示例**:
+  - `read_knowledge_ext(".bmad-core/role/dev.md")`
+  - `read_knowledge_ext(".bmad-core/core-config.yaml")`
+  - `read_knowledge_ext(".bmad-core/tasks/create-doc.md")`
+
+##### 2. `list_knowledge_ext` - 列出扩展知识库目录
+
+- **用途**: 探索`.knowledge/.ext`目录结构
+- **参数**: `subPath` (可选) - 要列出的子路径
+- **示例**:
+  - `list_knowledge_ext()` - 列出根目录
+  - `list_knowledge_ext(".bmad-core")` - 列出.bmad-core目录
+  - `list_knowledge_ext(".bmad-core/role")` - 列出role目录
+
+##### 使用原则
+
+- **按需读取**: 不要一次性加载所有文件，只在需要时读取特定文件
+- **探索结构**: 使用`list_knowledge_ext`先了解目录结构
+- **精确路径**: 使用准确的相对路径来读取文件
+- **激活时限制**: 在agent激活时，只读取`core-config.yaml`，不要读取其他文件
+- **用户驱动**: 只有在用户明确请求特定任务或命令时，才读取相关的任务文件
+- **避免批量读取**: 不要因为发现引用就自动读取所有相关文件
+
+#### 使用场景
+
+##### 场景1：查看特定Agent角色
+
+```bash
+# 查看全栈开发者Agent定义
+read_knowledge_ext(".bmad-core/agents/dev.md")
+
+# 查看系统架构师Agent定义
+read_knowledge_ext(".bmad-core/agents/architect.md")
+
+# 查看产品经理Agent定义
+read_knowledge_ext(".bmad-core/agents/pm.md")
+```
+
+##### 场景2：探索可用角色
+
+```bash
+# 列出所有可用角色
+list_knowledge_ext(".bmad-core/agents")
+```
+
+##### 场景3：查看任务和模板
+
+```bash
+# 查看可用任务
+list_knowledge_ext(".bmad-core/tasks")
+
+# 查看可用模板
+list_knowledge_ext(".bmad-core/templates")
+```
+
+##### 场景4：Agent激活时
+
+```bash
+# 仅读取核心配置
+read_knowledge_ext(".bmad-core/core-config.yaml")
+```
+
+#### 支持的文件
+
+- `agents/dev.md` - 全栈开发者Agent (`*dev`)
+- `agents/architect.md` - 系统架构师Agent (`*architect`)
+- `agents/qa.md` - 测试架构师Agent (`*qa`)
+- `agents/sm.md` - Scrum Master Agent (`*sm`)
+- `agents/po.md` - 产品负责人Agent (`*po`)
+- `agents/pm.md` - 产品经理Agent (`*pm`)
+- `agents/ra.md` - 需求分析师Agent (`*ra`)
+- `agents/ux-expert.md` - UX专家Agent (`*ux-expert`)
+- `agents/bmad-orchestrator.md` - BMAD编排器Agent (`*bmad-orchestrator`)
+
+### 精准定位技巧
+
+1. **明确意图**：先确定具体需要什么类型的Agent
+2. **选择文件**：根据意图选择最相关的Agent文件
+3. **使用工具**：通过 `read_knowledge_ext` 工具获取文件内容
+4. **激活Agent**：使用对应的触发命令激活Agent
+
+---
+
+## 💡 使用建议
+
+### 🎯 最小化加载原则
+
+- **按需查阅**：根据当前任务使用 `read_knowledge_ext` 获取对应Agent文件
+- **精准定位**：使用场景指南快速定位
+- **避免冗余**：不要加载不相关的内容
+- **高效利用**：充分利用每个Agent的专业性
+
+### 📈 效率提升
+
+- **场景驱动**：使用场景指南快速定位
+- **内容精准**：每个Agent文件内容高度聚焦
+- **按需激活**：只在需要时激活特定Agent
+- **工具支持**：通过 `read_knowledge_ext` 工具实现精准内容获取
+- **扩展知识库**：Agent角色文件通过 `read_knowledge_ext` 工具按需获取
+
+### 🔄 持续优化
+
+- **反馈收集**：收集使用过程中的问题和建议
+- **内容更新**：根据实际使用情况更新内容
+- **结构优化**：持续优化文件结构和内容分配
+- **工具支持**：开发自动化工具提高使用效率

package/.knowledge/coding.md

@@ -0,0 +1,135 @@
+# RDMind 小红书开发规范
+
+## 📚 快速导航
+
+### 🎯 精准定位指南
+
+**重要：专业规范文件已移动到扩展知识库，请使用 `read_knowledge_ext` 工具获取**
+
+| 用户意图            | 对应文件             | 内容大小 | 获取方式             |
+| ------------------- | -------------------- | -------- | -------------------- |
+| **DDD架构设计**     | ddd-architecture.md  | 224行    | `read_knowledge_ext` |
+| **Java开发规范**    | java-standards.md    | 315行    | `read_knowledge_ext` |
+| **Thrift服务实现**  | thrift-service.md    | 298行    | `read_knowledge_ext` |
+| **SQL建表规范**     | sql-standards.md     | 271行    | `read_knowledge_ext` |
+| **MyBatis代码生成** | mybatis-standards.md | 410行    | `read_knowledge_ext` |
+
+---
+
+## 🔍 场景化精准查找
+
+### 我需要...
+
+#### 🏗️ **设计DDD架构**
+
+- **场景**：分层架构设计、依赖关系管理、架构错误排查、代码开发检查
+- **文件**：`ddd-architecture.md` (224行)
+- **关键内容**：架构分层、依赖约束、实现顺序、架构错误解决方案、代码开发检查
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### ☕ **编写Java代码**
+
+- **场景**：值对象设计、Lombok使用、分层设计、Java错误排查、文件操作规范
+- **文件**：`java-standards.md` (315行)
+- **关键内容**：值对象规范、Lombok注解、分层设计、Java错误解决方案、文件操作规范
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🔌 **实现Thrift服务**
+
+- **场景**：Thrift服务开发、类型安全、错误处理、服务实现检查
+- **文件**：`thrift-service.md` (298行)
+- **关键内容**：服务实现规范、DTO使用规范、Thrift错误解决方案、服务实现检查
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🗄️ **设计数据库表**
+
+- **场景**：SQL建表、索引设计、数据库规范、数据库规范检查
+- **文件**：`sql-standards.md` (271行)
+- **关键内容**：建表规范、索引定义、SQL错误解决方案、数据库规范检查
+- **获取方式**：`read_knowledge_ext` 工具
+
+#### 🔧 **生成MyBatis代码**
+
+- **场景**：Mapper生成、XML配置、DO对象设计、MyBatis代码检查
+- **文件**：`mybatis-standards.md` (410行)
+- **关键内容**：Mapper规范、XML规范、DO规范、MyBatis错误解决方案、MyBatis代码检查
+- **获取方式**：`read_knowledge_ext` 工具
+
+---
+
+## 📖 优化后的文件结构
+
+```
+.knowledge/
+├── coding.md                    ← 本索引文件（精准定位）
+└── .ext/
+    └── coding/
+        ├── ddd-architecture.md          ← DDD架构规范（224行）
+        ├── java-standards.md            ← Java开发规范（315行）
+        ├── thrift-service.md            ← Thrift服务规范（298行）
+        ├── sql-standards.md             ← SQL建表规范（271行）
+        └── mybatis-standards.md         ← MyBatis规范（410行）
+```
+
+---
+
+## 🚀 快速开始
+
+### 按需加载策略
+
+1. **首次使用**：AI行为规范已默认加载，无需额外操作
+2. **开始开发**：使用 `read_knowledge_ext` 工具获取对应专业规范文件
+3. **遇到问题**：通过 `read_knowledge_ext` 查看相关规范文件中的错误解决方案
+4. **质量检查**：使用 `read_knowledge_ext` 获取各专业文件中的质量检查清单
+
+### 扩展知识库使用说明
+
+**重要：专业规范文件已移动到扩展知识库，需要使用 `read_knowledge_ext` 工具获取**
+
+#### 使用方式
+
+- **工具名称**：`read_knowledge_ext`
+- **文件路径**：`.knowledge/.ext/coding/{文件名}`
+- **示例**：`read_knowledge_ext .knowledge/.ext/coding/ddd-architecture.md`
+
+#### 支持的文件
+
+- `ddd-architecture.md` - DDD架构设计规范
+- `java-standards.md` - Java开发规范
+- `thrift-service.md` - Thrift服务实现规范
+- `sql-standards.md` - SQL建表规范
+- `mybatis-standards.md` - MyBatis代码生成规范
+
+### 精准定位技巧
+
+1. **明确意图**：先确定具体需要什么类型的规范
+2. **选择文件**：根据意图选择最相关的文件
+3. **使用工具**：通过 `read_knowledge_ext` 工具获取文件内容
+4. **按需深入**：只深入阅读需要的部分
+
+---
+
+## 💡 使用建议
+
+### 🎯 最小化加载原则
+
+- **按需查阅**：根据当前任务使用 `read_knowledge_ext` 获取对应文件
+- **精准定位**：使用场景指南快速定位
+- **避免冗余**：不要加载不相关的内容
+- **高效利用**：充分利用每个文件的专业性
+
+### 📈 效率提升
+
+- **场景驱动**：使用场景指南快速定位
+- **内容精准**：每个文件内容高度聚焦
+- **错误集成**：错误解决方案集成在相关规范中
+- **检查集成**：质量检查清单集成在各专业文件中
+- **默认加载**：AI行为规范已默认加载，无需额外操作
+- **扩展知识库**：专业规范文件通过 `read_knowledge_ext` 工具按需获取
+
+### 🔄 持续优化
+
+- **反馈收集**：收集使用过程中的问题和建议
+- **内容更新**：根据实际使用情况更新内容
+- **结构优化**：持续优化文件结构和内容分配
+- **工具支持**：开发自动化工具提高使用效率

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rdmind/rdmind",
-    "version": "0.0.9-alpha.1",
+    "version": "0.0.9",
     "description": "RDMind",
     "type": "module",
     "main": "dist/index.js",
@@ -19,7 +19,8 @@
     },
     "files": [
         "dist",
-        "template"
+        "template",
+        ".knowledge"
     ],
     "publishConfig": {
         "access": "public"
@@ -30,7 +31,7 @@
     "dependencies": {
         "@google/genai": "1.9.0",
         "@iarna/toml": "^2.2.5",
-        "@rdmind/rdmind-core": "^0.0.9-alpha.1",
+        "@rdmind/rdmind-core": "^0.0.9",
         "@modelcontextprotocol/sdk": "^1.15.1",
         "@types/update-notifier": "^6.0.8",
         "command-exists": "^1.2.9",