Claude Skill

pdlc-db-migrate

数据库迁移管理

LLM Mart · 0 points · 0 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download kanfu-panda-pdlc-skills-skills_pdlc-db-migrate-3cd2f02.zip · 6 KB
kanfu-panda/pdlc-skills 15 2 forks MIT Updated 21h ago
Part of kanfu-panda/pdlc-skills — 36 skills

Install

skills CLI npx skills add https://github.com/kanfu-panda/pdlc-skills/tree/main/skills/pdlc-db-migrate
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install kanfu-panda-pdlc-skills@llmmart
Git git clone https://github.com/kanfu-panda/pdlc-skills.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole kanfu-panda/pdlc-skills collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

数据库迁移管理

⛔ IRON LAW · 不可违反的硬门禁

以下规则为不可协商的执行约束：

  1. 文件必须落盘：所有带编号（功能ID / 缺陷ID）的文档，必须作为实际文件写入磁盘，不可仅在对话中输出。
  2. 阶段必须落章：每个阶段完成后必须在状态机 docs/.pdlc-state/<feature-id>.json 追加 history，不可跳过。
  3. 测试必须存在：进入 /pdlc-implement 前，对应测试必须存在且处于红灯状态。违反则中止。
  4. 自检必须执行：段二自检为强制步骤，不得以"已经很好了"为由跳过。
  5. 防循环：段三修复为单次，不递归。无法自动修复的问题记录到报告，继续往下走。
  6. 状态必推进：成功执行某 phase 后 current_stage 必须变更。收尾时若发现 current_stage 未推进，视为失败并报错，不得静默返回（防止外层循环拿滞后的状态空转烧额度）。唯一例外：命中人工点主动 block 时，current_stage 保持不变但必须写 last_phase_result.ok=false + blocked_reason。

违反任一条 = 立即中止当前命令，输出违规详情，等待人工介入。

根据 db-design 文档管理数据库迁移脚本，支持生成、执行、回滚和状态查看。

子命令解析

从本命令的参数中解析子命令和选项：

子命令 格式 说明
generate <描述> 根据 db-design 文档生成版本化迁移脚本（up + down）
status 查看迁移状态，列出已执行/待执行的迁移
up 执行所有待执行的迁移
down [N] 回滚最近 N 个迁移（默认 1）
diff <功能名> 对比 db-design 文档与现有迁移脚本，生成增量迁移

如果未提供子命令或子命令无法识别，输出以上帮助信息后停止。

PDLC 前置检查（仅 generate 和 diff 子命令）

当子命令为 generate 或 diff 时执行：

  1. 从用户输入中提取功能名称关键词
  2. 在 docs/02_design/database/ 目录下搜索包含该关键词的数据库设计文档
    • 匹配新格式：F<日期>-<编号>-*<关键词>*-db.md
    • 匹配旧格式：YYYYMMDD-*<关键词>*-db.md
    • 同时检查文件内容中是否包含该关键词
  3. 未找到 → 输出以下信息后立即停止，不继续执行： 
    ⛔ PDLC 守卫：未找到与「<功能名>」相关的数据库设计文档。
迁移脚本必须基于已有的数据库设计。请先运行：
👉 /pdlc-db-design <设计目标>
  4. 找到 → 提取功能ID（如 F20260326-090000），读取该设计文档内容，继续执行

迁移文件约定

目录结构

  • 微服务项目：backend/services/<service>/migrations/
  • 单服务项目：migrations/
  • 自动检测：如果存在 backend/services/ 目录，按微服务项目处理；否则按单服务项目处理

文件命名

  • UP 脚本：V<版本号>__<描述>.sql
  • DOWN 脚本（回滚）：R<版本号>__<描述>.sql
  • 版本号格式：YYYYMMDD_HHMMSS（如 20260402_143052）

文件头部注释

每个迁移文件必须包含以下头部注释：

-- ==============================================
-- 迁移脚本: V20260402_143052__create_users_table.sql
-- 功能ID: F20260402-090000
-- 描述: 创建用户表
-- 作者: <从 git config 获取>
-- 日期: 2026-04-02
-- ==============================================

子命令执行流程

