文档: 添加 Claude Code 学习资源与项目配置

- 添加 .claude 配置目录（CLAUDE.md、commands、hooks、memory） - 添加项目根目录 CLAUDE.md - 更新工程 README.md，新增 Claw Code 链接 - 更新知识/金鹏.md，添加 2026-04-10 文章分享内容 - 添加知识图片和参考资料 PDF
2026-04-09 14:18:25 +08:00
parent 3a7dd3e979
commit d82e2a21b6
13 changed files with 465 additions and 1 deletions
@@ -0,0 +1,114 @@
+---
+name: Docker清理
+description: 清理 Docker 镜像构建临时文件和悬空资源
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+执行前**必须**处理用户输入（非空时）
+
+## 参数说明
+
+支持以下参数（可组合使用）：
+
+- `cache` - 仅清理构建缓存
+- `images` - 仅清理悬空镜像
+- `volumes` - 仅清理未使用的卷
+- `containers` - 额外清理已停止的容器
+- `all` - 清理默认项目（构建缓存、悬空镜像、未使用的卷）
+- `detail` 或 `详细` - 显示详细清理过程
+
+## 输出
+
+### 格式要求
+
+按以下格式输出清理结果：
+
+```markdown
+## Docker 清理报告
+
+### 清理前状态
+
+| 类型 | 总量 | 活跃 | 占用空间 | 可回收 |
+|------|------|------|----------|--------|
+| **镜像** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **容器** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **本地卷** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **构建缓存** | {数量} | {数量} | {大小} | {大小} |
+
+### 清理内容
+
+执行以下清理：
+
+- **构建缓存**：{清理的缓存大小}
+- **悬空镜像**：{删除的镜像数量} 个
+- **未使用的卷**：{清理的卷大小}
+
+{如果用户指定了 `containers` 参数，则添加：
+- **已停止的容器**：{删除的容器数量} 个
+}
+
+### 清理后状态
+
+| 类型 | 总量 | 活跃 | 占用空间 | 可回收 |
+|------|------|------|----------|--------|
+| **镜像** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **容器** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **本地卷** | {数量} | {数量} | {大小} | {大小} ({百分比}%) |
+| **构建缓存** | {数量} | {数量} | {大小} | {大小} |
+
+### 清理总结
+
+**释放空间总计：约 {总大小}**
+
+{根据清理结果给出建议}
+```
+
+### 执行规则
+
+1. **默认行为** - 无参数时，仅清理构建缓存（不清理悬空镜像、未使用的卷、容器）
+2. **选择性清理** - 根据 $ARGUMENTS 中的参数执行对应清理
+3. **容器清理** - 仅当用户明确指定 `containers` 参数时才清理已停止的容器
+4. **详细模式** - 当 $ARGUMENTS 包含 "detail" 或 "详细" 时，显示详细的清理过程
+5. **安全检查** - 清理前先检查 Docker 状态，确认可清理内容
+6. **执行顺序** - 按以下顺序执行：
+   - 检查当前状态（`docker system df`）
+   - 清理构建缓存（`docker builder prune -a -f`）
+   - {如果指定了 `images` 参数} 清理悬空镜像（`docker image prune -f`）
+   - {如果指定了 `volumes` 参数} 清理未使用的卷（`docker volume prune -f`）
+   - {如果指定了 `containers` 参数} 清理已停止的容器（`docker container prune -f`）
+   - 显示清理后状态
+
+### 清理命令参考
+
+```bash
+# 检查磁盘使用情况
+docker system df
+
+# 清理构建缓存（默认执行）
+docker builder prune -a -f
+
+# 清理悬空镜像（需要明确指定）
+docker image prune -f
+
+# 清理未使用的卷（需要明确指定）
+docker volume prune -f
+
+# 清理已停止的容器（需要明确指定）
+docker container prune -f
+
+# 一次性清理所有未使用资源（包括容器，不推荐使用）
+docker system prune -a -f --volumes
+```
+
+### 注意事项
+
+- **默认不清理容器**：已停止的容器不会在默认清理中删除，需明确指定 `containers` 参数
+- 构建缓存清理后重新构建镜像会需要更多时间
+- 删除的镜像和卷无法恢复，请谨慎操作
+- 建议定期清理以保持系统整洁
+- 显示可回收空间不代表实际释放空间，可能因层共享而不同
@@ -0,0 +1,161 @@
+---
+name: 提交代码
+description: 提交全部内容并推送到远程仓库（不检查路径）
+---
+
+## 用户输入
+
+```text
+$ARGUMENTS
+```
+
+执行前**必须**处理用户输入（非空时）
+
+## 输出
+
+1. 分析本次需要提交的内容，按照**Git 提交规范**整理提交消息
+
+2. 提交全部内容并推送到远程仓库
+
+3. 使用以下格式输出
+
+```text
+项目根目录： xxx
+工作目录： xxx
+本地分支： xxx
+远程分支： xxx
+远程地址： xxx
+用户输入： $ARGUMENTS
+提交哈希： xxx
+提交时间： yyyy-MM-dd HH:MM:SS
+提交日志：
+
+{git日志}
+```
+
+## Git 提交规范
+
+遵循 Conventional Commits 标准，结合项目特定需求制定以下提交规范：
+
+### 提交消息格式
+
+```
+<类型>(<作用域>): <描述>
+
+[可选正文]
+
+[可选脚注]
+```
+
+### 提交类型
+
+**主要类型：**
+- **功能 (`feat`)**: 添加新功能或增强现有功能
+- **修复 (`fix`)**: 修复 bug 或错误行为
+- **维护 (`chore`)**: 维护性任务（依赖更新、配置修改等）
+- **文档 (`docs`)**: 文档更新、README、注释等
+- **重构 (`refactor`)**: 代码重构（不改变外部行为）
+- **测试 (`test`)**: 添加、修改或修复测试代码
+- **格式 (`style`)**: 代码格式化、空白调整等
+- **性能 (`perf`)**: 性能优化改进
+- **构建 (`build`)**: 构建系统、工具链变更
+
+**扩展类型：**
+- **安全 (`sec`)**: 安全相关修复或改进
+- **依赖 (`deps`)**: 依赖包更新或添加
+- **清理 (`clean`)**: 删除无用代码或文件
+- **优化 (`perf`)**: 性能或代码优化改进
+- **配置 (`config`)**: 配置文件修改
+- **规格 (`spec`)**: speckit 规格文档更新
+
+**特殊类型：**
+- **合并 (`merge`)**: 分支合并
+- **进行 (`wip`)**: 工作进行中（开发中的临时提交）
+- **回滚 (`revert`)**: 回滚之前的提交
+- **发布 (`release`)**: 发布版本标签
+
+### 格式要求
+
+**标题行规则：**
+- 使用祈使语气（"添加" 而不是 "添加了"）
+- 长度不超过 50 个字符
+- 类型后使用冒号和空格分隔：`功能: 添加用户认证`
+- 可指定作用域：`功能(auth): 添加 JWT 验证`
+
+**正文内容（可选）：**
+- 标题与正文之间留空行
+- 说明"做什么"和"为什么"，而非"怎么做"
+- 每行不超过 72 个字符
+- 使用项目符号列出多个改动
+
+**脚注信息（可选）：**
+- 标记破坏性变更：`破坏性变更: 详细说明`
+- 关联 issue：`关联: #123` 或 `解决: #456`
+- 标记不兼容变更：`不兼容: API 接口参数调整`
+
+### 提交示例
+
+#### 基础提交
+```bash
+功能: 添加用户登录功能
+修复: 修复内存泄漏问题
+文档: 更新 API 文档
+维护: 更新依赖版本
+```
+
+#### 带作用域的提交
+```bash
+功能(api): 添加用户认证接口
+功能(ui): 添加登录页面组件
+修复(服务端): 修复数据库连接超时
+测试(集成): 添加端到端测试用例
+```
+
+#### 详细描述的提交
+```bash
+功能: 实现实时消息推送
+
+- 添加 WebSocket 连接管理
+- 实现消息广播机制
+- 添加离线消息存储
+- 支持消息确认机制
+
+影响范围：
+- 前端消息组件更新
+- 服务端路由扩展
+- 数据库表结构变更
+
+关联: #89
+```
+
+### Claude Code 提交行为规范
+
+**重要：Git 提交消息格式要求**
+
+- **禁止**在提交消息中添加以下内容：
+  - `🤖 Generated with [Claude Code](https://claude.com/claude-code)`
+  - `Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>`
+  - 任何类似的 AI 工具签名或标识
+
+- **原因**：保持 Git 提交历史的简洁性和专业性，避免冗余的元数据
+
+- **正确示例**：
+  ```
+  文档: 添加用户认证功能
+
+  - 添加 JWT 验证中间件
+  - 实现登录登出接口
+  - 添加权限校验逻辑
+  ```
+
+- **错误示例**（不要这样做）：
+  ```
+  文档: 添加用户认证功能
+
+  - 添加 JWT 验证中间件
+
+  🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+  Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
+  ```
+