oh-my-droid 2.0.0 → 2.0.1

package/.factory/commands/changelog.md

@@ -1,4 +1,5 @@
 ---
+name: changelog
 description: 生成变更日志
 argument-hint: 版本号或日期范围
 ---

package/.factory/commands/deepen-plan.md

@@ -1,4 +1,5 @@
 ---
+name: deepen-plan
 description: 深化计划，增加研究和细节
 argument-hint: 计划文件路径
 ---

package/.factory/commands/resolve-parallel.md

@@ -1,4 +1,5 @@
 ---
+name: resolve-parallel
 description: 并行解决多个问题
 argument-hint: 问题列表或文件路径
 ---

package/.factory/commands/triage.md

@@ -1,4 +1,5 @@
 ---
+name: triage
 description: 问题分类和优先级排序
 argument-hint: 问题列表或目录
 ---

package/.factory/commands/workflows-compound.md

@@ -1,53 +1,205 @@
 ---
+name: workflows-compound
 description: 记录解决的问题，积累知识
-argument-hint: 问题描述
+argument-hint: "[可选: 问题简述]"
 ---
 
 # /workflows-compound
 
-记录解决的问题和学到的经验，让知识复合增长。
+记录解决的问题，让知识复合增长。每次记录都让下次遇到类似问题更快解决。
 
 ## 理念
 
-**复合工程**：每一次工程工作都应该让后续工作更轻松。
+**复合工程**：第一次解决问题需要研究（30分钟），记录后下次只需查找（2分钟）。
+
+## 触发时机
+
+**自动触发短语**：
+- "搞定了"、"修好了"、"问题解决了"、"可以了"
+
+**手动触发**：
+- `/workflows-compound [问题简述]`
+
+**只记录非平凡问题**：
+- 需要多次尝试才解决的
+- 解决方案不明显的
+- 未来会再次遇到的
 
 ## 流程
 
-1. **问题回顾** - 描述遇到的问题
-2. **解决方案** - 记录如何解决
-3. **关键学习** - 提炼可复用的经验
-4. **更新文档** - 将学习写入项目文档
+### 1. 收集上下文
+
+从对话历史提取：
+- **问题症状**：确切的错误信息、可观察的行为
+- **尝试过的方法**：什么没用、为什么
+- **根本原因**：技术层面的解释
+- **解决方案**：具体的修复步骤和代码
+- **预防措施**：如何避免再次发生
+
+### 2. 检查已有文档
+
+```bash
+# 搜索类似问题
+grep -r "关键词" docs/solutions/
+```
+
+如果找到类似问题，选择：
+1. 创建新文档并交叉引用（推荐）
+2. 更新已有文档（仅当根因相同）
+
+### 3. 分类并创建文档
+
+**问题类型（自动分类到对应目录）**：
+
+| problem_type | 目录 | 说明 |
+|--------------|------|------|
+| build_error | build-errors/ | 构建、编译错误 |
+| test_failure | test-failures/ | 测试失败 |
+| runtime_error | runtime-errors/ | 运行时错误 |
+| performance_issue | performance-issues/ | 性能问题 |
+| database_issue | database-issues/ | 数据库问题 |
+| security_issue | security-issues/ | 安全问题 |
+| ui_bug | ui-bugs/ | 界面问题 |
+| integration_issue | integration-issues/ | 集成问题 |
+| logic_error | logic-errors/ | 逻辑错误 |
+| config_issue | config-issues/ | 配置问题 |
+
+### 4. 生成文件
+
+**文件路径**：`docs/solutions/[category]/[slug]-[YYYYMMDD].md`
+
+**文件格式**（YAML frontmatter + Markdown）：
+
+```markdown
+---
+date: 2025-01-15
+problem_type: performance_issue
+component: database
+symptoms:
+  - "查询超时"
+  - "N+1 查询"
+root_cause: missing_eager_loading
+severity: moderate  # critical | moderate | minor
+tags: [n-plus-one, eager-loading, rails]
+related: []  # 相关文档路径
+---
+
+# N+1 查询导致页面加载缓慢
+
+## 问题
+
+[描述遇到的问题，包含确切错误信息]
+
+## 尝试过的方法
+
+1. [方法1] - 结果：[没用/部分有效]
+2. [方法2] - 结果：[没用/部分有效]
+
+## 根本原因
+
+[技术层面的解释]
 
-## 记录模板
+## 解决方案
+
+[具体步骤和代码示例]
+
+```ruby
+# 修复前
+User.all.each { |u| puts u.posts.count }
+
+# 修复后
+User.includes(:posts).each { |u| puts u.posts.count }
+```
+
+## 预防措施
+
+- [如何避免再次发生]
+- [相关的最佳实践]
+
+## 相关文档
+
+- [链接到相关问题]
+```
+
+## 完成后选项
+
+```
+✓ 文档已创建
+
+文件：docs/solutions/performance-issues/n-plus-one-query-20250115.md
+
+下一步？
+1. 继续工作流（推荐）
+2. 添加到关键模式 - 提升到 patterns/critical-patterns.md
+3. 关联相关文档
+4. 查看文档
+5. 其他
+```
+
+**选项 2：添加到关键模式**
+
+当问题满足以下条件时推荐：
+- 多次在不同地方犯同样的错
+- 解决方案不明显但必须遵循
+- 基础性要求
+
+会添加到 `docs/solutions/patterns/critical-patterns.md`，格式：
 
 ```markdown
-## [日期] [问题标题]
+## [模式名称]
 
-### 问题
-[描述遇到的问题]
+❌ 错误做法：
+```code
+[错误示例]
+```
 
-### 原因
-[根本原因分析]
+✅ 正确做法：
+```code
+[正确示例]
+```
 
-### 解决方案
-[如何解决的]
+**原因**：[为什么这样做]
+```
+
+## 检索已有知识
+
+下次遇到类似问题时：
 
