# fe-agent-workflow

**Repository Path**: fivegod/fe-agent-workflow

## Basic Information

- **Project Name**: fe-agent-workflow
- **Description**: 这是一套为  Vue中后台/react中后台/uniapp项目 定制的前端落地 Agent 工作流配置，通过 Rules（怎么写对）+ Skills（什么时候做什么）+ SDD 文档（写什么、怎么验收） 三层协作，让 AI 能按团队规范 从需求到代码到验收 完成标准 CRUD 页面开发、增量改页、接口联调、Bug 修复和代码规范化，避免代码写乱、返工多、协作难的问题。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# fe-agent-workflow

HiShop 前端落地 Agent 工作流 - **fe-agent-workflow** **权威源**（rules + skills + SDD 文档）。

这是一套为  Vue中后台/react中后台/uniapp项目 定制的前端落地 Agent 工作流配置，通过 Rules（怎么写对）+ Skills（什么时候做什么）+ SDD 文档（写什么、怎么验收） 三层协作，让 AI 能按团队规范 从需求到代码到验收 完成标准 CRUD 页面开发、增量改页、接口联调、Bug 修复和代码规范化，避免代码写乱、返工多、协作难的问题。

三套平台**并列维护，不拆公共内核目录**；内核级变更按 [`docs/agent-kernel-sync.md`](docs/agent-kernel-sync.md) 在 `pc-vue` ↔ `pc-react` ↔ `uniapp` 之间同步。默认AI工具 Cursor，内置支持迁移Claude code、ChatGPT等工具。

**当前版本（2026-07-28）：**

| 平台 | `platform` | `kernelVersion` | `bundleVersion` | 变更明细 |
|------|------------|-----------------|-----------------|----------|
| Vue 中后台 | `pc-vue` | **1.5.0** | **1.6.0** | [pc-vue CHANGELOG](pc-vue/.cursor/skills/CHANGELOG.md) |
| React 中后台 | `pc-react` | **1.5.0** | **1.3.0** | [pc-react CHANGELOG](pc-react/.cursor/skills/CHANGELOG.md) |
| uni-app | `uniapp` | **1.5.0** | **1.11.0** | [uniapp CHANGELOG](uniapp/.cursor/skills/CHANGELOG.md) |

跨平台总览：[CHANGELOG.md](CHANGELOG.md)

## 文档

| 文档 | 说明 |
|------|------|
| [docs/agent-workflow-training.md](docs/agent-workflow-training.md) | **培训材料**（详细了解这套Agent工作流） |
| [CHANGELOG.md](CHANGELOG.md) | **跨平台发布说明**（本仓总览） |
| [docs/README.md](docs/README.md) | **文档分类索引**（共享 vs 平台规范性） |
| [docs/agent-workflow-roadmap.md](docs/agent-workflow-roadmap.md) | **演进路线**（全工作流共用，不按端复制） |
| [docs/agent-workflow-comparison.md](docs/agent-workflow-comparison.md) | 与 OpenSpec、Superpowers 等对比 |
| [docs/agent-host-export.md](docs/agent-host-export.md) | 跨 Host 导出（Claude / Codex） |
| [docs/agent-workflow-repo-guide.md](docs/agent-workflow-repo-guide.md) | 维护者：权威仓 / install（仅仓内） |
| [docs/agent-kernel-sync.md](docs/agent-kernel-sync.md) | 三端内核同步清单 |
| [docs/project-refactor-guide.md](docs/project-refactor-guide.md) | 全项目重构 SDD（`project-refactor`） |
| [docs/vue3-migration-guide.md](docs/vue3-migration-guide.md) | Vue2→Vue3（`vue3-migration`，Vue 端） |
| `<platform>/docs/constitution.md` + `features/` | **平台规范性**（随 install 装入业务仓） |

## 目录

```
fe-agent-workflow/
├── README.md / CHANGELOG.md
├── docs/                 # 共享 meta：统一培训、演进、对比、同步…（见 docs/README.md）
├── tools/install.sh      # --with-docs = 平台模板 + docs/ 共享文件
├── pc-vue/               # .cursor + docs/{constitution,features}
├── pc-react/
└── uniapp/
```

## 安装到业务项目

### 直接从 Git 安装

权威仓：https://gitee.com/fivegod/fe-agent-workflow

直接在项目Agent会话中执行：
```bash
从 git 仓库安装 Agent 工作流：https://gitee.com/fivegod/fe-agent-workflow
```
or
```bash
curl -fsSL https://gitee.com/fivegod/fe-agent-workflow/raw/master/tools/remote-install.sh \
  | bash -s -- pc-react /path/to/project --with-docs
```

将对应平台 `.cursor` **整包覆盖**到目标项目根目录的 `.cursor/`（**保留**目标项目已有的 `project-conventions.md`）。

### 本地已 clone（维护者常用）

```bash
# Vue 中后台
./tools/install.sh pc-vue /path/to/your-vue-admin

# React 中后台（Hooks + TS）
./tools/install.sh pc-react /path/to/your-react-admin --with-docs

# uni-app 移动端
./tools/install.sh uniapp /path/to/your-uniapp --with-docs
```

## 版本字段

各平台 `*/.cursor/skills/manifest.json`：

- `platform`: `pc-vue` | `pc-react` | `uniapp`
- `kernelVersion`: 内核版本（**三端应对齐**）
- `bundleVersion`: 本平台整体版本（可分叉）

校验：

```bash
python3 pc-vue/.cursor/skills/scripts/skills-version.py check
python3 pc-react/.cursor/skills/scripts/skills-version.py check
python3 uniapp/.cursor/skills/scripts/skills-version.py check
```

## 业务项目（消费方）

| 平台 | 说明 |
|------|------|
| pc-vue | 任意 Vue 中后台业务仓 |
| pc-react | 任意 React Hooks + TS 中后台业务仓 |
| uniapp | 任意 uni-app 移动端业务仓 |

业务仓 `.cursor` 视为**安装产物**；流程变更请在本仓修改后执行 `install.sh`。不绑定某一具体业务仓库名称。