generate <描述>

  1. 执行前置检查，读取 db-design 文档
  2. 读取 本 skill 目录下的 assets/db-migrate-template.md 模板
  3. 生成版本号：使用当前时间戳 YYYYMMDD_HHMMSS
  4. 从 db-design 文档中提取 DDL 脚本和回滚脚本
  5. 生成 UP 迁移文件：V<版本号>__<描述>.sql
    • 包含头部注释
    • 包含 CREATE TABLE / ALTER TABLE / INSERT 等语句
    • 每条语句末尾添加分号
  6. 生成 DOWN 迁移文件：R<版本号>__<描述>.sql
    • 包含头部注释
    • 包含对应的回滚操作（DROP TABLE / ALTER TABLE DROP COLUMN 等）
    • 操作顺序与 UP 相反
  7. 更新迁移历史记录文件 migrations/migration_history.md
  8. 输出生成结果摘要

status

  1. 查找迁移目录下所有 V*.sql 文件

  2. 读取 migrations/migration_history.md（如不存在则提示无迁移记录）

  3. 输出迁移状态表格：

    📋 迁移状态

| 版本号 | 描述 | 功能ID | 状态 | 执行时间 |
|--------|------|--------|------|----------|
| 20260402_143052 | 创建用户表 | F20260402-090000 | ✅ 已执行 | 2026-04-02 14:35 |
| 20260402_150000 | 添加订单表 | F20260402-100000 | ⏳ 待执行 | - |

已执行: 1 | 待执行: 1 | 总计: 2

up

  1. 读取 migrations/migration_history.md 确定已执行的迁移
  2. 扫描迁移目录，找出所有待执行的 V*.sql 文件
  3. 按版本号升序排列
  4. 逐个输出待执行的 SQL 内容，并提示用户确认
  5. 用户确认后，更新 migrations/migration_history.md 中的状态为「已执行」
  6. 输出执行结果摘要

注意：本命令不直接连接数据库执行 SQL。它展示待执行的脚本内容，由用户在数据库客户端中手动执行，然后更新迁移历史记录。

down [N]

  1. 读取 migrations/migration_history.md 确定已执行的迁移
  2. 取最近 N 个已执行的迁移（默认 N=1）
  3. 按版本号降序排列
  4. 找到对应的 R*.sql 回滚文件
  5. 逐个输出回滚 SQL 内容，并提示用户确认
  6. 用户确认后，更新 migrations/migration_history.md 中的状态为「已回滚」
  7. 输出回滚结果摘要

注意：与 up 相同，本命令不直接执行 SQL，由用户手动执行后更新记录。

diff <功能名>

  1. 执行前置检查，读取 db-design 文档
  2. 扫描迁移目录下已有的 V*.sql 文件，提取已定义的表结构
  3. 对比 db-design 文档中的表结构与已有迁移脚本
  4. 识别差异：
    • 新增的表 → 生成 CREATE TABLE
    • 新增的字段 → 生成 ALTER TABLE ADD COLUMN
    • 修改的字段 → 生成 ALTER TABLE MODIFY COLUMN
    • 新增的索引 → 生成 CREATE INDEX
    • 删除的索引 → 生成 DROP INDEX
  5. 生成增量迁移的 UP 和 DOWN 文件
  6. 更新迁移历史记录
  7. 输出差异摘要

迁移历史记录

在迁移目录下维护 migration_history.md 文件：

# 迁移历史

| 版本号 | 描述 | 功能ID | 执行时间 | 状态 |
|--------|------|--------|----------|------|
| 20260402_143052 | 创建用户表 | F20260402-090000 | 2026-04-02 14:35 | 已执行 |
| 20260402_150000 | 添加订单表 | F20260402-100000 | - | 待执行 |

状态值：待执行 | 已执行 | 已回滚

要求

🌐 Output language for generated artifacts

All generated artifacts (PRDs, design docs, code comments, review reports, test plans, deployment manuals, changelog entries, etc.) follow this policy:

  1. Default — match the conversation language exactly:

    • 用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告
    • User talks to Claude in English → produce English artifacts
    • User talks in another language → produce artifacts in that language
    • Never silently default to a fixed language regardless of the user's input.

  2. Explicit override always wins: when the user specifies a language for an artifact (e.g. "write the PRD in English", "用英文写 API 设计文档", "output the deploy doc in Japanese"), use that language for that artifact, regardless of conversation language.

  3. Mixed-language requirements: if the user wants some artifacts in one language and others in a different language (common: Chinese PRD + English API docs for partners), honour each per-artifact instruction.

  4. Uncertain: if you cannot reliably detect the conversation language, ask once before producing the first artifact.

