# AI智能体claude

**Repository Path**: librarycodes/ai-agent-claude

## Basic Information

- **Project Name**: AI智能体claude
- **Description**: 用于存储这里可使用的 AI提示词和规则 和技能等各种
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-27
- **Last Updated**: 2026-03-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 智能体管理仓库

> 用于管理 Claude Code 的 AI 智能体配置文件。

## 项目简介

本项目是一个专门为 Claude Code 设计的 AI 智能体资源管理系统，提供结构化的方式来组织和管理智能体配置。通过统一的目录结构和规范的文件组织，帮助开发者更好地维护和复用 AI 智能体相关资源。

## 项目结构

```
ai-agent-claude/
├── .claude/               # Claude Code 项目配置
│   ├── settings.json      # 项目设置（共享到 Git）
│   ├── agents/            # 项目级智能体
│   └── skills/            # 项目级技能
├── .cursor/               # Cursor 项目配置（可选）
│   └── agents/            # Cursor 自定义子智能体（按需同步项目级智能体）
├── agents/                # AI 智能体配置文件（自定义组织）
├── skills/                # 技能模块定义（自定义组织）
└── README.md              # 项目说明文档
```

## 全局配置

全局配置文件位于 `~/.claude/CLAUDE.md`，适用于所有项目：

**当前全局规则：**
- ✅ 必须使用中文回答所有问题和执行所有任务
- ✅ 代码注释必须使用中文
- ✅ 文档说明必须使用中文

**全局配置路径：** `C:/Users/Administrator/.claude/CLAUDE.md`

## 已配置的智能体

### 📁 Agents（智能体）

