# CMS-AgentWork

**Repository Path**: vichen2021/cms-agent-work

## Basic Information

- **Project Name**: CMS-AgentWork
- **Description**: 基于Yi.Mini框架的AI开发工作台
https://gitee.com/vichen2021/yiabp-mini
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/vichen2021/yiabp-mini
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WJCMS WorkSpace

`WJ-CMS-Agent-Work` 是 WJ-CMS 多分支开发工作区，用于同时维护基础底座、产品基础分支和具体产品分支。

## 目录结构

```text
WJ-CMS-Agent-Work/
├── Config/                   # 工作区配置示例
├── Templates/                # 任务、总结、计划、ADR、日报、周报模板
├── docs/                     # 跨分支设计、计划、决策和检查清单
├── prompts/                  # WJ-CMS 专用提示词库
├── scripts/                  # 工作区辅助脚本
├── WorkTrees/                # 多分支工作副本
│   ├── master-branch/        # master 分支工作副本，只维护产品无关基础底座
│   ├── main-branch/          # wj-cms/main 产品基础分支工作副本
│   └── product-rocom-branch/ # wj-cms/rocom 具体产品分支工作副本
├── 任务/                     # 任务生命周期：待处理、进行中、待测试、已完成
├── 日报/                     # 每日研发记录
└── 周报/                     # 每周研发总结
```

## 分支边界

- **WorkTrees/master-branch**：只处理产品无关基础底座能力（`rbac`、`tenant-management`、`setting-management`、`file-management`、`audit-logging`、通用框架能力）。
- **WorkTrees/main-branch**：处理可被多个 ToC 产品复用的 WJ-CMS 产品基础能力（`app-management`、`article`、`member`、`media-management`）。
- **WorkTrees/product-rocom-branch**：处理 rocom 产品专属差异能力，只实现产品特有逻辑。

## 强制规则

- **禁止在错误分支实现能力**：修改前必须先判断能力归属。
- **禁止把 ToC 产品能力写入 WorkTrees/master-branch**：文章、会员、App 运营、素材运营、商城、订单、支付等不得进入 `master`。
- **禁止把具体产品差异反向污染 wj-cms/main**：rocom 专属能力应保留在 `WorkTrees/product-rocom-branch`。
- **禁止绕过生成器手写基础 CRUD**：进入后端仓库后，新增模块、CRUD、字段同步必须遵守仓库内 `AGENTS.md` 和相关 skill 规则。
- **禁止无关格式化和大范围重构**：只修改当前任务直接相关文件。

## 推荐工作流

1. 判断任务属于基础底座、产品基础还是 rocom 差异。
2. 进入对应工作副本目录。
3. 阅读对应仓库的 `AGENTS.md`。
4. 按模块边界和 skill 规则实施。
5. 构建或检查受影响项目。
6. 使用中文提交说明提交代码。
7. 按同步方向下沉变更。

## 同步方向

```text
WorkTrees/master-branch
  ↓
WorkTrees/main-branch
  ↓
WorkTrees/product-rocom-branch
```

除非明确处理回补或抽象上移，否则不要反向同步业务代码。

## 任务生命周期

```text
待处理 -> 进行中 -> 待测试 -> 已完成
```

每个任务建议使用独立目录：

```text
任务/进行中/20260518-001_接入文章详情真实数据/
├── README.md
├── images/
├── docs/
└── refs/
```

## 常用入口

- 分支说明：`docs/branches/README.md`
- 架构设计：`docs/architecture/README.md`
- 阶段计划：`docs/plans/README.md`
- 架构决策：`docs/decisions/README.md`
- 检查清单：`docs/checklists/README.md`
- 任务管理：`任务/README.md`
- 模板目录：`Templates/`
- 提示词库：`prompts/`
- Git 辅助脚本：`scripts/git/README.md`
- 同步辅助脚本：`scripts/sync/README.md`
- 任务辅助脚本：`scripts/task/README.md`

## 常用脚本

```powershell
.\scripts\git\status-all.ps1
```

```powershell
.\scripts\task\create-task.ps1 -Title "接入文章详情真实数据"
```

```powershell
.\scripts\task\move-task.ps1 -TaskName "20260518-001_接入文章详情真实数据" -From "进行中" -To "待测试"
```

```powershell
.\scripts\task\new-daily.ps1
```