This policy applies to content (prose, comments, headings). It does not override technical conventions like English variable names, English git commit subjects, or English error codes when the project's conventions require them.

  • SQL 关键字使用大写（CREATE TABLE、ALTER TABLE 等）
  • 每个迁移文件只包含一个功能的变更，保持原子性
  • 回滚脚本必须能完全撤销对应的 UP 脚本
  • 生成的 SQL 遵循 db-design 文档中的字段命名和类型约定
  • 版本号严格递增，不允许插入历史版本

迁移操作: $ARGUMENTS

段四：交接（Handoff）

命令完成后必须输出以下格式的最终消息：

✅ <阶段名> 完成：<主要产出物路径>
📊 自检：<通过数>/<总数> 通过（若有未通过，附要点）
📦 状态快照：docs/.pdlc-state/<feature-id>.json
👉 下一步：/pdlc-<next_step>
   （如果有分叉）或 /pdlc-<alt>（条件：<选择依据>）

规则：

  • 主流程命令（写状态机的命令；下一跳见正文里「本命令的状态机取值」）必须显式输出"下一步"，不可省略
  • 工具型命令（Layer 3）可以没有 next_step，此时输出 👉 下一步：（本次流程结束，无后续）
  • 分叉场景必须说明选择条件，例如"若需补充测试用例 → /pdlc-tdd；若测试已齐 → /pdlc-review"

本命令的 handoff 输出：

✅ 数据库迁移脚本 完成
📦 产出：backend/migrations/V<版本号>__<描述>.sql
👉 下一步：（本次流程结束，无后续）
Files (pdlc-skills)
  • assets
    • db-migrate-template.md 3.8 KB 
      # 数据库迁移脚本模板

> 本模板供 `/pdlc-db-migrate` 命令生成迁移文件时参考。

---

## 1. UP 迁移脚本模板

文件名格式：`V<YYYYMMDD_HHMMSS>__<描述>.sql`

```sql
-- ==============================================
-- 迁移脚本: V<版本号>__<描述>.sql
-- 功能ID: <功能ID>
-- 描述: <变更描述>
-- 作者: <作者>
-- 日期: <YYYY-MM-DD>
-- ==============================================

-- ---------- 1. 新建表 ----------

CREATE TABLE <table_name> (
    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键',
    -- 业务字段
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
    created_by VARCHAR(64) DEFAULT NULL COMMENT '创建人',
    updated_by VARCHAR(64) DEFAULT NULL COMMENT '更新人',
    is_deleted TINYINT(1) NOT NULL DEFAULT 0 COMMENT '逻辑删除（0=正常，1=删除）',
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='<表注释>';

-- ---------- 2. 修改表结构 ----------

-- 新增字段
ALTER TABLE <table_name>
    ADD COLUMN <column_name> <type> <nullable> <default> COMMENT '<说明>'
    AFTER <existing_column>;

-- 修改字段
ALTER TABLE <table_name>
    MODIFY COLUMN <column_name> <new_type> <nullable> <default> COMMENT '<说明>';

-- ---------- 3. 索引变更 ----------

-- 新增索引
CREATE INDEX idx_<table>_<column> ON <table_name> (<column_name>);
CREATE UNIQUE INDEX uk_<table>_<column> ON <table_name> (<column_name>);

-- ---------- 4. 数据初始化 ----------

INSERT INTO <table_name> (<columns>) VALUES
    (<values>);
```

---

## 2. DOWN 回滚脚本模板

文件名格式：`R<YYYYMMDD_HHMMSS>__<描述>.sql`

```sql
-- ==============================================
-- 回滚脚本: R<版本号>__<描述>.sql
-- 功能ID: <功能ID>
-- 描述: 回滚 - <变更描述>
-- 作者: <作者>
-- 日期: <YYYY-MM-DD>
-- ==============================================

-- ⚠️ 回滚操作顺序与 UP 脚本相反

-- ---------- 1. 删除初始化数据 ----------

DELETE FROM <table_name> WHERE <condition>;

-- ---------- 2. 删除索引 ----------

DROP INDEX idx_<table>_<column> ON <table_name>;

-- ---------- 3. 撤销表结构变更 ----------

-- 删除新增的字段
ALTER TABLE <table_name>
    DROP COLUMN <column_name>;

-- 恢复修改的字段
ALTER TABLE <table_name>
    MODIFY COLUMN <column_name> <original_type> <original_nullable> <original_default> COMMENT '<原说明>';

-- ---------- 4. 删除新建的表 ----------

DROP TABLE IF EXISTS <table_name>;
```