| 智能体 | 描述 |
|--------|------|
| [media-team](agents/media-team.md) | **矩阵运营内容团队** - 内容总编 + 热点 + 选题 + 研究 + 写作 + 质检 + 平台优化 + 增长分析，面向第三方媒体平台文章生产与分发 |
| [video-team](agents/video-team.md) | **媒体视频团队** - 复用内容中台，并新增脚本、分镜、剪辑包装、视频质检、平台适配、发布执行和视频复盘，面向抖音、视频号、快手、B站等视频平台 |
| [prompt-architect](agents/prompt-architect.md) | 领域驱动提示词架构师 - 基于行业知识和规范标准的专业智能体设计师 |
| [agent-soul](agents/agent-soul.md) | Agent人格定义师 - 根据职位、级别、部门和职业定位设计贴合真实岗位的人格定义卡 |
| [media-chief-editor](agents/media-chief-editor.md) | 内容总编 - 负责内容目标拆解、团队任务编排和最终交付收敛 |
| [media-trend-scout](agents/media-trend-scout.md) | 热点侦察员 - 负责识别热点趋势、流量窗口和内容机会 |
| [media-topic-strategist](agents/media-topic-strategist.md) | 选题策划师 - 负责选题池、标题方向和内容角度规划 |
| [media-research-analyst](agents/media-research-analyst.md) | 资料研究员 - 负责整理事实、案例、数据和风险提示，输出写作资料包 |
| [media-article-writer](agents/media-article-writer.md) | 文章写手 - 负责根据选题和资料包产出可质检、可分发的文章初稿 |
| [media-quality-guard](agents/media-quality-guard.md) | 内容质检官 - 负责自动审校、风险筛查和发布门禁，尽量替代人工审核 |
| [media-platform-optimizer](agents/media-platform-optimizer.md) | 平台优化师 - 负责将定稿适配为公众号、头条、百家号、知乎等平台版本 |
| [media-growth-analyst](agents/media-growth-analyst.md) | 增长分析师 - 负责发布后数据复盘和下一轮选题、标题、发布策略优化 |
| [video-script-writer](agents/video-script-writer.md) | 视频脚本师 - 负责根据选题和资料包产出口播稿、视频结构、钩子和互动引导 |
| [video-storyboard-designer](agents/video-storyboard-designer.md) | 分镜设计师 - 负责将脚本拆成镜头、画面、字幕重点和素材需求 |
| [video-production-coordinator](agents/video-production-coordinator.md) | 视频生产协调官 - 负责判断最合适的生产方式，协调脚本、分镜、素材和包装的执行路径 |
| [video-packaging-director](agents/video-packaging-director.md) | 剪辑包装师 - 负责节奏、字幕、音效、封面方向和后期包装方案 |
| [video-quality-guard](agents/video-quality-guard.md) | 视频质检官 - 负责视频脚本、分镜、包装和平台版本的自动质检与发布门禁 |
| [video-platform-optimizer](agents/video-platform-optimizer.md) | 视频平台优化师 - 负责将同一视频主题适配为抖音、视频号、快手、B站等平台版本 |
| [video-growth-analyst](agents/video-growth-analyst.md) | 视频增长分析师 - 负责围绕播放、留存、完播、互动和转化做视频复盘与优化 |
| [video-publisher](agents/video-publisher.md) | 视频发布执行官 - 负责整理平台发布素材包、发布时间建议和发布记录字段 |
| [video-community-operator](agents/video-community-operator.md) | 评论区运营官 - 负责首评、评论区互动策略、用户反馈回流和二次选题信号提炼 |
| [code-team](agents/code-team.md) | 编程团队流程编排器 - 负责组织项目经理、技术、开发、测试和 Git 协作角色按流程协同工作 |
| [code-solution-consultant](agents/code-solution-consultant.md) | 售前售后解决方案顾问 - 负责对接客户、澄清需求、完善边界、管理预期并回流售后反馈 |
| [code-web-expert](agents/code-web-expert.md) | Web工程师 - 在 `code-team` 编排和项目经理任务拆解基础上负责 Web 页面、交互实现和联调交付 |
| [code-java-backend](agents/code-java-backend.md) | Java后端工程师 - 在 `code-team` 编排和项目经理任务拆解基础上负责接口、业务规则和数据模型实现 |
| [code-python-engineer](agents/code-python-engineer.md) | Python工程师 - 在 `code-team` 编排和项目经理任务拆解基础上负责 Python 服务、自动化、数据处理和 AI 应用外围工程 |
| [code-tech-director](agents/code-tech-director.md) | 技术总监 - 作为 `code-team` 与项目经理的技术支撑角色，负责架构方案、接口约定和技术边界统一 |
| [code-project-manager](agents/code-project-manager.md) | 项目经理 - 作为项目负责人负责需求分析、任务拆解、角色分配、依赖梳理和验收标准 |
| [code-uniapp-expert](agents/code-uniapp-expert.md) | UniApp跨端工程师 - 在 `code-team` 编排和项目经理任务拆解基础上负责多端实现与兼容交付 |
| [git-manager](agents/git-manager.md) | Git管理专家 - 作为 `code-team` 与项目经理的协作保障角色负责分支策略、提交规范、冲突处理和交付收口 |
| [code-qa-engineer](agents/code-qa-engineer.md) | 测试工程师 - 在 `code-team` 编排和项目经理任务背景基础上负责测试验证、放行判断和质量反馈 |

## 已配置的技能模块

### 🛠️ Skills（技能）

| 技能 | 描述 |
|------|------|
| [mysql-operator](skills/mysql-operator.md) | MySQL数据库操作 - 建表SQL生成、查询性能分析、索引优化、数据迁移 |
| [redis-operator](skills/redis-operator.md) | Redis缓存操作 - 缓存Key设计、缓存读写代码、穿透/击穿/雪崩解决方案、分布式锁 |
| [mongodb-operator](skills/mongodb-operator.md) | MongoDB文档数据库操作 - 集合管理、文档CRUD、聚合查询、索引优化、备份恢复 |
| [postgresql-operator](skills/postgresql-operator.md) | PostgreSQL数据库操作 - 建表SQL生成、查询性能分析、JSON/全文搜索、数组类型、窗口函数、数据迁移 |
| [nvm-operator](skills/nvm-operator.md) | NVM版本管理 - Node.js版本安装切换、版本别名、全局包迁移、项目环境配置 |
| [node-operator](skills/node-operator.md) | Node.js运行环境 - 应用执行、npm包管理、脚本运行、调试分析、环境配置 |
| [java-operator](skills/java-operator/) | Java开发环境 - javac编译、java执行、jar打包、Maven/Gradle构建、性能分析 |
| [jenv-operator](skills/jenv-operator.md) | JEnv版本管理 - Java版本安装切换、全局/本地/Shell版本设置、环境变量配置 |
| [file-operator](skills/file-operator/) | 文件系统操作 - 创建/移动/重命名/删除/复制文件和文件夹、批量操作、文件查找 |

