# agent-workflows

**Repository Path**: mdsfe/agent-workflows

## Basic Information

- **Project Name**: agent-workflows
- **Description**: 前端团队日常开发 Agent 工作流集合
- **Primary Language**: Unknown
- **License**: ISC
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-04
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mdsfe-agent-workflows

> v0.2.0 `mdsfe`

MDSFE 前端团队日常开发 Agent 工作流与全局 Skills 集合。采用多语言目录结构，支持中文 (`zh-CN`) 和英文 (`en-US`) 版本，方便全球化复用。

## 📁 目录结构

- **/zh-CN**: 中文版工作流模板、Cursor 兼容命令与技能输出。
- **/en-US**: English workflow templates, Cursor-compatible commands, and skills output.
- **/docs**: 项目工程化文档、贡献指南及 VitePress 配置。

## 🚀 快速开始

### 方式一：通过 mds-cli 初始化 (推荐)

在您的项目根目录下运行：

```bash
# 初始化中文版
mds sdd --zh

# 初始化英文版
mds sdd

# 罗列全局 skills
mds skills --list

# 安装全部全局 skills
mds skills --clone
```

### 方式二：手动同步

将对应语言目录下的 `.agent` 和 `.specify` 文件夹复制到您的项目根目录。

## 🛠️ 核心工作流亮点

### 深度代码审查 (igit-mr-review)
保留 `/igit-mr-review` 高频入口，同时切换到基于 `igit-mr-bootstrap` 的本地 CLI 执行链路，不再要求 IDE 预先注册 MCP；审查前仍要求 Agent 做架构层面的深度思考，并输出包含“核心意图分析”和“长远维护风险”的专家报告。

### 安全执行预检 (cbm-preflight)
采用 **Safe Execution Plan** 策略，在启动 CBM 服务前自动化验证端口冲突、Node 运行时版本对齐及依赖完整性，提升复杂环境下的启动成功率。

### 全局环境感知 (environment-context)
基于顶级 Agent (如 v0) 的感知逻辑，自动识别项目中的 Tailwind, Shadcn UI, Next.js 等技术栈，并应用极致的前端审美控制规则。

### 文档站初始化增强 (init-vitepress)
`init-vitepress` 已标准 skill 化，默认要求交付带 Mermaid 图表渲染能力的 VitePress 站点，适配更多支持 skills 的 IDE 与 AI 工具。

### CLI 高频快捷技能补齐
新增 `58npm-publish-skills` 与 `igit-mr-review` 两个全局技能，方便通过 `mds-cli skills` 或安装脚本快速分发到支持 skills 的 IDE 和 AI 工具中。

---

## 📖 贡献指南

欢迎提交新的工作流！请根据语言类型在对应文件夹下提交。详细规范请参考 [贡献指南](./docs/contributing.md)。

如需转换工作流格式，请运行：

```bash
npm run convert:cursor
```