---

## 3. 迁移历史记录模板

文件名：`migration_history.md`，位于迁移目录下。

```markdown
# 迁移历史

> 本文件由 `/pdlc-db-migrate` 命令自动维护，记录所有迁移脚本的执行状态。

| 版本号 | 描述 | 功能ID | 执行时间 | 状态 |
|--------|------|--------|----------|------|
```

状态值说明：
- `待执行` — 迁移脚本已生成，尚未在数据库中执行
- `已执行` — 迁移脚本已在数据库中执行
- `已回滚` — 迁移已被回滚撤销

---

## 4. 编写规范

### 4.1 命名规范

- 版本号使用时间戳格式：`YYYYMMDD_HHMMSS`
- 描述使用 snake_case 英文：`create_users_table`、`add_email_to_users`
- 一个迁移文件只包含一个原子变更

### 4.2 SQL 规范

- SQL 关键字统一大写：`CREATE TABLE`、`ALTER TABLE`、`DROP TABLE`
- 字段名使用 snake_case 小写
- 每条语句以分号结尾
- 重要操作前添加中文注释说明
- 字段必须添加 COMMENT 注释

### 4.3 回滚规范

- 每个 UP 脚本必须有对应的 DOWN 脚本
- DOWN 脚本的操作顺序与 UP 脚本相反
- DROP TABLE 使用 `IF EXISTS` 防御性写法
- 数据删除操作需要精确的 WHERE 条件，避免误删
  • SKILL.md 10.1 KB 
    ---