## 配置文件说明

### 项目配置 (.claude/)

| 文件 | 说明 | Git 跟踪 |
|------|------|----------|
| [settings.json](.claude/settings.json) | 项目设置和规则 | ✅ 是 |
| agents/ | 项目级智能体 | ✅ 是 |
| skills/ | 项目级技能 | ✅ 是 |
| mcp.json | MCP 服务器配置 | ✅ 是 |
| hooks/ | 钩子脚本 | ✅ 是 |

### 全局配置 (~/.claude/)

| 文件 | 说明 | 作用范围 |
|------|------|----------|
| CLAUDE.md | 全局记忆和规则 | 所有项目 |
| settings.json | 全局设置 | 所有项目 |
| .claude.json | 全局 MCP 配置 | 所有项目 |
| agents/ | 全局智能体 | 所有项目 |
| skills/ | 全局技能 | 所有项目 |

## 使用指南

### 1. 使用智能体

```bash
# 在 Claude Code 中调用智能体
@media-team              # 矩阵运营内容团队（第三方媒体平台文章生产与分发）
@video-team              # 媒体视频团队（抖音、视频号、快手、B站等视频平台）
@prompt-architect        # 提示词架构师
@agent-soul              # Agent 人格定义师
@media-chief-editor      # 内容总编
@media-trend-scout       # 热点侦察员
@media-topic-strategist  # 选题策划师
@media-research-analyst  # 资料研究员
@media-article-writer    # 文章写手
@media-quality-guard     # 内容质检官
@media-platform-optimizer # 平台优化师
@media-growth-analyst    # 增长分析师
@video-script-writer     # 视频脚本师
@video-storyboard-designer # 分镜设计师
@video-production-coordinator # 视频生产协调官
@video-packaging-director # 剪辑包装师
@video-quality-guard     # 视频质检官
@video-platform-optimizer # 视频平台优化师
@video-growth-analyst    # 视频增长分析师
@video-publisher         # 视频发布执行官
@video-community-operator # 评论区运营官
@code-team               # 编程团队流程编排器
@code-solution-consultant # 售前售后解决方案顾问
@code-web-expert         # Web 工程师
@code-java-backend       # Java 后端工程师
@code-python-engineer    # Python 工程师
@code-tech-director      # 技术总监
@code-project-manager    # 项目负责人
@code-uniapp-expert      # UniApp 跨端工程师
@code-qa-engineer        # 测试工程师
@git-manager             # Git 管理专家
```

### 2. 使用技能

```bash
# 在 Claude Code 中调用技能
/mysql-operator          # MySQL 操作
/redis-operator          # Redis 操作
/mongodb-operator        # MongoDB 操作
/postgresql-operator     # PostgreSQL 操作
/nvm-operator            # NVM 版本管理
/node-operator           # Node.js 运行环境
/java-operator           # Java 开发环境
/jenv-operator           # JEnv 版本管理
/file-operator           # 文件系统操作
```

### 2.1 编程多 Agent 协作入口（流程编排 + 项目负责人）

需要**客户对接 + 项目经理 + 前端 + 后端 + 测试 + 技术方案**协作时，直接使用 `@code-team`：

- **你只需**：说出需求（如「用编程团队做一个 XXX 功能」或「让编程团队按流程推进这个需求」）。
- **code-team 会**：如果输入更像客户原话或客户反馈，会先调用 `code-solution-consultant` 做需求澄清和边界整理；然后再调用 `code-project-manager` 做需求拆解与角色分工，再按复杂度决定是否引入 `code-tech-director`，然后把工作分给前端（`code-web-expert` / `code-uniapp-expert`）、后端（`code-java-backend` / `code-python-engineer`）、测试（`code-qa-engineer`），必要时再调用 `git-manager` 做协作收口，最后统一汇总团队交付结果。
- **code-project-manager 的定位**：负责项目内容本身，包括需求分析、任务拆解、依赖关系、优先级和验收标准；它不再承担整个流程编排器职责。
- **code-solution-consultant 的定位**：负责客户侧沟通，包括需求访谈、售前澄清、边界确认、预期管理和售后反馈回流；它先把客户语言整理成团队能接手的输入。