-### 学习
-[可复用的经验]
+```bash
+# 按目录浏览
+ls docs/solutions/performance-issues/
 
-### 预防
-[如何避免再次发生]
+# 按关键词搜索
+grep -r "N+1" docs/solutions/
+
+# 按标签搜索
+grep -r "tags:.*eager-loading" docs/solutions/
 ```
 
-## 输出位置
+## 目录结构
 
-- 项目级学习 → `docs/learnings/` 或 `AGENTS.md`
-- 通用模式 → 考虑创建新的 Skill
+```
+docs/solutions/
+├── build-errors/
+├── test-failures/
+├── runtime-errors/
+├── performance-issues/
+├── database-issues/
+├── security-issues/
+├── ui-bugs/
+├── integration-issues/
+├── logic-errors/
+├── config-issues/
+└── patterns/
+    └── critical-patterns.md  # 关键模式（会被 AI 主动读取）
+```
 
-## 后续步骤
+## 上下文优化
 
-- 定期回顾学习记录
-- 将重复模式提炼为自动化
+- **按需加载**：文档存在 `docs/solutions/`，不放 AGENTS.md
+- **分类检索**：遇到性能问题只搜 `performance-issues/`
+- **YAML frontmatter**：快速扫描元数据，不需读全文
+- **关键模式分离**：只有 `critical-patterns.md` 会被主动加载
 
 ---
 

package/.factory/commands/workflows-plan.md

@@ -1,4 +1,5 @@
 ---
+name: workflows-plan
 description: 将功能描述转换为结构化的计划文档
 argument-hint: 功能描述
 ---

package/.factory/commands/workflows-review.md

@@ -1,4 +1,5 @@
 ---
+name: workflows-review
 description: 使用多代理分析进行代码审查
 argument-hint: PR号、分支名或文件路径
 ---

package/.factory/commands/workflows-work.md

@@ -1,4 +1,5 @@
 ---
+name: workflows-work
 description: 执行计划文件中的任务
 argument-hint: 计划文件路径
 ---