name: pdlc-db-migrate
description: 数据库迁移管理
argument-hint: <迁移描述 | 版本号>
allowed-tools: Read, Write, Edit, Glob, Grep, Bash
layer: 3
stage: engineering
produces:
  - backend/migrations/**
requires: []
next_step: null
terminal_state: null
---

# 数据库迁移管理

<!-- @include templates/prompts/iron-law.md（已内联于下方，无需另读） -->
⛔ **IRON LAW · 不可违反的硬门禁**

以下规则为**不可协商**的执行约束：

1. **文件必须落盘**：所有带编号（功能ID / 缺陷ID）的文档，必须作为实际文件写入磁盘，不可仅在对话中输出。
2. **阶段必须落章**：每个阶段完成后必须在状态机 `docs/.pdlc-state/<feature-id>.json` 追加 history，不可跳过。
3. **测试必须存在**：进入 `/pdlc-implement` 前，对应测试必须存在且处于红灯状态。违反则中止。
4. **自检必须执行**：段二自检为强制步骤，不得以"已经很好了"为由跳过。
5. **防循环**：段三修复为单次，不递归。无法自动修复的问题记录到报告，继续往下走。
6. **状态必推进**：成功执行某 phase 后 `current_stage` 必须变更。收尾时若发现 `current_stage` 未推进，视为失败并报错，**不得静默返回**（防止外层循环拿滞后的状态空转烧额度）。唯一例外：命中人工点主动 block 时，`current_stage` 保持不变但必须写 `last_phase_result.ok=false` + `blocked_reason`。

**违反任一条 = 立即中止当前命令，输出违规详情，等待人工介入。**
<!-- @include-end templates/prompts/iron-law.md -->

根据 db-design 文档管理数据库迁移脚本，支持生成、执行、回滚和状态查看。

## 子命令解析

从本命令的参数中解析子命令和选项：

| 子命令 | 格式 | 说明 |
|--------|------|------|
| `generate <描述>` | 根据 db-design 文档生成版本化迁移脚本（up + down） |
| `status` | 查看迁移状态，列出已执行/待执行的迁移 |
| `up` | 执行所有待执行的迁移 |
| `down [N]` | 回滚最近 N 个迁移（默认 1） |
| `diff <功能名>` | 对比 db-design 文档与现有迁移脚本，生成增量迁移 |

如果未提供子命令或子命令无法识别，输出以上帮助信息后停止。

---

## PDLC 前置检查（仅 generate 和 diff 子命令）

当子命令为 `generate` 或 `diff` 时执行：

1. 从用户输入中提取功能名称关键词
2. 在 `docs/02_design/database/` 目录下搜索包含该关键词的数据库设计文档
   - 匹配新格式：`F<日期>-<编号>-*<关键词>*-db.md`
   - 匹配旧格式：`YYYYMMDD-*<关键词>*-db.md`
   - 同时检查文件内容中是否包含该关键词
3. **未找到** → 输出以下信息后**立即停止，不继续执行**：
   ```
   ⛔ PDLC 守卫：未找到与「<功能名>」相关的数据库设计文档。
   迁移脚本必须基于已有的数据库设计。请先运行：
   👉 /pdlc-db-design <设计目标>
   ```
4. **找到** → 提取功能ID（如 `F20260326-090000`），读取该设计文档内容，继续执行

---

## 迁移文件约定

### 目录结构

- 微服务项目：`backend/services/<service>/migrations/`
- 单服务项目：`migrations/`
- 自动检测：如果存在 `backend/services/` 目录，按微服务项目处理；否则按单服务项目处理

### 文件命名

- UP 脚本：`V<版本号>__<描述>.sql`
- DOWN 脚本（回滚）：`R<版本号>__<描述>.sql`
- 版本号格式：`YYYYMMDD_HHMMSS`（如 `20260402_143052`）

### 文件头部注释

每个迁移文件必须包含以下头部注释：

```sql
-- ==============================================
-- 迁移脚本: V20260402_143052__create_users_table.sql
-- 功能ID: F20260402-090000
-- 描述: 创建用户表
-- 作者: <从 git config 获取>
-- 日期: 2026-04-02
-- ==============================================
```

---

## 子命令执行流程

### generate <描述>

1. 执行前置检查，读取 db-design 文档
2. 读取 本 skill 目录下的 `assets/db-migrate-template.md` 模板
3. 生成版本号：使用当前时间戳 `YYYYMMDD_HHMMSS`
4. 从 db-design 文档中提取 DDL 脚本和回滚脚本
5. 生成 UP 迁移文件：`V<版本号>__<描述>.sql`
   - 包含头部注释
   - 包含 CREATE TABLE / ALTER TABLE / INSERT 等语句
   - 每条语句末尾添加分号
6. 生成 DOWN 迁移文件：`R<版本号>__<描述>.sql`
   - 包含头部注释
   - 包含对应的回滚操作（DROP TABLE / ALTER TABLE DROP COLUMN 等）
   - 操作顺序与 UP 相反
7. 更新迁移历史记录文件 `migrations/migration_history.md`
8. 输出生成结果摘要

### status

1. 查找迁移目录下所有 `V*.sql` 文件
2. 读取 `migrations/migration_history.md`（如不存在则提示无迁移记录）
3. 输出迁移状态表格：

   ```
   📋 迁移状态

   | 版本号 | 描述 | 功能ID | 状态 | 执行时间 |
   |--------|------|--------|------|----------|
   | 20260402_143052 | 创建用户表 | F20260402-090000 | ✅ 已执行 | 2026-04-02 14:35 |
   | 20260402_150000 | 添加订单表 | F20260402-100000 | ⏳ 待执行 | - |

   已执行: 1 | 待执行: 1 | 总计: 2
   ```

### up

1. 读取 `migrations/migration_history.md` 确定已执行的迁移
2. 扫描迁移目录，找出所有待执行的 `V*.sql` 文件
3. 按版本号升序排列
4. 逐个输出待执行的 SQL 内容，并提示用户确认
5. 用户确认后，更新 `migrations/migration_history.md` 中的状态为「已执行」
6. 输出执行结果摘要

> **注意**：本命令不直接连接数据库执行 SQL。它展示待执行的脚本内容，由用户在数据库客户端中手动执行，然后更新迁移历史记录。

### down [N]

1. 读取 `migrations/migration_history.md` 确定已执行的迁移
2. 取最近 N 个已执行的迁移（默认 N=1）
3. 按版本号降序排列
4. 找到对应的 `R*.sql` 回滚文件
5. 逐个输出回滚 SQL 内容，并提示用户确认
6. 用户确认后，更新 `migrations/migration_history.md` 中的状态为「已回滚」
7. 输出回滚结果摘要

> **注意**：与 `up` 相同，本命令不直接执行 SQL，由用户手动执行后更新记录。

### diff <功能名>

1. 执行前置检查，读取 db-design 文档
2. 扫描迁移目录下已有的 `V*.sql` 文件，提取已定义的表结构
3. 对比 db-design 文档中的表结构与已有迁移脚本
4. 识别差异：
   - 新增的表 → 生成 CREATE TABLE
   - 新增的字段 → 生成 ALTER TABLE ADD COLUMN
   - 修改的字段 → 生成 ALTER TABLE MODIFY COLUMN
   - 新增的索引 → 生成 CREATE INDEX
   - 删除的索引 → 生成 DROP INDEX
5. 生成增量迁移的 UP 和 DOWN 文件
6. 更新迁移历史记录
7. 输出差异摘要

---

## 迁移历史记录

在迁移目录下维护 `migration_history.md` 文件：

```markdown
# 迁移历史

| 版本号 | 描述 | 功能ID | 执行时间 | 状态 |
|--------|------|--------|----------|------|
| 20260402_143052 | 创建用户表 | F20260402-090000 | 2026-04-02 14:35 | 已执行 |
| 20260402_150000 | 添加订单表 | F20260402-100000 | - | 待执行 |
```

状态值：`待执行` | `已执行` | `已回滚`

---

## 要求

<!-- @include templates/prompts/output-language.md（已内联于下方，无需另读） -->
🌐 **Output language for generated artifacts**

All generated artifacts (PRDs, design docs, code comments, review reports,
test plans, deployment manuals, changelog entries, etc.) follow this policy:

1. **Default — match the conversation language exactly**:
   - 用户用中文与 Claude 对话 → 产中文文档、中文代码注释、中文报告
   - User talks to Claude in English → produce English artifacts
   - User talks in another language → produce artifacts in that language
   - **Never silently default to a fixed language regardless of the user's input.**

2. **Explicit override always wins**: when the user specifies a language for
   an artifact (e.g. "write the PRD in English", "用英文写 API 设计文档",
   "output the deploy doc in Japanese"), use that language for that artifact,
   regardless of conversation language.

3. **Mixed-language requirements**: if the user wants some artifacts in one
   language and others in a different language (common: Chinese PRD + English
   API docs for partners), honour each per-artifact instruction.

4. **Uncertain**: if you cannot reliably detect the conversation language,
   ask once before producing the first artifact.

This policy applies to **content** (prose, comments, headings). It does
**not** override technical conventions like English variable names, English
git commit subjects, or English error codes when the project's conventions
require them.
<!-- @include-end templates/prompts/output-language.md -->
- SQL 关键字使用大写（CREATE TABLE、ALTER TABLE 等）
- 每个迁移文件只包含一个功能的变更，保持原子性
- 回滚脚本必须能完全撤销对应的 UP 脚本
- 生成的 SQL 遵循 db-design 文档中的字段命名和类型约定
- 版本号严格递增，不允许插入历史版本

迁移操作: $ARGUMENTS

<!-- @include templates/prompts/handoff.md（已内联于下方，无需另读） -->
## 段四：交接（Handoff）

命令完成后必须输出以下格式的最终消息：

```
✅ <阶段名> 完成：<主要产出物路径>
📊 自检：<通过数>/<总数> 通过（若有未通过，附要点）
📦 状态快照：docs/.pdlc-state/<feature-id>.json
👉 下一步：/pdlc-<next_step>
   （如果有分叉）或 /pdlc-<alt>（条件：<选择依据>）
```

**规则：**
- 主流程命令（写状态机的命令；下一跳见正文里「本命令的状态机取值」）必须显式输出"下一步"，不可省略
- 工具型命令（Layer 3）可以没有 `next_step`，此时输出 `👉 下一步：（本次流程结束，无后续）`
- 分叉场景必须说明**选择条件**，例如"若需补充测试用例 → `/pdlc-tdd`；若测试已齐 → `/pdlc-review`"
<!-- @include-end templates/prompts/handoff.md -->

**本命令的 handoff 输出：**

```
✅ 数据库迁移脚本 完成
📦 产出：backend/migrations/V<版本号>__<描述>.sql
👉 下一步：（本次流程结束，无后续）
```

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related

Claude Prompt
Tighten-my-prose editing prompt
Claude Skill
Adversarial code-review skill for Claude
Claude Workflow
Deep-research workflow (fan-out + verify)
Claude Skill
Conventional-commit writer for Claude