# PAC Runner

PAC Runner 是一个配置化、可发布、可扩展的 Prompt-as-Code 多场景执行器。

它把 QClaw、WorkBuddy、Cursor、Claude Code 或其他智能体的任务，统一转换成标准任务，再交给本地 Codex 执行，并通过 CLI、MCP、任务文件和结果文件形成完整闭环。

## 核心能力

- 多场景任务执行：通用、代码、调研、文档、视频制作、交付。
- 标准任务文件：`.pac.md` / `.json`。
- 标准结果文件：`<任务ID>_结果.md`。
- CLI 入口：`pac-runner`。
- MCP 入口：`pac_run`、`pac_list`、`pac_validate`。
- 配置化：支持 `config.json` 和环境变量，不依赖个人路径。
- 可扩展：新增模板、场景和工具无需改核心代码。

## 安装

```bash
npm install
npm link
```

或者直接运行：

```bash
node bin/pac.mjs list
```

## 配置

复制配置模板：

```bash
cp config.example.json config.json
```

常用环境变量：

```bash
export CODEX_EXE="/path/to/codex"
export CODEX_HOME="$HOME/.codex"
export PAC_DEFAULT_CWD="$PWD"
export PAC_DEFAULT_OUTPUT_DIR="$PWD/output"
export PAC_STATE_FILE="$PWD/.pac-runner/state.json"
```

## 快速使用

查看场景：

```bash
pac-runner list
```

直接执行：

```bash
pac-runner run --scenario coding --prompt "整理当前目录的脚本说明" --json
```

用标准任务文件：

```bash
pac-runner run --task examples/video-production.pac.md --json
```

生成模板：

```bash
pac-runner template --scenario video-production --out my-video.pac.md
```

校验任务文件：

```bash
pac-runner validate --task examples/video-production.pac.md --json
```

## MCP 接入

启动 MCP server：

```bash
node src/mcp-relay.mjs
```

通用 MCP 配置：

```json
{
  "mcpServers": {
    "pac-runner": {
      "command": "node",
      "args": ["/absolute/path/to/pac-runner/src/mcp-relay.mjs"]
    }
  }
}
```

MCP 工具：

- `pac_list`：列出场景。
- `pac_run`：执行标准任务。
- `pac_validate`：校验任务文件。

## 场景

| 场景 | 用途 |
| --- | --- |
| `general` | 通用分析、整理、执行 |
| `coding` | 代码、脚本、自动化 |
| `research` | 调研、分析、根因排查 |
| `document` | Markdown、Word、PPT、Excel、PDF |
| `video-production` | 短视频、分镜、渲染 |
| `delivery` | 任务交付与回传 |

## 任务文件

```markdown
---
id: video_task_20260901_1200
scenario: video-production
title: 制作一条15秒短视频
status: ready
priority: normal
owner: pac-runner
cwd: .
outputDir: ./output
inputFiles: []
imagePaths: []
expectedOutputs: ["分镜脚本", "视频文件", "渲染日志"]
timeoutMs: 1200000
---

在这里写具体任务要求。
```

## 结果文件

执行成功后自动生成：

```text
<outputDir>/<任务ID>_结果.md
```

## 安全模式

QClaw 技能包调用 Codex 时使用：

```text
--approve-for-me
```

不绕过审批和沙箱，输出目录通过 `--add-dir` 授权写入。该模式已通过 QClaw 开放平台安全检测。

## 商业化

商业模式、定价和 Pro/Enterprise 边界见：

- [docs/MONETIZATION.md](docs/MONETIZATION.md)
- [docs/COMMERCIAL-PROJECT-PLAN.md](docs/COMMERCIAL-PROJECT-PLAN.md)
- [docs/MARKET-ANALYSIS.md](docs/MARKET-ANALYSIS.md)
- [docs/PRO-FEATURES.md](docs/PRO-FEATURES.md)
- [docs/ROADMAP.md](docs/ROADMAP.md)
- [docs/GITHUB-RELEASE.md](docs/GITHUB-RELEASE.md)
- [docs/QCLAW-SKILL-RELEASE.md](docs/QCLAW-SKILL-RELEASE.md)
- [docs/QCLAW-BETA-STRATEGY.md](docs/QCLAW-BETA-STRATEGY.md)
- [docs/REVIEW-FIX-LOG.md](docs/REVIEW-FIX-LOG.md)

## 测试

```bash
npm test
```