# mr-tdd-skills

**Repository Path**: nodeing/mr-tdd-skills

## Basic Information

- **Project Name**: mr-tdd-skills
- **Description**: 多角色测试驱动开发skills
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-07
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MR-TDD Skills

多角色 TDD 开发流程的 AI Skills 集合，支持 Factory Droid、OpenAI Codex、Claude Code 三个平台。

## 推荐安装方式（全局命令）

### Linux / macOS

```bash
curl -fsSL https://gitee.com/nodeing/mr-tdd-skills/raw/main/install-cli.sh | bash
```

默认安装到 `~/.local/bin/mrtdd`，可通过 `--bin-dir` 指定目录。

### Windows (PowerShell)

```powershell
iwr https://gitee.com/nodeing/mr-tdd-skills/raw/main/install-cli.ps1 -OutFile install-cli.ps1
powershell -ExecutionPolicy Bypass -File .\install-cli.ps1
```

默认安装到 `~/.local/bin\mrtdd.cmd` 与 `~/.local/bin\mrtdd.ps1`，可通过 `--bin-dir` 指定目录。

## 在任意目录安装 Skills

```bash
# 安装到当前目录
mrtdd install

# 安装到指定目录
mrtdd install --target /path/to/project
```

Windows 目录示例：

```powershell
mrtdd install --target C:\work\your-project
```

## 兼容方式（旧命令）

### Linux / macOS

```bash
curl -fsSL https://gitee.com/nodeing/mr-tdd-skills/raw/main/install.sh | bash
```

### Windows (PowerShell)

```powershell
iwr https://gitee.com/nodeing/mr-tdd-skills/raw/main/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1
```

`install.sh` / `install.ps1` 内部都会统一转发到 `mrtdd install`。

## 包含的 Skills

| Skill | 触发词 | 输出 |
|-------|--------|------|
| `mr-tdd-core` | 任何任务前 | Project Profile（commands/repo_layout/integration_gate/dependencies/test_doubles/test_helpers） |
| `mr-tdd-architect` | "作为架构师" | `docs/specs/{feature}_spec.md` |
| `mr-tdd-tester` | "作为测试工程师" | `server/tests/test_{feature}_*.py` |
| `mr-tdd-developer` | "作为开发工程师" | 实现代码（Green） |
| `mr-tdd-auditor` | "作为审计工程师" | 审计报告 |
| `mr-tdd-refactor-planner` | "作为重构规划师" | `docs/refactor/{feature}_refactor.md` |
| `mr-tdd-refactor` | "作为重构工程师" | 重构后代码（Green → Green） |

## 工作流

### L 级：新功能开发

```
先执行 mr-tdd-core，输出 Project Profile
作为架构师，设计xxx的spec → Spec 文件
作为测试工程师，写xxx的测试 → 测试代码（Red）
作为开发工程师，实现xxx功能 → 实现代码（Green）
作为审计工程师，审计xxx → 审计报告
```

### R 级：代码重构

```
作为重构规划师，制定xxx重构计划 → 重构计划文档
作为重构工程师，执行xxx重构 → 重构后代码（Green → Green）
```

## 从 Git 仓库手动安装

```bash
git clone https://gitee.com/nodeing/mr-tdd-skills.git
cd mr-tdd-skills

# Linux / macOS: 安装全局命令
./install-cli.sh

# Windows PowerShell: 安装全局命令
powershell -ExecutionPolicy Bypass -File .\install-cli.ps1

# 在目标项目中安装 skills
mrtdd install --target /path/to/project
```

## 目录结构

```
mr-tdd-skills/
├── skills/
│   ├── mr-tdd-core.md
│   ├── mr-tdd-architect.md
│   ├── mr-tdd-tester.md
│   ├── mr-tdd-developer.md
│   ├── mr-tdd-auditor.md
│   ├── mr-tdd-refactor-planner.md
│   └── mr-tdd-refactor.md
├── mrtdd
├── mrtdd.ps1
├── mrtdd.cmd
├── install-cli.sh
├── install-cli.ps1
├── install.sh
├── install.ps1
└── README.md
```

## License

MIT