流程：流程入口 `code-team` → 客户需求澄清（按需）→ 项目经理拆解任务 → 技术方案补充（按需）→ 前端 / Java 后端 / Python 工程执行 → 测试验证 → Git 收口（按需）→ 汇总交付。

**推荐启动方式：**
- 默认直接启动 `@code-team`
- 如果你只是想先拆需求，不急着开发，可以先单独使用 `@code-project-manager`
- 如果只是单点修复或单点实现，也可以直接调用对应专家角色，但不属于团队自动协作模式

**自动协作顺序建议：**
1. `@code-team`
2. `@code-solution-consultant`（客户需求 / 客户反馈场景按需）
3. `@code-project-manager`
4. `@code-tech-director`（复杂需求按需）
5. `@code-web-expert` / `@code-uniapp-expert` 与 `@code-java-backend` / `@code-python-engineer`
6. `@code-qa-engineer`
7. `@git-manager`（需要提交、分支、PR、冲突处理时）

**可直接复制的用法：**

```text
@code-team
帮我完成一个 XXX 需求，请按编程团队流程自动协作：
1. 如果我的输入更像客户原话或客户反馈，先帮我做需求澄清和边界整理
2. 再让项目经理做需求分析、任务拆解和角色分工
3. 如果需求复杂，先补技术方案和接口边界
4. 再安排前端和合适的后端角色执行（Java 或 Python）
5. 然后做测试验证
6. 如有需要再做 Git 协作收口
7. 最后统一汇总结果给我
```

**适合场景：**
- 新功能开发
- 跨前后端协作
- 中大型需求拆解与推进
- 需要从需求到测试完整闭环的场景
- 需要先对接客户、澄清需求或处理售后反馈再进入研发流程的场景
- 同时存在 Java 主系统、Python 工具链、自动化任务或 AI 应用外围工程的场景

### 2.2 矩阵运营内容团队（尽量无人工审核）

需要围绕 **第三方媒体平台** 做文章选题、研究、写作、自动质检、平台改写和数据复盘时，使用 `@media-team`：

- **你只需**：给出行业方向、目标平台、目标读者和本轮目标（如引流、涨粉、转化、曝光）。
- **media-team 会**：先由内容总编拆目标并分配任务，再让热点侦察员、选题策划师、资料研究员、文章写手、内容质检官、平台优化师、增长分析师按流程协作，最后汇总为可发布方案。
- **自动质检机制**：默认通过 `media-quality-guard` 做发布前门禁，尽量替代人工审核；如果识别为高风险内容，则会直接建议终止发布或降风险改写。

流程：目标拆解 → 热点与选题 → 资料研究 → 初稿写作 → 自动质检 → 平台适配 → 数据复盘。

**推荐启动方式：**
- 默认直接启动 `@media-team`
- 不建议一开始手动逐个启动写手、质检、平台优化等角色，除非你只需要其中某一个单点能力

**自动协作顺序建议：**
1. `@media-team`
2. `@media-chief-editor`
3. `@media-trend-scout`
4. `@media-topic-strategist`
5. `@media-research-analyst`
6. `@media-article-writer`
7. `@media-quality-guard`
8. `@media-platform-optimizer`
9. `@media-growth-analyst`

**可直接复制的用法：**

```text
@media-team
请围绕 XXX 行业做一轮第三方媒体平台文章协作，按团队流程自动推进：
1. 先拆解目标和内容方向
2. 再做热点、选题和资料研究
3. 产出文章初稿
4. 做自动质检和风险筛查
5. 输出平台适配版本
6. 最后给出复盘和下一轮优化建议

目标平台：公众号 / 头条 / 百家号
目标读者：XXX
本轮目标：引流 / 涨粉 / 转化 / 曝光
```

**适合场景：**
- 文章矩阵运营
- 第三方平台分发
- 低人工审核内容生产
- 需要“选题到复盘”完整闭环的场景

### 2.3 媒体视频团队（低人工干预）

需要围绕 **抖音、视频号、快手、B站等视频平台** 做视频选题、研究、脚本、分镜、剪辑包装、视频质检、平台适配、发布执行和复盘时，使用 `@video-team`：

