内容
# AI 编码工具包
[](skills-engineering/README.md)
[](skills-engineering/ios-engineer/SKILL.md)
[](sync/README.md)
[](docs/universal-rag-gateway.md)
[](LICENSE)
> **一套工具。所有 AI 编码工具。** Agent 技能管理、MCP 配置同步、iOS 工程规则和通用 RAG 网关 — 为 Cursor、CodeBuddy、Codex、Claude Code、Gemini CLI、Continue、Cline 和 Xcode Coding Assistant 统一提供支持。
**AI 编码工具包** 是一个面向使用多个 AI 编码工具的开发者的本地化 AI 编码工作流工具包，提供一个统一的 Agent 技能维护、MCP 服务器配置、平台设置和 RAG 网关路由的源头。它用一个可维护的 `env/config.json` 文件取代了分散的配置文件，并自动同步到您使用的所有 AI 编码主机上。
中文定位：这是一个面向 AI Coding / Agentic Coding / MCP（模型上下文协议）/ RAG Gateway 的本地工程化工具包。为同时使用多个 AI 编码工具（Cursor、CodeBuddy、Codex、Claude Code、Gemini CLI、Continue、Cline、Xcode Coding Assistant）的开发者提供统一的 Agent Skill 维护、MCP 配置同步、iOS 工程规则和智能网关路由。
## 为什么选择 AI 编码工具包？
在多个 AI 编码助手上管理 MCP 服务器、API 密钥和 Agent 技能是一项繁琐的工作 — 每个工具都以不同的格式和位置存储其配置。更新一个，遗忘其他的。 **AI 编码工具包** 解决了这个问题：
- **一个配置文件** → 自动生成 Cursor mcp.json、Codex TOML、Claude JSON、CodeBuddy 模型、Continue YAML 等。
- **一个同步命令** → `bash sync.sh` 在几秒钟内更新所有工具。
- **Git 忽略的机密** → `env/config.json` 保留在本地；只有清理后的示例被提交。
## 功能
> **Agent 技能和提示工程**
>
> 适用于工程学科、iOS / Swift / SwiftUI / UIKit 开发、问题分析、逻辑推理和认知扩展的即用型 AI 编码技能。版本控制、可同步和可审计。
> **MCP 配置同步（模型上下文协议）**
>
> 在 `env/config.json` 中定义一次 MCP 服务器，并自动渲染到 Cursor（mcp.json）、CodeBuddy（mcp.json + models.json）、Codex（config.toml）、Claude Code（.claude.json + settings.json）、Gemini CLI、Continue（config.yaml）和 Cline — 带有每个服务器的平台过滤。
> **iOS 工程规则**
>
> Swift、SwiftUI、UIKit、Xcode、并发（async/await、actors）、网络、性能、测试、代码审查、迁移和发布风险控制的生产级规则 — 设计用于 AI 编码助手生成可靠的 iOS 代码。
> **通用 RAG 网关**
>
> TypeScript / Fastify 网关，带有 OpenAI 兼容的 API、提供商路由、语义内存、转录存储、声明式工具、GraphRAG 和遥测。本地替代云 RAG 服务。
## 支持的 AI 编码工具
| 工具 | 同步配置 |
|------|--------------|
| **Cursor** | `.cursor/mcp.json` |
| **CodeBuddy** | `.codebuddy/mcp.json`, `models.json`, `skills/` |
| **Claude Code** | `.claude.json`, `settings.json`, `skills/` |
| **Codex CLI** | `.codex/config.toml`, `mcp.generated.toml` |
| **Gemini CLI** | 环境变量 |
| **Continue** | `.continue/config.yaml` |
| **Cline** (VSCode) | MCP 设置 JSON, `skills/` |
| **Xcode Coding Assistant** | Codex + Claude 代理配置路径 |
## 快速入门
```bash
# 1. 克隆仓库
git clone https://github.com/i-stack/ai-coding-kit.git
cd ai-coding-kit
# 2. 配置您的 MCP 服务器、API 密钥和平台设置
# 首次运行自动从示例模板复制
vim env/config.json
# 3. 一键同步到所有 AI 编码工具
bash sync.sh
```
`sync.sh` 自动将您的 MCP 服务器配置和平台设置同步到 **Cursor、CodeBuddy、Codex、Claude Code、Xcode、Cline、Gemini CLI 和 Continue**。
| 下一步 | 文档 |
|------|---------------|
| 深入了解 Agent 技能 | [skills-engineering/README.md](skills-engineering/README.md) |
| 了解 MCP 配置同步 | [sync/README.md](sync/README.md) |
| 查看配置文件模板 | [env/config.json.example](env/config.json.example) |
| 探索 iOS 工程师技能 | [skills-engineering/ios-engineer/SKILL.md](skills-engineering/ios-engineer/SKILL.md) |
| 研究 RAG 网关 | [docs/universal-rag-gateway.md](docs/universal-rag-gateway.md) |
| 设置 Git 钩子 | [install-hooks.sh](install-hooks.sh) |
## 什么是 MCP？（模型上下文协议）
[模型上下文协议（MCP）](https://modelcontextprotocol.io/) 是一个开放协议，允许 AI 编码工具通过标准化接口连接到外部服务 — GitHub、Playwright、数据库、API、设计工具等。 **AI 编码工具包** 让您可以定义所有 MCP 服务器，并在支持 MCP 的每个工具上同步它们。
## 文档
| 主题 | 链接 |
|------|------|
| Agent 技能工程 | [skills-engineering/README.md](skills-engineering/README.md) |
| iOS 工程师技能 | [skills-engineering/ios-engineer/SKILL.md](skills-engineering/ios-engineer/SKILL.md) |
| iOS 技能规则索引 | [skills-engineering/ios-engineer/references/rule_index.md](skills-engineering/ios-engineer/references/rule_index.md) |
| 认知扩展技能 | [skills-engineering/cognitive-expansion/SKILL.md](skills-engineering/cognitive-expansion/SKILL.md) |
| 工程学科技能 | [skills-engineering/engineering-discipline/SKILL.md](skills-engineering/engineering-discipline/SKILL.md) |
| 逻辑推理技能 | [skills-engineering/logical-reasoning/SKILL.md](skills-engineering/logical-reasoning/SKILL.md) |
| 认识完整性技能 | [skills-engineering/epistemic-integrity/SKILL.md](skills-engineering/epistemic-integrity/SKILL.md) |
| 问题分析技能 | [skills-engineering/problem-analysis/SKILL.md](skills-engineering/problem-analysis/SKILL.md) |
| MCP 和平台配置同步 | [sync/README.md](sync/README.md) |
| 通用 RAG 网关 | [docs/universal-rag-gateway.md](docs/universal-rag-gateway.md) |
| Token 比较笔记 | [docs/token-comparison-results-v2.md](docs/token-comparison-results-v2.md) |
## 仓库布局
| 路径 | 角色 |
|------|------|
| [skills-engineering/](skills-engineering/) | Agent 技能源、参考、同步脚本、验证数据和技能演化工作流。 |
| [sync/](sync/) | 本地 MCP / 平台配置同步的渲染器和编排。 |
| [env/](env/) | 本地配置文件模板；实际的 `env/config.json` 被故意 gitignore。 |
| [rag-gateway/](rag-gateway/) | 通用 RAG 网关源、测试、提供商、检索、内存、遥测和声明式工具运行时。 |
| [docs/](docs/) | 架构笔记、网关状态和令牌比较报告。 |
| [.githooks/](.githooks/) | 仓库管理的提交和推送防护。 |
## 谁适合使用？
- **使用多个 AI 编码工具的开发者**，他们希望一个配置来管理所有工具 — 定义一次 MCP 服务器和 Agent 技能，在所有地方同步。
- **iOS / Swift 工程师**，他们希望 Swift、SwiftUI、UIKit、Xcode、并发、测试、代码审查和应用迁移的生产级 AI 编码规则。
- **AI 基础设施构建者**，他们使用本地内存、语义检索、声明式工具、提供商路由和 OpenAI 兼容的 RAG 网关模式进行实验。
- **团队维护者**，他们需要一个统一的 MCP 配置、API 密钥和模型设置的源头，适用于 Cursor、CodeBuddy、Claude Code、Codex、Gemini、Continue、Cline 和 Xcode。
## 许可证
[MIT](LICENSE)
