# ai-developer

**Repository Path**: chichengyu/ai-developer

## Basic Information

- **Project Name**: ai-developer
- **Description**: Codex工具技能包，包含数据库查询分析和研发管控契约两个技能。 安装后只需说话就能查询 MySQL 数据库、分析表结构、对比 Java 实体，并遵循标准化的研发管控流程。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2026-07-15
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-developer — AI 开发者 Codex 技能套件

<p align="center">
  <img src="https://img.shields.io/badge/Java-17%2B-orange?logo=openjdk&logoColor=white" />
  <img src="https://img.shields.io/badge/Python-3.8%2B-blue?logo=python&logoColor=white" />
  <img src="https://img.shields.io/badge/Node.js-18%2B-green?logo=nodedotjs&logoColor=white" />
  <img src="https://img.shields.io/badge/Codex-Skill-blueviolet" />
  <img src="https://img.shields.io/badge/license-MIT-green" />
</p>

## 项目简介

**ai-developer** 是一套面向 AI 开发者的 Codex 技能集合，覆盖 Java 研发现控、跨平台应用交付、AI 漫剧视频制作和网络采集（含合规与反爬）。本仓库提供两种分发形态：

| 形态 | 位置 | 说明 |
|------|------|------|
| 原始技能 | [skills/](skills/README.md) | 9 个可独立安装、按需组合的 Codex 技能目录 |
| Codex 插件 | [plugin/](plugin/README.md) | 同一组技能打包为 `ai-developer-skill-plugin`，可通过通用安装器或各 Agent 市场一键安装 |
| 通用安装说明 | [INSTALL.md](INSTALL.md) | Codex、Claude Code、Cursor、OpenCode 等桌面 Agent 的完整安装方式 |

插件中的技能以**独立副本**形式打包，修改插件不会影响 `skills/` 中的原始技能。

## 快速开始

**Windows（PowerShell，在仓库根目录执行）**

```powershell
Get-ChildItem .\skills\skills -Directory | ForEach-Object {
  Copy-Item $_.FullName "$env:USERPROFILE\.codex\skills\$($_.Name)" -Recurse -Force
}
```

**macOS / Linux**

```bash
mkdir -p ~/.codex/skills && cp -r skills/skills/* ~/.codex/skills/
```

**安装单个技能（示例：multi-db-analyzer）**

```cmd
xcopy /E /I /Y skills\skills\multi-db-analyzer "%USERPROFILE%\.codex\skills\multi-db-analyzer"
```

