# ai-coding-practice

**Repository Path**: bkhech/ai-coding-practice

## Basic Information

- **Project Name**: ai-coding-practice
- **Description**: ai coding 学习总结仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-16
- **Last Updated**: 2026-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 编程实践

AI 编程助手（Claude Code、Codex、Trae）的实践仓库，涵盖使用技巧、配置管理、自定义技能/Agent 开发以及多个实战项目。

## 仓库结构

```
.
├── README.md                              # 项目主概述
├── CLAUDE.md                              # 项目级 Claude Code 指导
│
├── claudecode/                            # Claude Code 练习与实战
│   ├── ClaudeCode使用技巧.md              # Claude Code 使用指南
│   ├── Superpowers 设计原理与工作流.md     # Superpowers 插件设计原理
│   ├── Claude_Code_Worktree并行任务指南.md # Worktree 并行开发指南
│   ├── Coding Plan 模型配置与使用指南.md  # Plan 模式配置指南
│   ├── Claude Code 对比（main agent vs skill vs subagent vs command）.md
│   ├── Claude Code 环境配置审查与优化建议.md
│   ├── sql_gen/                           # SQL 批量生成练习
│   ├── arbitrager/                        # LOF 基金自动化套利工具
│   └── mcp/                               # MCP 配置指南
│       ├── MySQL_MCP连接极简操作手册.md
│       └── JetBrains_MCP配置指南.md
│
├── codex/                                 # Codex 练习材料
│   ├── CodeX使用技巧.md                   # Codex 使用指南
│   └── customskills/                      # 自定义技能示例
│       ├── btc-usdt-realtime-price/       # 加密货币价格查询
│       └── daily-hot-search-top5/         # 每日热搜 Top5
│
├── trae/                                  # Trae AI 编辑器实战
│   └── wheather/                          # 实时天气查询小程序（Vue 3 + Vite）
│
├── ai-team-wpe/                           # AI 应用团队工作流探索
│   ├── mysql-practice/                    # MySQL 报表生成器（Python）
│   └── spine-care/                        # 腰背康复助手微信小程序
│
├── bkhech-claudecode-config/              # Claude Code 个人配置工程化迁移
│   ├── agents/                            # 自定义 Agent（架构审查、数据库审查等）
│   ├── skills/                            # 自定义技能（复盘、提示词工程、Spring Boot 审查）
│   ├── commands/                          # 自定义命令（深度访谈）
│   ├── hooks/                             # 钩子脚本（关键词检测）
│   └── install.sh / install.ps1           # 一键安装脚本
│
└── .claude/                               # 项目级 Claude Code 配置
    ├── agents/
    ├── commands/
    └── skills/
```

## 实战项目

### LOF 基金自动化套利工具（`claudecode/arbitrager/`）

基于 Python + AkShare + MySQL + Streamlit 的 LOF 基金折溢价监控工具，支持股债型、指数型、QDII 型三类基金的自动扫描与套利机会告警。

### 实时天气查询小程序（`trae/wheather/`）

基于 Vue 3 + Vite + OpenWeatherMap API 的天气查询应用，支持中文城市名称查询，响应式设计。

### MySQL 报表生成器（`ai-team-wpe/mysql-practice/`）

Python + MySQL Connector 实现的用户订单统计报表工具，支持 CSV/Excel 导出、日期筛选、连接池与自动重试。

### 腰背康复助手（`ai-team-wpe/spine-care/`）

微信小程序，专为腰脊康复人群设计的打卡记录与状态追踪工具，纯本地存储，轻量化设计。

### Claude Code 配置迁移（`bkhech-claudecode-config/`）

个人 Claude Code 完整配置的工程化迁移包，包含 4 个自定义 Agent、3 个技能、钩子脚本和插件配置，支持一键安装。

## 最佳实践

### AI 编程高效工作流

```
理解项目 → 规划修改 → 小步实现 → AI Review → 持续会话
```

1. **理解阶段**：让 AI 先分析代码库结构，建立上下文
2. **规划阶段**：使用 `/plan` 模式制定实现计划
3. **实现阶段**：按计划小步执行，每步验证
4. **审查阶段**：使用 AI 审查变更，关注性能、并发、安全

### 规格驱动开发（Spec-Driven Development）

> 人写 Spec，AI 写代码。

先编写功能规格文档，再让 AI 按规格实现，显著提升代码准确率和可维护性。

### 项目级 AI 配置（CLAUDE.md）

在项目根目录放置 `CLAUDE.md`，定义项目规范（技术栈、架构风格、编码规范），AI 在每个会话中自动读取，相当于给 AI 长期记忆。

## 相关资源

- `claudecode/ClaudeCode使用技巧.md` — Claude Code 详细使用指南
- `codex/CodeX使用技巧.md` — Codex 详细使用模式
- `bkhech-claudecode-config/INSTALL.md` — Claude Code 配置安装指南
- `claudecode/Superpowers 设计原理与工作流.md` — Superpowers 插件深入解析