package/README.md

@@ -2,14 +2,60 @@
 
 精简通用 Droid 工具集 - 10 个 Droids、8 个 Commands。
 
+## 项目介绍
+
+本项目借鉴了 [EveryInc/compound-engineering-plugin](https://github.com/EveryInc/compound-engineering-plugin) 的复利工程思路，适配 Droid 并精简了提示词（上下文控制很重要）。
+
+**核心理念很简单：**
+- 第一次做某类任务 → 探索、学习、记录
+- 第二次做同类任务 → 有经验、更高效
+
+让 AI 的每一次工作都能积累成可复用的经验。
+
 ## 一键安装
 
 ```bash
-npx oh-my-droid          # 安装到当前项目
+npx oh-my-droid          # ⭐ 推荐：安装到当前项目（工具随项目走）
 npx oh-my-droid -g       # 安装到全局 (~/.factory)
 npx oh-my-droid -u       # 卸载
 ```
 
+## 安装说明
+
+安装时会做两件事：
+
+1. **复制工具文件** - 将 Droids 和 Commands 复制到 `.factory` 目录
+2. **更新 AGENTS.md** - 在文件开头添加使用说明（核心命令、工作流程等）
+
+### 项目安装 vs 全局安装
+
+| 安装方式 | 命令 | 适用场景 |
+|---------|------|---------|
+| 项目安装 | `npx oh-my-droid` | 单个项目使用，工具随项目走 |
+| 全局安装 | `npx oh-my-droid -g` | 多个项目共用，安装到 `~/.factory` |
+
+### 全局安装注意事项
+
+如果你选择全局安装，开新项目时需要手动在项目的 `AGENTS.md` 开头添加以下内容：
+
+```markdown
+<coding_guidelines>
+# oh-my-droid:start
+# 使用中文回答
+## 核心命令
+`/workflows-plan <描述>` 创建计划 | `/workflows-work <计划>` 执行计划 | `/workflows-review <目标>` 代码审查 | `/workflows-compound` 记录学习
+## 辅助命令
+`/deepen-plan` 深化计划 | `/triage` 问题分类 | `/resolve-parallel` 并行解决 | `/changelog` 变更日志
+## 工作流程
+Plan → Work → Review → Compound | 80%规划审查，20%执行
+## 添加组件
+Droid: `.factory/droids/<名称>.md` | Command: `.factory/commands/<名称>.md`
+# oh-my-droid:end
+</coding_guidelines>
+```
+
+这样 AI 才能识别并使用这些命令。
+
 ## 核心工作流
 
 ```
@@ -32,6 +78,30 @@ Plan → Work → Review → Compound
 | `/resolve-parallel` | 并行解决 |
 | `/changelog` | 变更日志 |
 
+## 使用示例
+
+以「添加用户登录功能」为例，演示完整工作流：
+
+```
+1. 创建计划
+   /workflows-plan 添加用户登录功能
+   → AI 分析需求，生成 plans/添加用户登录功能.md
+
+2. 执行计划
+   /workflows-work plans/添加用户登录功能.md
+   → AI 按计划逐步实施代码
+
+3. 代码审查
+   /workflows-review src/auth/
+   → AI 审查代码质量，提出改进建议
+
+4. 记录学习
+   /workflows-compound
+   → AI 总结本次经验，更新知识库
+```
+
+下次遇到类似任务时，AI 会自动应用积累的经验，效率更高。
+
 ---
 
 [English](./README_EN.md) | 中文

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "oh-my-droid",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "精简通用 Droid 工具集 - 10 Droids, 8 Commands",
   "bin": {
     "oh-my-droid": "./bin/cli.js"
   },
-  "keywords": ["droid", "factory", "ai", "agent", "cli"],
+  "keywords": [
+    "droid",
+    "factory",
+    "ai",
+    "agent",
+    "cli"
+  ],
   "author": "EveryInc",
   "license": "MIT",
   "repository": {