# Pace Init

> Use when user says "初始化", "pace-init", "开始追踪", "初始化研发管理", "新项目", "项目管理", "set up devpace", "健康检查 devpace", "重置 devpace", "预览初始化", or wants to set up, verify, or reset project development tracking. NOT for current progress overview (use /pace-status) or starting development (use /pace-dev).

- **Type:** Skill
- **Install:** `agentstack add skill-arch-team-devpace-pace-init`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [arch-team](https://agentstack.voostack.com/s/arch-team)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [arch-team](https://github.com/arch-team)
- **Source:** https://github.com/arch-team/devpace/tree/main/skills/pace-init

## Install

```sh
agentstack add skill-arch-team-devpace-pace-init
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# /pace-init — 初始化项目开发节奏管理

从模板初始化当前项目的 `.devpace/` 目录。默认执行最小初始化（自动检测项目生命周期阶段，按阶段适配行为），`full` 执行分阶段完整流程（含愿景、战略上下文、OBJ 产品维度引导），`--from` 从文档自动生成功能树（支持 Epic 解析）。支持 `--verify`（健康检查）、`--reset`（重置）、`--dry-run`（预览）等子命令。

## 输入

$ARGUMENTS：可选。格式：

- `[项目名称]` — 最小初始化（默认，生命周期感知）
- `[项目名称] full` — 分阶段完整流程
- `[项目名称] --from ...` — 从文档生成功能树（支持目录和多文件）
- `--verify [--fix]` — 健康检查（可选自动修复）
- `--dry-run` — 预览初始化结果，不写入文件
- `--reset [--keep-insights]` — 重置 .devpace/
- `--export-template` — 导出当前配置为可复用模板
- `--from-template ` — 从模板初始化
- `--import-insights ` — 导入跨项目经验
- `--interactive` — 强制对话模式（覆盖自动检测行为）

## 流程

### Step 0：前置检查与路由

**子命令路由**（优先级高于初始化流程）：

- `--verify` → 健康检查流程
- `--reset` → 重置流程
- `--export-template` / `--from-template` → 模板管理流程

**标志处理**：

- `--dry-run` → 设置 dry-run 标志，继续正常流程但不写入任何文件

**版本与状态检测**：检查 `.devpace/state.md` 存在性和版本标记，决定全新初始化、增量迁移或提示重置（规则见 `skills/pace-init/init-procedures-migration.md`）。

### Step 1-4：初始化执行

根据参数读取对应规程文件执行（仅读取匹配路径的规程文件）：

| 参数 | 执行规程 |
|------|---------|
| （默认）`[项目名]` | `skills/pace-init/init-procedures-core.md` |
| `full` | `skills/pace-init/init-procedures-core.md` + `skills/pace-init/init-procedures-full.md` |
| `--from ...` | `skills/pace-init/init-procedures-core.md` + `skills/pace-init/init-procedures-from.md` |
| `--import-insights ` | `skills/pace-init/init-procedures-from.md`（可与初始化组合或独立使用） |
| `--verify [--fix]` | `skills/pace-init/init-procedures-verify.md` |
| `--dry-run` | `skills/pace-init/init-procedures-dryrun.md` + `skills/pace-init/init-procedures-core.md`（仅 §1 检测逻辑，不执行 §2 文件生成） |
| `--reset [--keep-insights]` | `skills/pace-init/init-procedures-reset.md` |
| `--export-template` / `--from-template` | `skills/pace-init/init-procedures-template.md` |
| （迁移触发时） | `skills/pace-init/init-procedures-migration.md` |
| （检测到 monorepo 信号时） | `skills/pace-init/init-procedures-monorepo.md` |

## 输出

初始化完成的 `.devpace/` 目录 + 确认摘要 + 下一步引导。`--dry-run` 时仅输出预览。`--verify` 时输出健康报告。`--reset` 时输出清理确认。

### 下一步引导（仅正常初始化和 `--full` 时）

确认摘要后追加情境化引导（§15 教学标记 `init_complete` 去重）：

| 项目状态 | 引导内容 |
|---------|---------|
| 有源代码（src/ 或主语言文件 >10 个） | "项目已就绪。建议先 `/pace-biz infer` 从代码推断已有功能和技术债务，再开始规划。" |
| 有需求文档（--from 初始化，功能树已生成） | "项目已就绪。功能树已生成，说'帮我做 [功能名]'开始第一个功能，或 `/pace-plan` 规划迭代。" |
| 空项目（无源代码、无需求文档） | "项目已就绪。说'我想做...'开始头脑风暴需求（`/pace-biz discover`），或直接说'帮我做 [功能名]'快速开始。" |
| 通用（其他情况） | "项目已就绪。说'帮我做 [功能名]'开始第一个功能，`/pace-biz` 规划业务需求，或 `/pace-plan` 规划迭代。" |

**检测规则**：使用 skills/pace-init/init-procedures-core.md 的信号检测结果（源文件数、git 信号）判定项目状态，不额外扫描。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [arch-team](https://github.com/arch-team)
- **Source:** [arch-team/devpace](https://github.com/arch-team/devpace)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-arch-team-devpace-pace-init
- Seller: https://agentstack.voostack.com/s/arch-team
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.