安装后重启 Codex，即可按需使用，例如：“帮我分析数据库”“帮我做一个桌面应用”“帮我抓取网站或媒体”“做一条漫剧视频”。完整安装清单与可选依赖见 [skills/README.md](skills/README.md#安装)。

## 目录结构

```
ai-developer/
+-- README.md                        # 本文件（总索引）
+-- INSTALL.md                       # 多桌面 Agent 通用安装说明
+-- .agents/
|   +-- plugins/
|       +-- marketplace.json         # Codex 远程 Git 市场清单
+-- .claude-plugin/
|   +-- marketplace.json             # Claude Code 市场清单
+-- .cursor-plugin/
|   +-- marketplace.json             # Cursor 市场清单
+-- .opencode/
|   +-- INSTALL.md                   # OpenCode 安装说明
+-- scripts/                         # 多 Agent 通用安装器
+-- skills/                          # 原始技能目录
|   +-- README.md
|   +-- skills/
|       +-- multi-db-analyzer/
|       +-- java-superpowers-contract/
|       +-- token-economizer/
|       +-- desktop-app-dev/
|       +-- mobile-app-dev/
|       +-- scraper-unblocker/
|       +-- anti-bot-web-scraper/
|       +-- manga-drama-video/
|       +-- manga-drama-video-helper/
+-- plugin/                          # Codex 插件（ai-developer-skill-plugin）
    +-- README.md
    +-- ai-developer-skill-plugin/
        +-- .codex-plugin/plugin.json
        +-- skills/                  # 9 个技能的独立副本（723 个文件）
        +-- assets/
```

## skills/ —— 原始技能目录

详见 **[skills/README.md](skills/README.md)**。

* 每个技能均可独立复制到 `~/.codex/skills/`，也可按需组合使用。
* 技能源码统一位于 `skills/skills/<技能名>/`。
* `multi-db-analyzer` 为纯 Python 实现，`token-economizer` 为纯指令契约、零外部依赖，其余技能按各自 `SKILL.md` 安装对应工具链。

## plugin/ —— Codex 插件

详见 **[plugin/README.md](plugin/README.md)**。

| 项 | 值 |
|----|----|
| 插件名称 | `ai-developer-skill-plugin` v1.0.0，作者 `chichengyu`，License MIT |
| 插件清单 | [plugin/ai-developer-skill-plugin/.codex-plugin/plugin.json](plugin/ai-developer-skill-plugin/.codex-plugin/plugin.json) |
| 技能副本目录 | [plugin/ai-developer-skill-plugin/skills/](plugin/ai-developer-skill-plugin/skills/) |
| 安装说明 | [plugin/README.md#安装](plugin/README.md#安装) |
| 验证脚本 | [plugin/README.md#验证](plugin/README.md#验证) |
| 重新打包 | [plugin/README.md#重新打包如有更新](plugin/README.md#重新打包如有更新) |

完整说明见 **[INSTALL.md](INSTALL.md)**。

通用远程安装，不需要 Python，也不需要先 clone：

Windows：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -Command "Invoke-WebRequest -UseBasicParsing https://gitee.com/chichengyu/ai-developer/raw/master/scripts/remote_install.ps1 -OutFile $env:TEMP\install-ai-developer.ps1; & $env:TEMP\install-ai-developer.ps1 -All"
```

macOS / Linux：

```bash
curl -fsSL https://gitee.com/chichengyu/ai-developer/raw/master/scripts/remote_install.sh | bash -s -- --all
```

各 Agent 也可以使用原生市场安装：Codex 执行 `codex plugin marketplace add https://gitee.com/chichengyu/ai-developer.git`；Claude Code 执行 `/plugin marketplace add https://gitee.com/chichengyu/ai-developer`；Cursor 在插件市场添加同一 Git URL；OpenCode 按 [.opencode/INSTALL.md](.opencode/INSTALL.md) 安装。

## skills/ 与 plugin/ 的关系

* **独立副本**：插件内 `skills/` 是原始 `skills/skills/` 中 9 个技能的完全独立副本（723 个文件）。
* **互不影响**：修改插件不会影响原始技能，反之亦然。
* **最小适配**：仅在插件副本中，8 个 `agents/openai.yaml` 与 1 个 `mobile-app-dev/SKILL.md` 做了 Codex 插件 schema 最小化修改，原始技能文件保持不变。

## 技能协作链路

```mermaid
sequenceDiagram
    participant Dev as 开发者
    participant Codex as Codex Agent
    participant JSC as java-superpowers-contract
    participant MDA as multi-db-analyzer
    participant TE as token-economizer

    Dev->>Codex: 发起 Java 开发任务
    Codex->>JSC: 1. 激活研发现控契约<br/>两阶段工作流
    JSC-->>Codex: 分析阶段完成
    Codex->>MDA: 2. 按需分析数据库<br/>Schema / 数据质量 / FK 拓扑 / 执行计划
    MDA-->>Codex: 分析结果返回
    Codex->>TE: 3. 输出端无感压缩
    TE-->>Codex: 压缩后回复
    Codex-->>Dev: 交付结果 + 【执行审计】
```

`desktop-app-dev` 与 `mobile-app-dev` 可独立完成从需求分析、框架选型到打包验证、交付的完整流程；`desktop-app-dev` 同时提供媒体采集、HLS 下载、转码发布、Web/API 数据流水线与源码保护模板；`scraper-unblocker` 负责合规网站与媒体深爬，`anti-bot-web-scraper` 负责 Cloudflare/WAF/Turnstile/CAPTCHA 等复杂反爬站点的多后端升级采集，两者可与桌面应用采集链路配合；`manga-drama-video` 提供 10 步审批门禁的完整漫剧视频流水线，`manga-drama-video-helper` 提供更轻量的三阶段版本。需要更严格的跨集一致性锁和 De-AI 审计时，可把 helper 产物转交 `manga-drama-video` 继续生产。

## 链接索引

* 原始技能说明：[skills/README.md](skills/README.md)
* 插件说明：[plugin/README.md](plugin/README.md)
* 插件清单：[plugin/ai-developer-skill-plugin/.codex-plugin/plugin.json](plugin/ai-developer-skill-plugin/.codex-plugin/plugin.json)
* 插件技能副本目录：[plugin/ai-developer-skill-plugin/skills/](plugin/ai-developer-skill-plugin/skills/)