sumulige-claude 1.0.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/AGENTS.md +42 -0
- package/.claude/README.md +142 -0
- package/.claude/rag/skill-index.json +15 -0
- package/.claude/settings.local.json +36 -0
- package/.claude/skills/api-tester/SKILL.md +61 -0
- package/.claude/skills/api-tester/examples/basic.md +3 -0
- package/.claude/skills/api-tester/metadata.yaml +30 -0
- package/.claude/skills/api-tester/templates/default.md +3 -0
- package/AGENTS.md +33 -0
- package/README.md +857 -0
- package/cli.js +814 -0
- package/development/todos/INDEX.md +114 -0
- package/development/todos/active/_README.md +49 -0
- package/development/todos/active/todo-system.md +37 -0
- package/development/todos/archived/_README.md +11 -0
- package/development/todos/backlog/_README.md +11 -0
- package/development/todos/backlog/mcp-integration.md +35 -0
- package/development/todos/completed/_README.md +11 -0
- package/development/todos/completed/boris-optimizations.md +39 -0
- package/package.json +35 -0
- package/template/.claude/CLAUDE-template.md +138 -0
- package/template/.claude/README.md +142 -0
- package/template/.claude/boris-optimizations.md +167 -0
- package/template/.claude/commands/commit-push-pr.md +59 -0
- package/template/.claude/commands/commit.md +53 -0
- package/template/.claude/commands/pr.md +76 -0
- package/template/.claude/commands/review.md +61 -0
- package/template/.claude/commands/sessions.md +62 -0
- package/template/.claude/commands/skill-create.md +131 -0
- package/template/.claude/commands/test.md +56 -0
- package/template/.claude/commands/todos.md +99 -0
- package/template/.claude/commands/verify-work.md +63 -0
- package/template/.claude/hooks/code-formatter.cjs +187 -0
- package/template/.claude/hooks/multi-session.cjs +181 -0
- package/template/.claude/hooks/project-kickoff.cjs +114 -0
- package/template/.claude/hooks/rag-skill-loader.cjs +159 -0
- package/template/.claude/hooks/session-end.sh +61 -0
- package/template/.claude/hooks/sync-to-log.sh +83 -0
- package/template/.claude/hooks/thinking-silent.cjs +145 -0
- package/template/.claude/hooks/tl-summary.sh +54 -0
- package/template/.claude/hooks/todo-manager.cjs +248 -0
- package/template/.claude/hooks/verify-work.cjs +134 -0
- package/template/.claude/rag/skill-index.json +135 -0
- package/template/.claude/settings.json +33 -0
- package/template/.claude/skills/SKILLS.md +145 -0
- package/template/.claude/skills/examples/README.md +47 -0
- package/template/.claude/skills/examples/basic-task.md +67 -0
- package/template/.claude/skills/examples/bug-fix-workflow.md +92 -0
- package/template/.claude/skills/examples/feature-development.md +81 -0
- package/template/.claude/skills/manus-kickoff/SKILL.md +128 -0
- package/template/.claude/skills/manus-kickoff/examples/basic.md +84 -0
- package/template/.claude/skills/manus-kickoff/metadata.yaml +33 -0
- package/template/.claude/skills/manus-kickoff/templates/PROJECT_KICKOFF.md +89 -0
- package/template/.claude/skills/manus-kickoff/templates/PROJECT_PROPOSAL.md +227 -0
- package/template/.claude/skills/manus-kickoff/templates/TASK_PLAN.md +121 -0
- package/template/.claude/skills/template/SKILL.md +61 -0
- package/template/.claude/skills/template/metadata.yaml +30 -0
- package/template/.claude/templates/PROJECT_KICKOFF.md +89 -0
- package/template/.claude/templates/PROJECT_PROPOSAL.md +227 -0
- package/template/.claude/templates/TASK_PLAN.md +121 -0
- package/template/.claude/thinking-routes/QUICKREF.md +98 -0
- package/template/CLAUDE-template.md +114 -0
- package/template/README.md +148 -0
- package/template/development/todos/INDEX.md +63 -0
- package/template/development/todos/active/_README.md +49 -0
- package/template/development/todos/archived/_README.md +11 -0
- package/template/development/todos/backlog/_README.md +11 -0
- package/template/development/todos/completed/_README.md +11 -0
- package/template/init.sh +150 -0
- package/template/project-paradigm.md +313 -0
- package/template/prompts/how-to-find.md +163 -0
- package/template/thinkinglens-silent.md +138 -0
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# 项目任务追踪系统
|
|
2
|
+
|
|
3
|
+
> 本目录由 AI 自动维护,记录项目开发任务和进度
|
|
4
|
+
|
|
5
|
+
@version: 1.0.0
|
|
6
|
+
|
|
7
|
+
## 目录结构
|
|
8
|
+
|
|
9
|
+
```
|
|
10
|
+
development/todos/
|
|
11
|
+
├── INDEX.md # 本文件 - 任务总览
|
|
12
|
+
├── active/ # 进行中的任务
|
|
13
|
+
├── completed/ # 已完成的任务
|
|
14
|
+
├── backlog/ # 待规划的任务
|
|
15
|
+
└── archived/ # 已归档的任务
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## 任务状态说明
|
|
19
|
+
|
|
20
|
+
| 状态 | 目录 | 说明 |
|
|
21
|
+
|------|------|------|
|
|
22
|
+
| 🚧 进行中 | `active/` | 当前正在开发的任务 |
|
|
23
|
+
| ✅ 已完成 | `completed/` | 完成的任务 |
|
|
24
|
+
| 📋 待办 | `backlog/` | 规划中或待分配的任务 |
|
|
25
|
+
| 📦 已归档 | `archived/` | 不再活跃的历史任务 |
|
|
26
|
+
|
|
27
|
+
## 快速跳转
|
|
28
|
+
|
|
29
|
+
- [🚧 进行中的任务](./active/) - 当前开发重点
|
|
30
|
+
- [✅ 已完成的任务](./completed/) - 最近完成
|
|
31
|
+
- [📋 待办任务](./backlog/) - 待规划
|
|
32
|
+
- [📦 已归档](./archived/) - 历史记录
|
|
33
|
+
|
|
34
|
+
## 使用方式
|
|
35
|
+
|
|
36
|
+
### 查看任务
|
|
37
|
+
点击上方链接跳转到对应目录,或使用:
|
|
38
|
+
```bash
|
|
39
|
+
# 查看进行中的任务
|
|
40
|
+
cat development/todos/active/*.md
|
|
41
|
+
|
|
42
|
+
# 查看特定任务
|
|
43
|
+
cat development/todos/active/feature-name.md
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
### 创建新任务
|
|
47
|
+
在 Claude Code 中:
|
|
48
|
+
```
|
|
49
|
+
创建一个新任务:实现用户登录功能
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
AI 会自动在 `active/` 目录创建对应的任务文件。
|
|
53
|
+
|
|
54
|
+
### 更新任务状态
|
|
55
|
+
```
|
|
56
|
+
将 [任务名] 标记为完成
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
AI 会自动将任务移动到 `completed/` 目录。
|
|
60
|
+
|
|
61
|
+
---
|
|
62
|
+
|
|
63
|
+
> **维护说明**: 本系统由 AI 自动维护,请勿手动编辑(除非你知道自己在做什么)
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
# 进行中的任务
|
|
2
|
+
|
|
3
|
+
> 当前正在开发的任务
|
|
4
|
+
|
|
5
|
+
@version: 1.0.0
|
|
6
|
+
|
|
7
|
+
本目录包含所有进行中的任务。每个任务是一个独立的 Markdown 文件。
|
|
8
|
+
|
|
9
|
+
## 任务模板
|
|
10
|
+
|
|
11
|
+
```markdown
|
|
12
|
+
# [任务名称]
|
|
13
|
+
|
|
14
|
+
**状态**: 🚧 进行中
|
|
15
|
+
**优先级**: P0/P1/P2/P3
|
|
16
|
+
**负责人**: AI/Human
|
|
17
|
+
**分支**: `feature/xxx`
|
|
18
|
+
**创建时间**: 2026-01-11
|
|
19
|
+
**预计完成**: 2026-01-15
|
|
20
|
+
|
|
21
|
+
## 描述
|
|
22
|
+
|
|
23
|
+
[任务描述]
|
|
24
|
+
|
|
25
|
+
## 子任务
|
|
26
|
+
|
|
27
|
+
- [ ] 子任务 1
|
|
28
|
+
- [ ] 子任务 2
|
|
29
|
+
- [ ] 子任务 3
|
|
30
|
+
|
|
31
|
+
## 依赖
|
|
32
|
+
|
|
33
|
+
- [依赖的其他任务或资源]
|
|
34
|
+
|
|
35
|
+
## 进度
|
|
36
|
+
|
|
37
|
+
- [x] 初始规划
|
|
38
|
+
- [ ] 开发中
|
|
39
|
+
- [ ] 测试
|
|
40
|
+
- [ ] 代码审查
|
|
41
|
+
|
|
42
|
+
## 备注
|
|
43
|
+
|
|
44
|
+
[其他备注信息]
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 返回
|
|
48
|
+
|
|
49
|
+
[返回总览](../INDEX.md)
|
package/template/init.sh
ADDED
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
#!/bin/bash
|
|
2
|
+
# Claude Code 项目模板初始化脚本
|
|
3
|
+
# 用法: ./init.sh /目标项目路径
|
|
4
|
+
|
|
5
|
+
set -e
|
|
6
|
+
|
|
7
|
+
TARGET_DIR="${1:-.}"
|
|
8
|
+
TEMPLATE_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
9
|
+
|
|
10
|
+
echo "🚀 初始化 Claude Code 项目模板..."
|
|
11
|
+
echo " 目标目录: $TARGET_DIR"
|
|
12
|
+
|
|
13
|
+
# 创建目录结构
|
|
14
|
+
echo "📁 创建目录结构..."
|
|
15
|
+
mkdir -p "$TARGET_DIR/.claude/hooks"
|
|
16
|
+
mkdir -p "$TARGET_DIR/.claude/thinking-routes"
|
|
17
|
+
mkdir -p "$TARGET_DIR/.claude/skills"
|
|
18
|
+
mkdir -p "$TARGET_DIR/.claude/rag"
|
|
19
|
+
mkdir -p "$TARGET_DIR/prompts"
|
|
20
|
+
|
|
21
|
+
# 复制文件
|
|
22
|
+
echo "📋 复制模板文件..."
|
|
23
|
+
cp "$TEMPLATE_DIR/.claude/CLAUDE-template.md" "$TARGET_DIR/.claude/CLAUDE.md"
|
|
24
|
+
cp "$TEMPLATE_DIR/.claude/settings.json" "$TARGET_DIR/.claude/"
|
|
25
|
+
cp "$TEMPLATE_DIR/.claude/hooks/thinking-silent.js" "$TARGET_DIR/.claude/hooks/"
|
|
26
|
+
cp "$TEMPLATE_DIR/.claude/hooks/tl-summary.sh" "$TARGET_DIR/.claude/hooks/"
|
|
27
|
+
cp "$TEMPLATE_DIR/.claude/hooks/sync-to-log.sh" "$TARGET_DIR/.claude/hooks/"
|
|
28
|
+
cp "$TEMPLATE_DIR/.claude/hooks/session-end.sh" "$TARGET_DIR/.claude/hooks/"
|
|
29
|
+
cp "$TEMPLATE_DIR/.claude/thinking-routes/QUICKREF.md" "$TARGET_DIR/.claude/thinking-routes/"
|
|
30
|
+
cp "$TEMPLATE_DIR/.claude/rag/skill-index.json" "$TARGET_DIR/.claude/rag/" 2>/dev/null || true
|
|
31
|
+
cp "$TEMPLATE_DIR/project-paradigm.md" "$TARGET_DIR/prompts/"
|
|
32
|
+
cp "$TEMPLATE_DIR/thinkinglens-silent.md" "$TARGET_DIR/prompts/"
|
|
33
|
+
cp "$TEMPLATE_DIR/README.md" "$TARGET_DIR/prompts/claude-template-README.md"
|
|
34
|
+
|
|
35
|
+
# 添加执行权限
|
|
36
|
+
echo "🔧 设置执行权限..."
|
|
37
|
+
chmod +x "$TARGET_DIR/.claude/hooks/thinking-silent.js"
|
|
38
|
+
chmod +x "$TARGET_DIR/.claude/hooks/tl-summary.sh"
|
|
39
|
+
chmod +x "$TARGET_DIR/.claude/hooks/sync-to-log.sh"
|
|
40
|
+
chmod +x "$TARGET_DIR/.claude/hooks/session-end.sh"
|
|
41
|
+
|
|
42
|
+
# 创建空文件
|
|
43
|
+
echo "📝 创建记忆文件..."
|
|
44
|
+
touch "$TARGET_DIR/.claude/MEMORY.md"
|
|
45
|
+
touch "$TARGET_DIR/.claude/PROJECT_LOG.md"
|
|
46
|
+
|
|
47
|
+
# 初始化 Oh My Claude
|
|
48
|
+
echo "🤖 初始化 Oh My Claude..."
|
|
49
|
+
if command -v oh-my-claude &> /dev/null; then
|
|
50
|
+
cd "$TARGET_DIR"
|
|
51
|
+
oh-my-claude sync 2>/dev/null || echo " (Oh My Claude 未安装,跳过)"
|
|
52
|
+
cd - > /dev/null
|
|
53
|
+
else
|
|
54
|
+
echo " 💡 提示: 安装 Oh My Claude 获得更多功能"
|
|
55
|
+
echo " npm install -g oh-my-claude"
|
|
56
|
+
fi
|
|
57
|
+
|
|
58
|
+
# 初始化 RAG 技能索引
|
|
59
|
+
echo "🧠 初始化 RAG 技能索引..."
|
|
60
|
+
cat > "$TARGET_DIR/.claude/rag/skills.md" << 'EOF'
|
|
61
|
+
# RAG 技能索引
|
|
62
|
+
|
|
63
|
+
此文件用于动态技能检索。当 Claude 需要特定能力时,会自动搜索此文件。
|
|
64
|
+
|
|
65
|
+
## 技能映射
|
|
66
|
+
|
|
67
|
+
| 关键词 | 技能 | 说明 |
|
|
68
|
+
|--------|------|------|
|
|
69
|
+
| frontend, ui, react, design | frontend-design | 前端界面设计 |
|
|
70
|
+
| document, docx, word | docx | Word 文档处理 |
|
|
71
|
+
| pdf, form | pdf | PDF 操作 |
|
|
72
|
+
| slide, ppt, presentation | pptx | PPT 制作 |
|
|
73
|
+
| spreadsheet, excel, xlsx | xlsx | 表格处理 |
|
|
74
|
+
| art, generative, canvas | canvas-design | 算法艺术 |
|
|
75
|
+
| api, mcp, server | mcp-builder | MCP 服务器构建 |
|
|
76
|
+
| architecture, design | orchestration | 多 Agent 编排 |
|
|
77
|
+
|
|
78
|
+
## 动态加载
|
|
79
|
+
|
|
80
|
+
当检测到任务类型时,自动使用:
|
|
81
|
+
\`\`\`bash
|
|
82
|
+
openskills read <skill-name>
|
|
83
|
+
\`\`\`
|
|
84
|
+
EOF
|
|
85
|
+
|
|
86
|
+
# 创建 ANCHORS.md
|
|
87
|
+
cat > "$TARGET_DIR/.claude/ANCHORS.md" << 'EOF'
|
|
88
|
+
# [项目名称] - 技能锚点索引
|
|
89
|
+
|
|
90
|
+
> 此文件由 AI 自动维护,作为技能系统的快速索引
|
|
91
|
+
> 最后更新:[日期]
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 🚀 AI 启动:记忆加载顺序
|
|
96
|
+
|
|
97
|
+
```
|
|
98
|
+
1. ANCHORS.md (本文件) → 快速定位模块
|
|
99
|
+
2. PROJECT_LOG.md → 了解完整构建历史
|
|
100
|
+
3. MEMORY.md → 查看最新变更
|
|
101
|
+
4. CLAUDE.md → 加载核心知识
|
|
102
|
+
5. prompts/ → 查看教学指南
|
|
103
|
+
6. .claude/rag/skills.md → RAG 技能索引 ⭐
|
|
104
|
+
7. 具体文件 → 深入实现细节
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## 当前锚点映射
|
|
110
|
+
|
|
111
|
+
### 教学资源
|
|
112
|
+
| 锚点 | 文件路径 | 用途 |
|
|
113
|
+
|------|----------|------|
|
|
114
|
+
| `[doc:paradigm]` | `prompts/project-paradigm.md` | 通用项目开发范式 ⭐ |
|
|
115
|
+
| `[doc:claude-template]` | `prompts/CLAUDE-template.md` | 新项目 CLAUDE.md 模板 ⭐ |
|
|
116
|
+
| `[doc:how-to-find]` | `prompts/how-to-find.md` | 对话历史查找指南 ⭐ |
|
|
117
|
+
|
|
118
|
+
### RAG 系统
|
|
119
|
+
| 锚点 | 文件路径 | 用途 |
|
|
120
|
+
|------|----------|------|
|
|
121
|
+
| `[system:rag-index]` | `.claude/rag/skills.md` | 动态技能索引 ⭐ |
|
|
122
|
+
| `[system:oh-my-claude]` | `~/.claude/config.json` | Agent 编排配置 |
|
|
123
|
+
|
|
124
|
+
### [添加你的锚点...]
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 锚点使用规则
|
|
129
|
+
|
|
130
|
+
1. **AI 启动任务时**:先检查相关锚点,加载对应文件
|
|
131
|
+
2. **AI 完成任务时**:如果是新模块,自动添加锚点到此文件
|
|
132
|
+
3. **锚点命名**:使用英文,格式为 `[类型:名称]`
|
|
133
|
+
EOF
|
|
134
|
+
|
|
135
|
+
echo ""
|
|
136
|
+
echo "✅ 初始化完成!"
|
|
137
|
+
echo ""
|
|
138
|
+
echo "📦 已包含:"
|
|
139
|
+
echo " • AI 自治记忆系统 (ThinkingLens)"
|
|
140
|
+
echo " • Oh My Claude 集成"
|
|
141
|
+
echo " • RAG 动态技能索引"
|
|
142
|
+
echo " • 24+ 预置技能"
|
|
143
|
+
echo ""
|
|
144
|
+
echo "下一步:"
|
|
145
|
+
echo " 1. 编辑 $TARGET_DIR/.claude/CLAUDE.md 填入项目信息"
|
|
146
|
+
echo " 2. 运行 tl 查看对话摘要(需先配置别名)"
|
|
147
|
+
echo ""
|
|
148
|
+
echo "建议添加到 ~/.zshrc 或 ~/.bashrc:"
|
|
149
|
+
echo " alias tl='.claude/hooks/tl-summary.sh'"
|
|
150
|
+
echo ""
|
|
@@ -0,0 +1,313 @@
|
|
|
1
|
+
# Prompt: Claude Code 项目开发范式
|
|
2
|
+
|
|
3
|
+
> 通用项目开发范式 - 适用于任何需要 Claude Code 深度集成的项目
|
|
4
|
+
> 最后更新:2026-01-11
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 核心理念
|
|
9
|
+
|
|
10
|
+
**Personal Panopticon(个人全景塔)** - 数据主权反转
|
|
11
|
+
|
|
12
|
+
传统的 legibility 是单向的:平台看见你。Claude Code 让你反转这个方向:你看见自己。
|
|
13
|
+
|
|
14
|
+
```
|
|
15
|
+
┌─────────────────────────────────────────────────────────┐
|
|
16
|
+
│ Personal Panopticon 架构 │
|
|
17
|
+
├─────────────────────────────────────────────────────────┤
|
|
18
|
+
│ │
|
|
19
|
+
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐│
|
|
20
|
+
│ │ 数据源 │───→│ AI 观察者 │───→│ 行动 ││
|
|
21
|
+
│ │ │ │ │ │ ││
|
|
22
|
+
│ │ GitHub │ │ Claude │ │ 代码 ││
|
|
23
|
+
│ │ Notion │ │ Code │ │ 文档 ││
|
|
24
|
+
│ │ Email │ │ │ │ 生活 ││
|
|
25
|
+
│ └─────────────┘ └─────────────┘ └─────────────┘│
|
|
26
|
+
│ │ │ │ │
|
|
27
|
+
│ └───────────────────┼───────────────────┘ │
|
|
28
|
+
│ ↓ │
|
|
29
|
+
│ ┌─────────────┐ │
|
|
30
|
+
│ │ 思维轨迹 │ │
|
|
31
|
+
│ │ ThinkingLens│ │
|
|
32
|
+
│ └─────────────┘ │
|
|
33
|
+
└─────────────────────────────────────────────────────────┘
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
---
|
|
37
|
+
|
|
38
|
+
## 第一阶段:AI 自治记忆系统
|
|
39
|
+
|
|
40
|
+
### 目录结构
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
.claude/
|
|
44
|
+
├── CLAUDE.md # AI 启动检查清单 + 核心知识
|
|
45
|
+
├── ANCHORS.md # 技能锚点索引(快速定位)
|
|
46
|
+
├── MEMORY.md # 增量记忆日志(变更记录)
|
|
47
|
+
├── PROJECT_LOG.md # 完整项目构建历史
|
|
48
|
+
├── settings.json # Claude Code 配置
|
|
49
|
+
├── hooks/ # 自动化钩子
|
|
50
|
+
├── skills/ # 领域知识库
|
|
51
|
+
├── thinking-routes/ # 思维轨迹系统
|
|
52
|
+
└── agents/ # AI Agent 角色定义(可选)
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### AI 启动流程
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+
1. ANCHORS.md → 快速定位模块
|
|
59
|
+
2. PROJECT_LOG.md → 理解完整历史和决策
|
|
60
|
+
3. MEMORY.md → 查看最新变更
|
|
61
|
+
4. CLAUDE.md → 加载核心知识
|
|
62
|
+
5. 具体文件 → 深入实现
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### 锚点系统
|
|
66
|
+
|
|
67
|
+
**格式**:`[类型:名称]`
|
|
68
|
+
|
|
69
|
+
| 类型 | 前缀 | 示例 |
|
|
70
|
+
|------|------|------|
|
|
71
|
+
| 技能文档 | `skill:` | `[skill:periodization]` |
|
|
72
|
+
| Agent 模块 | `agent:` | `[agent:analyzer]` |
|
|
73
|
+
| API 客户端 | `client:` | `[client:api]` |
|
|
74
|
+
| 数据层 | `db:` | `[db:schema]` |
|
|
75
|
+
| API 路由 | `api:` | `[api:router]` |
|
|
76
|
+
| 测试文件 | `test:` | `[test:auth]` |
|
|
77
|
+
| 系统组件 | `system:` | `[system:memory]` |
|
|
78
|
+
| 教学文档 | `doc:` | `[doc:readme]` |
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
## 第二阶段:技能系统(Skills)
|
|
83
|
+
|
|
84
|
+
### 何时创建 Skill
|
|
85
|
+
|
|
86
|
+
- 需要反复引用的领域知识
|
|
87
|
+
- 包含特定模式、反模式、最佳实践
|
|
88
|
+
- 需要文献/资料引用的内容
|
|
89
|
+
|
|
90
|
+
### Skill 模板
|
|
91
|
+
|
|
92
|
+
```markdown
|
|
93
|
+
---
|
|
94
|
+
name: [技能名称]
|
|
95
|
+
description: [一句话描述]
|
|
96
|
+
see_also: [相关技能]
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## 概述
|
|
100
|
+
|
|
101
|
+
[技能的核心概念和原理]
|
|
102
|
+
|
|
103
|
+
## 关键模式
|
|
104
|
+
|
|
105
|
+
### 模式1
|
|
106
|
+
- **何时使用**: ...
|
|
107
|
+
- **如何使用**: ...
|
|
108
|
+
- **示例代码**: ...
|
|
109
|
+
|
|
110
|
+
### 模式2
|
|
111
|
+
...
|
|
112
|
+
|
|
113
|
+
## 反模式
|
|
114
|
+
|
|
115
|
+
- ❌ 不要这样做,因为...
|
|
116
|
+
- ❌ 避免使用...
|
|
117
|
+
|
|
118
|
+
## 参考资料
|
|
119
|
+
|
|
120
|
+
- [文献/教程链接]
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 第三阶段:自动化钩子(Hooks)
|
|
126
|
+
|
|
127
|
+
### settings.json 配置
|
|
128
|
+
|
|
129
|
+
```json
|
|
130
|
+
{
|
|
131
|
+
"matcher": "Edit|MultiEdit|Write",
|
|
132
|
+
"hooks": [{
|
|
133
|
+
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/memory-sync.sh",
|
|
134
|
+
"timeout": 5
|
|
135
|
+
}]
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
### Hook 示例:记忆同步
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
#!/bin/bash
|
|
143
|
+
# .claude/hooks/memory-sync.sh
|
|
144
|
+
|
|
145
|
+
REL_PATH="$1"
|
|
146
|
+
EVENT_TYPE="$2"
|
|
147
|
+
|
|
148
|
+
# 检测新模块
|
|
149
|
+
if [[ "$REL_PATH" =~ server/.*\.ts$ ]]; then
|
|
150
|
+
MODULE=$(basename "$REL_PATH" .ts)
|
|
151
|
+
echo "🧠 新模块: [$MODULE] → $REL_PATH"
|
|
152
|
+
echo " 请更新 ANCHORS.md 和 MEMORY.md"
|
|
153
|
+
fi
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
---
|
|
157
|
+
|
|
158
|
+
## 第四阶段:思维轨迹系统(ThinkingLens)
|
|
159
|
+
|
|
160
|
+
### 设计理念
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
GitLens ThinkingLens
|
|
164
|
+
────────────────────────────────────────
|
|
165
|
+
代码变更 → 思维轨迹
|
|
166
|
+
Commit 历史 → 决策节点
|
|
167
|
+
Branch → 探索路径
|
|
168
|
+
Merge → 综合判断
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
### 数据模型
|
|
172
|
+
|
|
173
|
+
```typescript
|
|
174
|
+
interface ThinkingNode {
|
|
175
|
+
id: string;
|
|
176
|
+
sessionId: string;
|
|
177
|
+
timestamp: string;
|
|
178
|
+
parentIds: string[];
|
|
179
|
+
type: "inquiry" | "analysis" | "decision" | "action" | "observation";
|
|
180
|
+
summary: string;
|
|
181
|
+
content?: string;
|
|
182
|
+
tags: string[];
|
|
183
|
+
decision?: {
|
|
184
|
+
question: string;
|
|
185
|
+
alternatives: Array<{ name, pros, cons }>;
|
|
186
|
+
chosen: string;
|
|
187
|
+
rationale: string;
|
|
188
|
+
};
|
|
189
|
+
}
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## 第五阶段:代码风格规范
|
|
195
|
+
|
|
196
|
+
### Linus Torvalds 哲学
|
|
197
|
+
|
|
198
|
+
1. **消除特殊情况**
|
|
199
|
+
- 通过优雅的数据结构让边界情况自然消失
|
|
200
|
+
- 避免用 if/else 打补丁
|
|
201
|
+
|
|
202
|
+
2. **极简主义**
|
|
203
|
+
- 函数只做一件事
|
|
204
|
+
- 命名直白、精准
|
|
205
|
+
|
|
206
|
+
3. **实用主义**
|
|
207
|
+
- 解决真实问题,拒绝过度设计
|
|
208
|
+
|
|
209
|
+
### 质量指标
|
|
210
|
+
|
|
211
|
+
- 单文件不超过 800 行
|
|
212
|
+
- 单目录不超过 8 个文件
|
|
213
|
+
- 零循环依赖
|
|
214
|
+
- 零代码重复
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## 第六阶段:AI 自治开发流程
|
|
219
|
+
|
|
220
|
+
### 当 AI 接收任务时
|
|
221
|
+
|
|
222
|
+
1. **加载上下文**: 读取 CLAUDE.md、ANCHORS.md、MEMORY.md
|
|
223
|
+
2. **任务分解**: 将任务分解为具体的子任务
|
|
224
|
+
3. **实现与测试**: 实现功能并编写测试
|
|
225
|
+
4. **文档更新**: 更新 MEMORY.md、ANCHORS.md
|
|
226
|
+
5. **记录决策**: 在 thinking-routes/ 中记录关键决策
|
|
227
|
+
|
|
228
|
+
### 人类确认点
|
|
229
|
+
|
|
230
|
+
AI 在以下情况必须请求人类确认:
|
|
231
|
+
- 架构设计变更
|
|
232
|
+
- 数据模型变更
|
|
233
|
+
- 新增外部依赖
|
|
234
|
+
- 质量标准定义
|
|
235
|
+
- 安全与隐私相关变更
|
|
236
|
+
|
|
237
|
+
---
|
|
238
|
+
|
|
239
|
+
## 受保护目录
|
|
240
|
+
|
|
241
|
+
以下目录包含核心基础设施,**严禁删除**:
|
|
242
|
+
|
|
243
|
+
```
|
|
244
|
+
.claude/ # AI 自治记忆系统核心
|
|
245
|
+
.claude/thinking-routes/ # 思维轨迹系统
|
|
246
|
+
.claude/skills/ # 知识库
|
|
247
|
+
prompts/ # Prompt 教学库
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
---
|
|
251
|
+
|
|
252
|
+
## 成功标准
|
|
253
|
+
|
|
254
|
+
完成后,项目应该具备:
|
|
255
|
+
|
|
256
|
+
- ✅ AI 能够理解项目规范并生成符合标准的代码
|
|
257
|
+
- ✅ AI 启动时自动加载完整上下文
|
|
258
|
+
- ✅ 关键决策可追溯(ThinkingLens)
|
|
259
|
+
- ✅ 知识可累积(Skills 系统)
|
|
260
|
+
- ✅ 记忆可同步(Hooks)
|
|
261
|
+
|
|
262
|
+
---
|
|
263
|
+
|
|
264
|
+
## 快速开始
|
|
265
|
+
|
|
266
|
+
### 新项目初始化
|
|
267
|
+
|
|
268
|
+
```bash
|
|
269
|
+
# 1. 创建基础结构
|
|
270
|
+
mkdir -p .claude/{skills,hooks,thinking-routes}
|
|
271
|
+
mkdir -p prompts
|
|
272
|
+
|
|
273
|
+
# 2. 复制本文件到 prompts/
|
|
274
|
+
cp project-paradigm.md prompts/
|
|
275
|
+
|
|
276
|
+
# 3. 创建基础配置文件
|
|
277
|
+
# - CLAUDE.md(项目核心知识)
|
|
278
|
+
# - ANCHORS.md(模块索引)
|
|
279
|
+
# - MEMORY.md(增量日志)
|
|
280
|
+
|
|
281
|
+
# 4. 配置 settings.json
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
### 最小化 CLAUDE.md 模板
|
|
285
|
+
|
|
286
|
+
```markdown
|
|
287
|
+
# [项目名称]
|
|
288
|
+
|
|
289
|
+
## AI 启动检查清单
|
|
290
|
+
|
|
291
|
+
1. 加载 ANCHORS.md(快速索引)
|
|
292
|
+
2. 加载 MEMORY.md(最新变更)
|
|
293
|
+
3. 加载 CLAUDE.md(核心知识)
|
|
294
|
+
|
|
295
|
+
## 受保护目录
|
|
296
|
+
|
|
297
|
+
- `prompts/` - Prompt 教学库
|
|
298
|
+
- `.claude/` - AI 自治记忆系统
|
|
299
|
+
|
|
300
|
+
## 核心架构
|
|
301
|
+
|
|
302
|
+
[简要描述项目架构]
|
|
303
|
+
|
|
304
|
+
## 开发规范
|
|
305
|
+
|
|
306
|
+
[代码风格、质量标准等]
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
---
|
|
310
|
+
|
|
311
|
+
**记住**:目标不是让 AI 帮你写代码,而是让 AI 成为你思维的延伸——在你睡觉时它仍在工作,在你忘记时它还记得,当你困惑时它已理清。
|
|
312
|
+
|
|
313
|
+
"Take the tower early. Do not let it take you."
|