# templatesFlow

**Repository Path**: IvanYue/templates-flow

## Basic Information

- **Project Name**: templatesFlow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-02
- **Last Updated**: 2026-06-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 配置模板仓库

一站式 AI 编程助手模板：默认通用基线，按需叠加前端/移动端/语言 overlay，支持 Claude Code、Cursor 和 Codex。

## 📦 包含内容

- ✅ **Claude Code / Cursor** 默认通用基线 + 前端/移动端 + 可选 overlay
- ✅ **Codex** 前端和移动端配置（参考）
- ✅ **OpenWolf + Superpowers** 通用集成
- ✅ **新项目流程 / 角色映射 / stack 选择**
- ✅ **一键安装脚本**（Windows + Linux/Mac）

## 🚀 快速安装

### Windows 用户

```powershell
# 1. 在本目录运行
.\install.ps1

# 2. 重启 PowerShell 或运行
. $PROFILE

# 3. 在任何项目中使用
cd your-project
ai-init -Frontend    # 前端项目
ai-init -Mobile      # 移动端项目
```

### Linux / Mac 用户

```bash
# 1. 在本目录运行
chmod +x install.sh
./install.sh

# 2. 重启终端或运行
source ~/.bashrc  # 或 source ~/.zshrc

# 3. 在任何项目中使用
cd your-project
ai-init --frontend   # 前端项目
ai-init --mobile     # 移动端项目
```

## 📁 仓库结构

```
templates-flow/
├── templates/
│   ├── claude-code/
│   │   ├── settings-frontend.json
│   │   ├── settings-mobile.json
│   │   ├── CLAUDE.md                   # 项目根入口（ai-init 复制）
│   │   └── rules/
│   │       ├── openwolf.md             # Claude Code rules
│   │       └── mobile-standards.md
│   ├── cursor/
│   │   ├── README.md                   # 勿把 settings.json 放进 .cursor/
│   │   └── rules/
│   │       ├── openwolf.mdc            # alwaysApply
│   │       ├── mobile-standards.mdc
│   │       └── cursor-global-hint.mdc  # 可选：复制一行到 Cursor 全局 Rules
│   └── codex/
│       ├── config-frontend.yaml
│       └── config-mobile.yaml
├── docs/
├── install.sh
├── install.ps1
└── README.md
```

**推荐默认：** `ai-init --general`（Python/Java/Go/任意栈，仅 OpenWolf + Superpowers）。专项：`--frontend` / `--mobile`。可选：`ai-init -g --with python`。详见 [docs/stack-selection.md](docs/stack-selection.md)。

`ai-init` 会写入 **`.claude/`**、**`.cursor/rules/`**、**`CLAUDE.md`**（勿把 `settings.json` 放进 `.cursor/`）。Cursor 与 Claude Code 双端共用 `.wolf/`。

参考：[docs/stack-selection.md](docs/stack-selection.md)、[docs/role-mapping.md](docs/role-mapping.md)、[docs/new-project-workflow.md](docs/new-project-workflow.md)。

## 🎯 使用方法

### 初始化新项目

```bash
# 1. 进入项目目录
cd your-project

# 2. 选择模板基线
ai-init --general              # 默认：Python/Java/Go/未知栈
# 或
ai-init --frontend             # 前端项目 (React/Vue/Next.js)
ai-init --mobile               # 移动端项目 (Flutter/React Native)
# 或在 general 基础上叠加
ai-init --general --with python
ai-init --general --with java

# 3. 初始化 OpenWolf（如果项目还没有）
openwolf init

# 4. 选一个角色再开始
# 例如：architect / developer / tester / devops / product / dba

# 5. 开始开发
# 具体命令以项目 README 为准
```

### 查看帮助

```bash
ai-init --help
```

## 📚 文档说明

### 入门文档
- **docs/quickstart.md**：快速入门，了解工具兼容性和基本配置
- **docs/guide.md**：实战指南，包含 9 个典型开发场景

### 开发实践
- **docs/development-guide.md**：开发实践指南（新项目、新功能、二次开发）
- **docs/refactor-existing-project.md**：重构现有项目的完整指南

### 团队协作
- **docs/team-collaboration.md**：团队协作最佳实践
- **docs/best-practices.md**：使用经验总结和最佳实践

### 问题排查
- **docs/troubleshooting.md**：常见问题排查和解决方案

## 🔧 工具兼容性

| 工具/库 | Claude Code | Cursor | Codex |
|---------|-------------|--------|-------|
| **OpenWolf** | ✅ | ✅ | ❌ |
| **Superpowers** | ✅ | ✅ | ❌ |
| **ECC** | ✅ | ✅ | ❌ |
| **OhMyCodex** | ❌ | ❌ | ✅ |

### 推荐组合

**Claude Code / Cursor**：
```
OpenWolf + Superpowers
```

**Codex**：
```
OhMyCodex（独立使用）
```

## 🔄 更新模板

如果配置模板有更新：

```bash
# 1. 更新本仓库
git pull  # 如果使用 git

# 2. 重新运行安装脚本
./install.sh  # 或 .\install.ps1
```

## 💡 配置说明

### Claude Code / Cursor 配置特性

**通用配置** (`settings-general.json`)：
- OpenWolf 上下文管理
- Superpowers 工作流技能
- 语言无关的最小设置
- 适合 Python / Java / Go / 混合仓
- 默认推荐给所有新项目

**前端配置** (`settings-frontend.json`)：
- OpenWolf 上下文管理
- Superpowers 工作流技能
- 前端专用规则与 hooks
- 适合 React / Vue / Next.js
- 仅在仓库明确是前端应用时使用

**移动端配置** (`settings-mobile.json`)：
- Flutter/Dart 专业支持
- Android/iOS 平台配置
- 移动端测试工作流
- 适合 Flutter / React Native
- 仅在仓库明确是移动端应用时使用

### Codex 配置特性

**前端配置** (`config-frontend.yaml`)：
- OhMyCodex 插件支持
- 自定义规则系统
- 工作流自动化

**移动端配置** (`config-mobile.yaml`)：
- Flutter 专用配置
- 平台特定设置

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

## 📝 版本信息

- **版本**：1.0.0
- **更新日期**：2026-06-02
- **适用工具**：OpenWolf + Superpowers + ECC + Caveman

## 📖 延伸阅读

- [OpenWolf 文档](https://github.com/openwolf/openwolf)
- [Everything Claude Code](https://github.com/everything-claude-code/ecc)
- [Superpowers 技能库](https://github.com/superpowers/skills)

---

**开始使用**：运行 `./install.sh` 或 `.\install.ps1` 安装模板，然后在任何项目中使用 `ai-init` 命令！🚀