claude-pangu 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/plugin.json +59 -0
- package/LICENSE +21 -0
- package/README.md +482 -0
- package/README_EN.md +481 -0
- package/agents/baozheng.md +257 -0
- package/agents/bianque.md +239 -0
- package/agents/cangjie.md +344 -0
- package/agents/change.md +368 -0
- package/agents/gukaizhi.md +331 -0
- package/agents/laozi.md +423 -0
- package/agents/libai.md +237 -0
- package/agents/libing.md +435 -0
- package/agents/luban.md +221 -0
- package/agents/mozi.md +221 -0
- package/agents/simaqian.md +321 -0
- package/agents/sunzi.md +302 -0
- package/agents/weizheng.md +280 -0
- package/agents/wukong.md +198 -0
- package/agents/yugong.md +162 -0
- package/agents/zhangheng.md +296 -0
- package/agents/zhenghe.md +276 -0
- package/agents/zhuge.md +192 -0
- package/commands/baozheng.md +87 -0
- package/commands/bianque.md +46 -0
- package/commands/cangjie.md +109 -0
- package/commands/laozi.md +104 -0
- package/commands/libing.md +60 -0
- package/commands/luban.md +46 -0
- package/commands/mozi.md +65 -0
- package/commands/progress.md +125 -0
- package/commands/simaqian.md +78 -0
- package/commands/sunzi.md +68 -0
- package/commands/team.md +107 -0
- package/commands/weizheng.md +101 -0
- package/commands/wukong.md +45 -0
- package/commands/yishan.md +81 -0
- package/commands/yugong.md +83 -0
- package/commands/zhangheng.md +60 -0
- package/commands/zhenghe.md +60 -0
- package/commands/zhuge.md +46 -0
- package/hooks/hooks.json +20 -0
- package/hooks/keyword-detector.sh +190 -0
- package/hooks/progress-notifier.sh +85 -0
- package/hooks/todo-enforcer.sh +155 -0
- package/package.json +50 -0
- package/scripts/cli.js +1024 -0
- package/scripts/install.js +10 -0
- package/scripts/install.ps1 +253 -0
- package/scripts/install.sh +225 -0
- package/scripts/postinstall.js +29 -0
- package/scripts/sync-version.js +215 -0
- package/scripts/uninstall.js +10 -0
- package/skills/bilingual/SKILL.md +131 -0
- package/skills/bilingual/skill.json +89 -0
- package/skills/progress/SKILL.md +207 -0
- package/skills/progress/skill.json +40 -0
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://code.claude.com/plugin-schema.json",
|
|
3
|
+
"name": "oh-my-claude",
|
|
4
|
+
"version": "0.9.0",
|
|
5
|
+
"description": "基于中国传统文化的 Claude Code 智能编排插件 - A Claude Code plugin inspired by Chinese traditional culture",
|
|
6
|
+
"author": "ZDragon17",
|
|
7
|
+
"contributors": [
|
|
8
|
+
{
|
|
9
|
+
"name": "ZDragon17",
|
|
10
|
+
"url": "https://github.com/ZDragon17"
|
|
11
|
+
}
|
|
12
|
+
],
|
|
13
|
+
"homepage": "https://github.com/ZDragon17/oh-my-claude#readme",
|
|
14
|
+
"repository": {
|
|
15
|
+
"type": "git",
|
|
16
|
+
"url": "git+https://github.com/ZDragon17/oh-my-claude.git"
|
|
17
|
+
},
|
|
18
|
+
"bugs": {
|
|
19
|
+
"url": "https://github.com/ZDragon17/oh-my-claude/issues"
|
|
20
|
+
},
|
|
21
|
+
"license": "MIT",
|
|
22
|
+
"keywords": [
|
|
23
|
+
"claude-code",
|
|
24
|
+
"agent",
|
|
25
|
+
"orchestration",
|
|
26
|
+
"chinese-culture",
|
|
27
|
+
"multi-agent",
|
|
28
|
+
"yugong",
|
|
29
|
+
"zhuge",
|
|
30
|
+
"luban",
|
|
31
|
+
"wukong",
|
|
32
|
+
"bianque",
|
|
33
|
+
"libai",
|
|
34
|
+
"gukaizhi",
|
|
35
|
+
"change",
|
|
36
|
+
"productivity",
|
|
37
|
+
"automation",
|
|
38
|
+
"task-management",
|
|
39
|
+
"debugging",
|
|
40
|
+
"architecture",
|
|
41
|
+
"code-quality",
|
|
42
|
+
"ui-ux",
|
|
43
|
+
"devops",
|
|
44
|
+
"cloud",
|
|
45
|
+
"requirements",
|
|
46
|
+
"bilingual"
|
|
47
|
+
],
|
|
48
|
+
"engines": {
|
|
49
|
+
"claude": ">=1.0.0",
|
|
50
|
+
"node": ">=16.0.0"
|
|
51
|
+
},
|
|
52
|
+
"os": ["darwin", "linux", "win32"],
|
|
53
|
+
"dependencies": {
|
|
54
|
+
"optional": {
|
|
55
|
+
"jq": ">=1.6",
|
|
56
|
+
"bash": ">=4.0"
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
}
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 oh-my-claude
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,482 @@
|
|
|
1
|
+
# oh-my-claude 🏔️
|
|
2
|
+
|
|
3
|
+
[](https://opensource.org/licenses/MIT)
|
|
4
|
+
[](https://claude.ai)
|
|
5
|
+
[](CONTRIBUTING.md)
|
|
6
|
+
[](README.md)
|
|
7
|
+
[](README_EN.md)
|
|
8
|
+
|
|
9
|
+
> 基于中国传统文化的 Claude Code 智能编排插件
|
|
10
|
+
|
|
11
|
+
```
|
|
12
|
+
太行、王屋二山,方七百里,高万仞。
|
|
13
|
+
北山愚公者,年且九十,面山而居...
|
|
14
|
+
虽我之死,有子存焉;子又生孙,孙又生子;
|
|
15
|
+
子子孙孙无穷匮也,而山不加增,何苦而不平?
|
|
16
|
+
|
|
17
|
+
—— 《列子·汤问》
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## 🌟 项目理念
|
|
21
|
+
|
|
22
|
+
### 致敬 oh-my-opencode
|
|
23
|
+
|
|
24
|
+
本项目灵感来源于 [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode),一个优秀的 Claude Code 插件生态项目。我们在学习借鉴的基础上,融入中国传统文化元素,打造了这个具有东方特色的版本。
|
|
25
|
+
|
|
26
|
+
### 愚公精神
|
|
27
|
+
|
|
28
|
+
> 子子孙孙无穷匮也,而山不加增,何苦而不平?
|
|
29
|
+
|
|
30
|
+
oh-my-claude 的核心理念源自「愚公移山」的精神:**只要方向正确,坚持就会成功。**
|
|
31
|
+
|
|
32
|
+
- 🏔️ **持续执行** - 任务未完成,绝不停止
|
|
33
|
+
- 🎯 **目标导向** - 分解大任务,逐个击破
|
|
34
|
+
- 💪 **永不放弃** - 遇到问题,调整策略继续前进
|
|
35
|
+
|
|
36
|
+
## ✨ 特性
|
|
37
|
+
|
|
38
|
+
### 🎭 智能 Agent 体系
|
|
39
|
+
|
|
40
|
+
基于中国传统文化人物的专业化 Agent:
|
|
41
|
+
|
|
42
|
+
| Agent | 名称 | 专长 | 命令 |
|
|
43
|
+
|-------|------|------|------|
|
|
44
|
+
| 🏔️ | **愚公** (YuGong) | 主编排,大规模任务 | `/yugong` `/yishan` |
|
|
45
|
+
| 🎯 | **诸葛** (ZhuGe) | 战略顾问,架构设计 | `/zhuge` `/longzhong` |
|
|
46
|
+
| 🔧 | **鲁班** (LuBan) | 精工巧匠,代码实现 | `/luban` `/qiaogong` |
|
|
47
|
+
| 🔍 | **悟空** (WuKong) | 代码侦察,快速探索 | `/wukong` `/huoyan` |
|
|
48
|
+
| 🩺 | **扁鹊** (BianQue) | Bug 诊断,问题修复 | `/bianque` `/wangwen` |
|
|
49
|
+
| 🛡️ | **墨子** (MoZi) | 安全审计,防御编程 | `/mozi` `/security` |
|
|
50
|
+
| ⚔️ | **孙子** (SunZi) | 性能优化,系统调优 | `/sunzi` `/perf` |
|
|
51
|
+
| 📜 | **司马迁** (SimaQian) | 文档撰写,变更记录 | `/simaqian` `/doc` |
|
|
52
|
+
| ⛵ | **郑和** (ZhengHe) | API 集成,外部服务 | `/zhenghe` `/api` |
|
|
53
|
+
| 🔭 | **张衡** (ZhangHeng) | 系统监控,可观测性 | `/zhangheng` `/monitor` |
|
|
54
|
+
| 🌊 | **李冰** (LiBing) | DevOps,基础设施 | `/libing` `/devops` |
|
|
55
|
+
| ☯️ | **老子** (LaoZi) | 代码简化,Clean Code | `/laozi` `/simplify` |
|
|
56
|
+
| ⚖️ | **包拯** (BaoZheng) | 测试专家,TDD | `/baozheng` `/test` |
|
|
57
|
+
| 🪞 | **魏征** (WeiZheng) | 代码审查,规范检查 | `/weizheng` `/review` |
|
|
58
|
+
| 📊 | **仓颉** (CangJie) | 数据库设计,SQL 优化 | `/cangjie` `/db` |
|
|
59
|
+
| ✨ | **李白** (LiBai) | 需求分析,用户故事 | `/libai` `/poet` |
|
|
60
|
+
| 🎨 | **顾恺之** (GuKaiZhi) | UI/UX 设计,界面美学 | `/gukaizhi` `/painter` |
|
|
61
|
+
| 🌙 | **嫦娥** (ChangE) | 云服务,DevOps 部署 | `/change` `/cloud` |
|
|
62
|
+
|
|
63
|
+
### 🔄 愚公移山模式
|
|
64
|
+
|
|
65
|
+
核心特性:**不完成,不罢休**
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
# 启动愚公移山模式
|
|
69
|
+
/yishan 重构整个认证模块
|
|
70
|
+
|
|
71
|
+
# 或使用英文
|
|
72
|
+
/ultrawork refactor the entire auth module
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
- ✅ 自动任务分解和追踪
|
|
76
|
+
- ✅ Todo 强制执行(未完成不能停止)
|
|
77
|
+
- ✅ 智能错误恢复
|
|
78
|
+
- ✅ 进度透明报告
|
|
79
|
+
|
|
80
|
+
### 🌐 中英双语支持
|
|
81
|
+
|
|
82
|
+
所有命令都支持中英文:
|
|
83
|
+
|
|
84
|
+
```bash
|
|
85
|
+
# 中文
|
|
86
|
+
/愚公 实现用户登录功能
|
|
87
|
+
/诸葛 分析这个架构设计
|
|
88
|
+
/扁鹊 这个报错怎么解决
|
|
89
|
+
|
|
90
|
+
# 英文
|
|
91
|
+
/persist implement user login
|
|
92
|
+
/strategy analyze this architecture
|
|
93
|
+
/debug how to fix this error
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
### 🪝 智能 Hook 系统
|
|
97
|
+
|
|
98
|
+
- **Todo 强制执行器**:检测未完成任务,阻止过早停止
|
|
99
|
+
- **关键词检测器**:自动激活相应模式
|
|
100
|
+
|
|
101
|
+
## 📦 安装
|
|
102
|
+
|
|
103
|
+
提供多种安装方式,选择最适合你的:
|
|
104
|
+
|
|
105
|
+
### 方式一:npm / npx(推荐)
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
# 使用 npx 直接安装(无需全局安装)
|
|
109
|
+
npx claude-pangu install
|
|
110
|
+
|
|
111
|
+
# 或全局安装后使用
|
|
112
|
+
npm install -g claude-pangu
|
|
113
|
+
claude-pangu install
|
|
114
|
+
|
|
115
|
+
# 也可以使用 bun / pnpm
|
|
116
|
+
bunx claude-pangu install
|
|
117
|
+
pnpm dlx claude-pangu install
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
> 💡 **包名说明**: npm 包名为 `claude-pangu`(盘古开天辟地),项目名仍为 `oh-my-claude`
|
|
121
|
+
|
|
122
|
+
### 方式二:一键安装
|
|
123
|
+
|
|
124
|
+
**macOS / Linux:**
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
curl -fsSL https://raw.githubusercontent.com/ZDragon17/oh-my-claude/main/scripts/install.sh | bash
|
|
128
|
+
```
|
|
129
|
+
|
|
130
|
+
**Windows (PowerShell):**
|
|
131
|
+
|
|
132
|
+
```powershell
|
|
133
|
+
irm https://raw.githubusercontent.com/ZDragon17/oh-my-claude/main/scripts/install.ps1 | iex
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### 方式四:Homebrew (macOS)
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
# 添加 tap(首次使用)
|
|
140
|
+
brew tap ZDragon17/oh-my-claude https://github.com/ZDragon17/oh-my-claude
|
|
141
|
+
|
|
142
|
+
# 安装
|
|
143
|
+
brew install oh-my-claude
|
|
144
|
+
|
|
145
|
+
# 注册插件
|
|
146
|
+
claude plugins install ~/.claude/plugins/oh-my-claude
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
### 方式五:Scoop (Windows)
|
|
150
|
+
|
|
151
|
+
```powershell
|
|
152
|
+
# 添加 bucket(首次使用)
|
|
153
|
+
scoop bucket add oh-my-claude https://github.com/ZDragon17/oh-my-claude
|
|
154
|
+
|
|
155
|
+
# 安装
|
|
156
|
+
scoop install oh-my-claude
|
|
157
|
+
|
|
158
|
+
# 注册插件
|
|
159
|
+
claude plugins install $env:USERPROFILE\.claude\plugins\oh-my-claude
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### 方式六:手动安装
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
# 克隆项目
|
|
166
|
+
git clone https://github.com/ZDragon17/oh-my-claude.git
|
|
167
|
+
|
|
168
|
+
# 进入目录
|
|
169
|
+
cd oh-my-claude
|
|
170
|
+
|
|
171
|
+
# 安装为 Claude Code 插件
|
|
172
|
+
claude plugins install .
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
### 验证安装
|
|
176
|
+
|
|
177
|
+
```bash
|
|
178
|
+
# 在 Claude Code 中输入
|
|
179
|
+
/yishan 你好
|
|
180
|
+
|
|
181
|
+
# 如果看到愚公移山模式的响应,说明安装成功
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
## 🚀 快速开始
|
|
185
|
+
|
|
186
|
+
### 1. 愚公移山 - 大规模任务
|
|
187
|
+
|
|
188
|
+
```bash
|
|
189
|
+
/yishan 重构整个用户模块,包括:
|
|
190
|
+
- 用户注册
|
|
191
|
+
- 用户登录
|
|
192
|
+
- 密码重置
|
|
193
|
+
- 个人资料管理
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
愚公会自动:
|
|
197
|
+
1. 分解任务为可执行的 TODO
|
|
198
|
+
2. 逐个完成子任务
|
|
199
|
+
3. 遇到问题调整策略继续
|
|
200
|
+
4. 所有任务完成才停止
|
|
201
|
+
|
|
202
|
+
### 2. 诸葛顾问 - 架构设计
|
|
203
|
+
|
|
204
|
+
```bash
|
|
205
|
+
/zhuge 我们的用户系统应该如何设计?需要考虑:
|
|
206
|
+
- 多租户支持
|
|
207
|
+
- 权限管理
|
|
208
|
+
- 高可用性
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
诸葛会提供:
|
|
212
|
+
- 架构方案对比
|
|
213
|
+
- 技术选型建议
|
|
214
|
+
- 风险评估
|
|
215
|
+
- 实施路线图
|
|
216
|
+
|
|
217
|
+
### 3. 扁鹊诊断 - Bug 修复
|
|
218
|
+
|
|
219
|
+
```bash
|
|
220
|
+
/bianque TypeError: Cannot read property 'name' of undefined
|
|
221
|
+
at UserService.getProfile (user.service.ts:42)
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
扁鹊会进行:
|
|
225
|
+
- 望闻问切诊断
|
|
226
|
+
- 根因分析
|
|
227
|
+
- 修复方案
|
|
228
|
+
- 预防建议
|
|
229
|
+
|
|
230
|
+
### 4. 悟空侦察 - 代码探索
|
|
231
|
+
|
|
232
|
+
```bash
|
|
233
|
+
/wukong 找到所有处理用户认证的代码
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
悟空会快速:
|
|
237
|
+
- 定位相关文件
|
|
238
|
+
- 追踪调用链
|
|
239
|
+
- 汇报发现结果
|
|
240
|
+
|
|
241
|
+
### 5. 鲁班巧工 - 精密实现
|
|
242
|
+
|
|
243
|
+
```bash
|
|
244
|
+
/luban 实现一个带动画效果的 Toast 组件
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
鲁班会精心:
|
|
248
|
+
- 设计组件结构
|
|
249
|
+
- 实现核心功能
|
|
250
|
+
- 优化代码质量
|
|
251
|
+
|
|
252
|
+
## 📁 项目结构
|
|
253
|
+
|
|
254
|
+
```
|
|
255
|
+
oh-my-claude/
|
|
256
|
+
├── .claude-plugin/
|
|
257
|
+
│ └── plugin.json # 插件配置
|
|
258
|
+
├── .github/ # GitHub 配置
|
|
259
|
+
│ ├── ISSUE_TEMPLATE/ # Issue 模板
|
|
260
|
+
│ └── PULL_REQUEST_TEMPLATE.md
|
|
261
|
+
├── agents/ # Agent 定义 (15 个)
|
|
262
|
+
│ ├── yugong.md # 愚公 - 主编排
|
|
263
|
+
│ ├── zhuge.md # 诸葛 - 战略顾问
|
|
264
|
+
│ ├── luban.md # 鲁班 - 精工巧匠
|
|
265
|
+
│ ├── wukong.md # 悟空 - 代码侦察
|
|
266
|
+
│ ├── bianque.md # 扁鹊 - Bug 诊断
|
|
267
|
+
│ ├── mozi.md # 墨子 - 安全审计
|
|
268
|
+
│ ├── sunzi.md # 孙子 - 性能优化
|
|
269
|
+
│ ├── simaqian.md # 司马迁 - 文档撰写
|
|
270
|
+
│ ├── zhenghe.md # 郑和 - API 集成
|
|
271
|
+
│ ├── zhangheng.md # 张衡 - 系统监控
|
|
272
|
+
│ ├── libing.md # 李冰 - DevOps
|
|
273
|
+
│ ├── laozi.md # 老子 - Clean Code
|
|
274
|
+
│ ├── baozheng.md # 包拯 - 测试专家
|
|
275
|
+
│ ├── weizheng.md # 魏征 - 代码审查
|
|
276
|
+
│ └── cangjie.md # 仓颉 - 数据库设计
|
|
277
|
+
├── commands/ # 斜杠命令
|
|
278
|
+
│ ├── yugong.md # /yugong 愚公模式
|
|
279
|
+
│ ├── yishan.md # /yishan 移山模式
|
|
280
|
+
│ ├── team.md # /team 团队协作
|
|
281
|
+
│ ├── progress.md # /progress 进度面板
|
|
282
|
+
│ └── ... # 其他 Agent 命令
|
|
283
|
+
├── scripts/ # 安装脚本
|
|
284
|
+
│ ├── cli.js # CLI 命令行工具
|
|
285
|
+
│ ├── install.js # 独立安装脚本
|
|
286
|
+
│ ├── uninstall.js # 独立卸载脚本
|
|
287
|
+
│ ├── install.sh # Bash 一键安装
|
|
288
|
+
│ ├── install.ps1 # PowerShell 安装
|
|
289
|
+
│ ├── postinstall.js # npm 安装后脚本
|
|
290
|
+
│ └── sync-version.js # 版本同步工具
|
|
291
|
+
├── homebrew/ # Homebrew 配置
|
|
292
|
+
│ └── oh-my-claude.rb # Homebrew Formula
|
|
293
|
+
├── scoop/ # Scoop 配置
|
|
294
|
+
│ └── oh-my-claude.json # Scoop manifest
|
|
295
|
+
├── skills/ # 技能定义
|
|
296
|
+
│ ├── bilingual/ # 双语支持
|
|
297
|
+
│ └── progress/ # 进度面板
|
|
298
|
+
├── hooks/ # Hook 脚本
|
|
299
|
+
│ ├── hooks.json # Hook 配置
|
|
300
|
+
│ ├── todo-enforcer.sh # Todo 强制执行
|
|
301
|
+
│ ├── keyword-detector.sh # 关键词检测
|
|
302
|
+
│ └── progress-notifier.sh # 进度通知
|
|
303
|
+
├── docs/ # 文档
|
|
304
|
+
│ └── AGENT_PROTOCOL.md # Agent 协作协议
|
|
305
|
+
├── .npmignore # npm 发布排除配置
|
|
306
|
+
├── package.json # npm 包配置
|
|
307
|
+
├── CHANGELOG.md # 变更日志
|
|
308
|
+
├── CONTRIBUTING.md # 贡献指南
|
|
309
|
+
├── TROUBLESHOOTING.md # 故障排查指南
|
|
310
|
+
├── LICENSE # MIT 许可证
|
|
311
|
+
├── README.md # 中文文档
|
|
312
|
+
└── README_EN.md # English documentation
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
## 🎯 命令速查
|
|
316
|
+
|
|
317
|
+
### Agent 命令
|
|
318
|
+
|
|
319
|
+
| 命令 | 别名 | 功能 |
|
|
320
|
+
|------|------|------|
|
|
321
|
+
| `/yugong` | `/yishan` `/persist` `/ultrawork` `/ulw` | 启动愚公移山模式 |
|
|
322
|
+
| `/zhuge` | `/longzhong` `/strategy` `/consult` | 召唤诸葛顾问 |
|
|
323
|
+
| `/luban` | `/qiaogong` `/craft` `/frontend` | 召唤鲁班巧匠 |
|
|
324
|
+
| `/wukong` | `/huoyan` `/explore` `/scout` | 召唤悟空侦察 |
|
|
325
|
+
| `/bianque` | `/wangwen` `/debug` `/diagnose` | 召唤扁鹊诊断 |
|
|
326
|
+
| `/mozi` | `/security` `/audit` `/安全` | 召唤墨子安全 |
|
|
327
|
+
| `/sunzi` | `/performance` `/perf` `/性能` `/优化` | 召唤孙子性能 |
|
|
328
|
+
| `/simaqian` | `/shiji` `/document` `/doc` `/司马迁` `/史记` | 召唤司马迁史官 |
|
|
329
|
+
| `/zhenghe` | `/xiyang` `/api` `/integrate` `/郑和` `/接口` | 召唤郑和 API |
|
|
330
|
+
| `/zhangheng` | `/didongyi` `/monitor` `/observe` `/张衡` `/监控` | 召唤张衡监控 |
|
|
331
|
+
| `/libing` | `/dujiangyan` `/devops` `/cicd` `/李冰` `/运维` | 召唤李冰 DevOps |
|
|
332
|
+
| `/laozi` | `/daodejing` `/simplify` `/clean` `/老子` `/简洁` `/至简` | 召唤老子简洁大师 |
|
|
333
|
+
| `/baozheng` | `/kaifeng` `/test` `/tdd` `/包拯` `/测试` | 召唤包拯测试专家 |
|
|
334
|
+
| `/weizheng` | `/jian` `/review` `/cr` `/魏征` `/审查` | 召唤魏征代码审查 |
|
|
335
|
+
| `/cangjie` | `/zaozi` `/database` `/db` `/sql` `/仓颉` `/数据库` | 召唤仓颉数据库专家 |
|
|
336
|
+
|
|
337
|
+
### 工具命令
|
|
338
|
+
|
|
339
|
+
| 命令 | 别名 | 功能 |
|
|
340
|
+
|------|------|------|
|
|
341
|
+
| `/progress` | `/进度` `/dashboard` `/面板` `/status` | 📊 可视化进度面板 |
|
|
342
|
+
|
|
343
|
+
### 关键词触发
|
|
344
|
+
|
|
345
|
+
在任何提示中包含这些关键词会自动激活相应模式:
|
|
346
|
+
|
|
347
|
+
| 关键词 | 触发模式 |
|
|
348
|
+
|--------|----------|
|
|
349
|
+
| `ultrawork` `ulw` `移山` `yishan` `persist` `愚公` `yugong` | 愚公移山模式 |
|
|
350
|
+
| `架构` `设计` `策略` `architecture` `design` `strategy` `诸葛` `zhuge` `consult` `规划` `planning` | 诸葛顾问提示 |
|
|
351
|
+
| `fix bug` `fix error` `debug` `调试` `报错` `异常` `exception` `扁鹊` `bianque` `诊断` `diagnose` | 扁鹊诊断提示 |
|
|
352
|
+
| `安全` `漏洞` `注入` `security` `vulnerability` `injection` `墨子` `mozi` `audit` `审计` | 墨子安全提示 |
|
|
353
|
+
| `性能` `优化` `慢` `performance` `optimize` `slow` `孙子` `sunzi` `perf` `瓶颈` `bottleneck` | 孙子性能提示 |
|
|
354
|
+
| `文档` `注释` `记录` `document` `comment` `readme` `changelog` `司马迁` `simaqian` `史记` | 司马迁文档提示 |
|
|
355
|
+
| `API` `接口` `集成` `对接` `integrate` `webhook` `sdk` `郑和` `zhenghe` | 郑和 API 提示 |
|
|
356
|
+
| `监控` `日志` `告警` `追踪` `monitor` `logging` `alert` `张衡` `zhangheng` | 张衡监控提示 |
|
|
357
|
+
| `DevOps` `CI/CD` `部署` `运维` `docker` `kubernetes` `李冰` `libing` | 李冰 DevOps 提示 |
|
|
358
|
+
| `简洁` `简化` `重构` `KISS` `YAGNI` `DRY` `clean code` `老子` `laozi` `至简` | 老子简洁提示 |
|
|
359
|
+
| `测试` `单元测试` `test` `TDD` `jest` `pytest` `coverage` `包拯` `baozheng` | 包拯测试提示 |
|
|
360
|
+
| `审查` `code review` `review` `CR` `PR` `魏征` `weizheng` | 魏征审查提示 |
|
|
361
|
+
| `数据库` `database` `SQL` `表设计` `索引` `migration` `仓颉` `cangjie` | 仓颉数据库提示 |
|
|
362
|
+
|
|
363
|
+
## 🔧 配置
|
|
364
|
+
|
|
365
|
+
### 自定义 Agent
|
|
366
|
+
|
|
367
|
+
在 `~/.claude/agents/` 创建自定义 Agent:
|
|
368
|
+
|
|
369
|
+
```markdown
|
|
370
|
+
---
|
|
371
|
+
name: custom-agent
|
|
372
|
+
description: 我的自定义 Agent
|
|
373
|
+
allowed-tools:
|
|
374
|
+
- Read
|
|
375
|
+
- Write
|
|
376
|
+
- Edit
|
|
377
|
+
model: sonnet
|
|
378
|
+
---
|
|
379
|
+
|
|
380
|
+
# 自定义 Agent
|
|
381
|
+
|
|
382
|
+
你的自定义指令...
|
|
383
|
+
```
|
|
384
|
+
|
|
385
|
+
### 禁用 Hook
|
|
386
|
+
|
|
387
|
+
编辑 `hooks/hooks.json` 移除不需要的 Hook。
|
|
388
|
+
|
|
389
|
+
### 修改关键词
|
|
390
|
+
|
|
391
|
+
编辑 `hooks/keyword-detector.sh` 自定义触发关键词。
|
|
392
|
+
|
|
393
|
+
## 📖 文化背景
|
|
394
|
+
|
|
395
|
+
### 愚公 (YuGong)
|
|
396
|
+
《列子·汤问》中的老者,年近九十仍坚持移山。最终感动天帝,派夸娥氏二子背走大山。象征坚持不懈的精神。
|
|
397
|
+
|
|
398
|
+
### 诸葛 (ZhuGe)
|
|
399
|
+
三国时期蜀汉丞相诸葛亮,字孔明。"未出茅庐,已知三分天下",是中国历史上最著名的战略家。
|
|
400
|
+
|
|
401
|
+
### 鲁班 (LuBan)
|
|
402
|
+
春秋战国时期工匠,发明了锯子、墨斗、刨子等工具。被尊为中国工匠的始祖,"百工圣祖"。
|
|
403
|
+
|
|
404
|
+
### 悟空 (WuKong)
|
|
405
|
+
《西游记》中的孙悟空,拥有火眼金睛和七十二变。能识破一切伪装,行动迅速敏捷。
|
|
406
|
+
|
|
407
|
+
### 扁鹊 (BianQue)
|
|
408
|
+
战国时期神医,创立望闻问切四诊法。医术高超,能起死回生。
|
|
409
|
+
|
|
410
|
+
### 墨子 (MoZi)
|
|
411
|
+
墨家学派创始人,主张"兼爱非攻"。精通防御工事和守城策略,以防御智慧著称。
|
|
412
|
+
|
|
413
|
+
### 孙子 (SunZi)
|
|
414
|
+
《孙子兵法》作者,"知己知彼,百战不殆"。世界公认的军事战略经典,强调分析和策略。
|
|
415
|
+
|
|
416
|
+
### 司马迁 (SimaQian)
|
|
417
|
+
西汉史学家,被誉为"史圣"。著有《史记》,开创纪传体通史先河,"究天人之际,通古今之变,成一家之言"。
|
|
418
|
+
|
|
419
|
+
### 郑和 (ZhengHe)
|
|
420
|
+
明代伟大航海家,七下西洋,远航至东南亚、印度洋、波斯湾和非洲东海岸。他的船队促进了中外文化交流和贸易往来,体现了"开放、探索、连接"的精神。
|
|
421
|
+
|
|
422
|
+
### 张衡 (ZhangHeng)
|
|
423
|
+
东汉杰出科学家、天文学家。发明了世界上第一台地震仪——候风地动仪,能够感知远方地震并指示方向。还改进了浑天仪,精确测量天体运行,体现了"观测、感知、预警"的智慧。
|
|
424
|
+
|
|
425
|
+
### 李冰 (LiBing)
|
|
426
|
+
战国时期蜀郡太守,主持修建都江堰水利工程。都江堰历经两千多年仍在发挥作用,体现了"顺势而为、分而治之"的工程智慧,被誉为世界水利史上的奇迹。
|
|
427
|
+
|
|
428
|
+
### 老子 (LaoZi)
|
|
429
|
+
道家学派创始人,著有《道德经》。他提出"道法自然"、"无为而治"的哲学思想,强调"大道至简"——最高深的道理往往是最简单的。老子的智慧在于:去除繁杂,回归本质。
|
|
430
|
+
|
|
431
|
+
### 包拯 (BaoZheng)
|
|
432
|
+
北宋名臣,人称"包青天"、"包公"。以铁面无私、明察秋毫著称,任开封府尹时公正严明,不畏权贵。龙头铡、虎头铡、狗头铡象征对各阶层的公正执法,体现"公正无私、明察秋毫"的精神。
|
|
433
|
+
|
|
434
|
+
### 魏征 (WeiZheng)
|
|
435
|
+
唐代著名谏臣,辅佐唐太宗开创贞观之治。以直言敢谏著称,唐太宗称其为"镜子"。"以铜为镜,可以正衣冠;以人为镜,可以明得失",体现"直言不讳、明辨是非"的精神。
|
|
436
|
+
|
|
437
|
+
### 仓颉 (CangJie)
|
|
438
|
+
传说中的造字始祖,黄帝时期史官。相传他有四只眼睛,仰观天象、俯察鸟兽之迹,创造了汉字。体现"观察规律、创造结构"的智慧。
|
|
439
|
+
|
|
440
|
+
## 🗺️ 路线图
|
|
441
|
+
|
|
442
|
+
- [x] v0.1.0 - 基础 Agent 体系(5 个 Agent)
|
|
443
|
+
- [x] v0.2.0 - Agent 协作增强(`@agent` 调用语法、`/team` 命令)
|
|
444
|
+
- [x] v0.3.0 - 更多 Agent(墨子、孙子)
|
|
445
|
+
- [x] v0.4.0 - 可视化进度面板(`/progress` 命令)
|
|
446
|
+
- [x] v0.5.0 - 更多 Agent(司马迁)
|
|
447
|
+
- [x] v0.6.0 - 更多 Agent(郑和、张衡、李冰)
|
|
448
|
+
- [x] v0.7.0 - 更多 Agent(老子)
|
|
449
|
+
- [x] v0.8.0 - 更多 Agent(包拯、魏征、仓颉)
|
|
450
|
+
- [ ] v1.0.0 - 稳定版发布
|
|
451
|
+
|
|
452
|
+
## 🤝 贡献
|
|
453
|
+
|
|
454
|
+
欢迎贡献!请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解如何参与。
|
|
455
|
+
|
|
456
|
+
你可以:
|
|
457
|
+
|
|
458
|
+
1. 🐛 提交 Issue 报告问题或建议
|
|
459
|
+
2. 🔧 Fork 后提交 Pull Request
|
|
460
|
+
3. 🎭 添加新的 Agent 或命令
|
|
461
|
+
4. 📝 改进文档
|
|
462
|
+
5. 🌐 完善国际化支持
|
|
463
|
+
|
|
464
|
+
## 📜 许可证
|
|
465
|
+
|
|
466
|
+
[MIT License](LICENSE) © 2025 oh-my-claude
|
|
467
|
+
|
|
468
|
+
## 🙏 致谢
|
|
469
|
+
|
|
470
|
+
- [Anthropic](https://anthropic.com) - Claude Code
|
|
471
|
+
- [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) - 灵感来源
|
|
472
|
+
- 中国传统文化 - 智慧源泉
|
|
473
|
+
|
|
474
|
+
---
|
|
475
|
+
|
|
476
|
+
<div align="center">
|
|
477
|
+
|
|
478
|
+
**愚公精神:坚持必将成功 🏔️**
|
|
479
|
+
|
|
480
|
+
[报告问题](https://github.com/ZDragon17/oh-my-claude/issues) · [提出建议](https://github.com/ZDragon17/oh-my-claude/issues) · [贡献代码](CONTRIBUTING.md)
|
|
481
|
+
|
|
482
|
+
</div>
|