- **你只需**：给出行业方向、目标平台、目标读者和本轮目标（如播放、完播、互动、涨粉、转化）。
- **video-team 会**：先复用内容总编、热点、选题、研究四类中台角色，再调用视频脚本师、分镜设计师、视频生产协调官、剪辑包装师、视频质检官、视频平台优化师、视频发布执行官、评论区运营官、视频增长分析师协作，最后汇总为可发布的视频方案。
- **自动质检机制**：默认通过 `video-quality-guard` 做脚本初检和平台终检，尽量替代人工审核；若识别为高风险或高误导内容，会直接终止或要求降级改写。

流程：目标拆解 → 热点/选题/研究 → 视频脚本 → 分镜设计 → 生产协调 → 剪辑包装 → 初检 → 平台适配 → 发布素材包/评论区方案 → 终检 → 视频复盘。

**推荐启动方式：**
- 默认直接启动 `@video-team`
- 如果只是单独做脚本、分镜或平台优化，可以单独调用对应视频角色；如果要整套自动运作，仍然应从 `@video-team` 开始

**自动协作顺序建议：**
1. `@video-team`
2. `@media-chief-editor`
3. `@media-trend-scout`
4. `@media-topic-strategist`
5. `@media-research-analyst`
6. `@video-script-writer`
7. `@video-storyboard-designer`
8. `@video-production-coordinator`
9. `@video-packaging-director`
10. `@video-quality-guard`
11. `@video-platform-optimizer`
12. `@video-publisher`
13. `@video-community-operator`
14. `@video-growth-analyst`

**可直接复制的用法：**

```text
@video-team
请围绕 XXX 方向做一轮视频平台自动协作，按团队流程推进：
1. 先拆解本轮视频目标
2. 再做热点、选题和资料研究
3. 输出视频脚本和分镜
4. 判断最合适的生产方式
5. 给出剪辑包装方案
6. 做视频初检和平台适配
7. 输出发布素材包和评论区策略
8. 最后做复盘优化建议

目标平台：抖音 / 视频号 / 快手 / B站
目标受众：XXX
本轮目标：播放 / 完播 / 互动 / 涨粉 / 转化
```

**适合场景：**
- 视频内容矩阵运营
- 短视频或中视频团队协作
- 从选题到发布执行的完整视频闭环
- 希望尽量降低人工干预的视频运作场景

### 3. Cursor 子智能体

在 **Cursor** 中如需同步项目级智能体，可将 `agents/` 下的对应定义同步到 `.cursor/agents/`。当前编程团队建议入口为 `code-team`，由它负责流程编排，再调用 `code-project-manager` 负责项目内容。

### 4. 添加新的智能体

1. 在 `agents/` 目录创建新的 `.md` 文件
2. 添加 YAML frontmatter 配置
3. 编写智能体的系统提示词
4. 更新本 README.md

**示例配置：**
```yaml
---
name: your-agent-name
description: |
  智能体描述，说明使用场景和核心能力

model: sonnet
color: blue
---

你是 [角色定位]，专注于 [专业领域] 的 [核心任务]。
```

### 5. 添加新的技能

1. 在 `skills/` 目录创建新的技能文件夹，如 `skills/your-skill-name/`
2. 在该文件夹中创建 `SKILL.md`
3. 添加 YAML frontmatter 配置
4. 编写技能的具体操作指令
5. 如有需要，增加 `scripts/`、参考文档等配套文件
6. 更新本 README.md

**示例配置：**
```yaml
skills/your-skill-name/SKILL.md
```

```yaml
---
name: your-skill-name
description: |
  技能描述，说明使用场景和核心功能

model: sonnet
color: green
---

你是 [技能名称]，能够 [核心能力]。
```

## 目录结构最佳实践

### Agents vs Skills

| 类型 | 用途 | 示例 |
|------|------|------|
| **Agents** | 具有专业角色的 AI 助手 | Java架构师、Web开发专家、技术总监 |
| **Skills** | 可重用的操作技能 | MySQL操作、Redis操作、NVM管理 |

**选择原则：**
- 需要**角色定位**和**专业知识** → 使用 Agents
- 需要**具体操作**和**工具调用** → 使用 Skills

---

**最后更新**：2026-03-22