创建实施计划

主要指令

你的目标是为 ${input:PlanPurpose} 创建一个新的实施计划文件。你的输出必须是机器可读、确定性的，并结构化以便其他 AI 系统或人类自主执行。

执行上下文

此提示专为 AI 到 AI 通信和自动化处理设计。所有指令必须按字面解释并系统执行，无需人工解释或澄清。

核心要求

生成 AI 代理或人类可完全执行的实施计划
使用确定性语言，零歧义
所有内容结构化为自动解析和执行
确保完全自包含，无外部依赖理解

计划结构要求

计划必须由包含可执行任务的离散、原子阶段组成。每个阶段必须可由 AI 代理或人类独立处理，除非明确声明，否则无跨阶段依赖。

阶段架构

每个阶段必须有可衡量的完成标准
除非指定依赖，阶段内的任务必须可并行执行
所有任务描述必须包含具体文件路径、函数名称和精确实现细节
不应有需要人工解释或决策的任务

AI 优化实施标准

使用明确、无歧义的语言，无需解释
所有内容结构化为机器可解析格式（表格、列表、结构化数据）
包含具体文件路径、行号和精确代码引用（如适用）
明确定义所有变量、常量和配置值
在每个任务描述中提供完整上下文
对所有标识符使用标准化前缀（REQ-、TASK- 等）
包含可自动验证的验证标准

输出文件规范

将实施计划文件保存在 /plan/ 目录下
使用命名约定：[purpose]-[component]-[version].md
目的前缀：upgrade|refactor|feature|data|infrastructure|process|architecture|design
示例：upgrade-system-command-4.md、feature-auth-module-1.md
文件必须是有效的 Markdown，并具有正确的前言结构

强制模板结构

所有实施计划必须严格遵循以下模板。每个部分都是必需的，并且必须填充具体、可操作的内容。AI 代理必须在执行前验证模板合规性。

模板验证规则

所有前言字段必须存在且格式正确
所有节标题必须完全匹配（区分大小写）
所有标识符前缀必须遵循指定格式
表格必须包含所有必需列
最终输出中不得保留占位符文本
标识符必须唯一声明。 每个标识符（REQ-NNN、SEC-NNN、CON-NNN、GUD-NNN、PAT-NNN、GOAL-NNN、TASK-NNN、ALT-NNN、DEP-NNN、FILE-NNN、TEST-NNN、RISK-NNN、ASSUMPTION-NNN）必须恰好声明一次。声明是指标识符引入一行的位置：TASK/GOAL 表格行中的首单元格，或项目符号行中的加粗前缀，如 - **REQ-001**: ...。同一标识符随后可在计划的其他位置作为引用出现任意次数（TASK 正文引用 REQ、一个 TASK 引用另一个 TASK、依赖部分指向已在上游声明的 DEP 等）。引用是预期的，不是冲突。

标识符唯一性检查

在最终确定计划前运行这些检查。检查 (1) 和 (2) 针对声明，必须返回零行。检查 (3) 是广泛的信息扫描：它也会显示有效引用，因此仅用于了解，不作为门禁。

# 设置 PLAN_FILE 为正在验证的计划。
PLAN_FILE="/plan/<purpose>-<component>-<version>.md"

# 1) 表格行中重复的 TASK / GOAL 声明。
grep -oE '\| (TASK|GOAL)-[0-9]+ \|' "$PLAN_FILE" \
  | sed -E 's/.*((TASK|GOAL)-[0-9]+).*/\1/' \
  | sort | uniq -d

# 2) 项目符号样式规范行中重复的声明 ID。
grep -oE '^- \*\*(REQ|SEC|CON|GUD|RISK|ASSUMPTION|TASK|GOAL|FILE|TEST|PAT|ALT|DEP)-[0-9]+\*\*:' "$PLAN_FILE" \
  | sed -E 's/^- \*\*([A-Z]+-[0-9]+)\*\*:.*/\1/' \
  | sort | uniq -d

# 3) 广泛重复扫描（仅诊断；可能包含有效引用）。
grep -oE '(REQ|SEC|CON|GUD|RISK|ASSUMPTION|TASK|GOAL|FILE|TEST|PAT|ALT|DEP)-[0-9]+' "$PLAN_FILE" \
  | sort | uniq -d

先决条件：兼容 POSIX 的 shell（sh / bash），带有 grep、sed、sort 和 uniq。在 Windows 上如果没有这些工具，请使用等效的平台原生命令，并保留相同的声明与引用逻辑。

如果检查 (1) 或 (2) 返回任何行，请重新编号重复项，使每个标识符恰好声明一次，然后重新运行检查，直到两者都为空。

状态

实施计划的状态必须在前言中明确定义，并反映计划的当前状态。状态可以是以下之一（状态颜色在括号中）：Completed（亮绿色徽章）、In progress（黄色徽章）、Planned（蓝色徽章）、Deprecated（红色徽章）或 On Hold（橙色徽章）。它还应作为徽章显示在介绍部分。

---
goal: [描述包实施计划目标的简洁标题]
version: [可选：例如 1.0、日期]
date_created: [YYYY-MM-DD]
last_updated: [可选：YYYY-MM-DD]
owner: [可选：负责此规范的团队/个人]
status: 'Completed'|'In progress'|'Planned'|'Deprecated'|'On Hold'
tags: [可选：相关标签或类别列表，例如 `feature`、`upgrade`、`chore`、`architecture`、`migration`、`bug` 等]
---

# 介绍

![状态: <status>](https://img.shields.io/badge/status-<status>-<status_color>)

[对计划及其要实现的目标的简短介绍。]

## 1. 需求与约束

[明确列出所有影响计划并约束其实现方式的需求和约束。使用项目符号或表格以清晰呈现。]

- **REQ-001**: 需求 1
- **SEC-001**: 安全需求 1
- **[3 字母]-001**: 其他需求 1
- **CON-001**: 约束 1
- **GUD-001**: 指南 1
- **PAT-001**: 要遵循的模式 1

## 2. 实施步骤

### 实施阶段 1

- GOAL-001: [描述此阶段的目标，例如“实现功能 X”、“重构模块 Y”等]

| 任务 | 描述 | 完成 | 日期 |
|------|------|------|------|
| TASK-001 | 任务 1 的描述 | ✅ | 2025-04-25 |
| TASK-002 | 任务 2 的描述 | |  |
| TASK-003 | 任务 3 的描述 | |  |

### 实施阶段 2

- GOAL-002: [描述此阶段的目标，例如“实现功能 X”、“重构模块 Y”等]

| 任务 | 描述 | 完成 | 日期 |
|------|------|------|------|
| TASK-004 | 任务 4 的描述 | |  |
| TASK-005 | 任务 5 的描述 | |  |
| TASK-006 | 任务 6 的描述 | |  |

## 3. 备选方案

[考虑过的任何备选方法及其未被选中的原因的项目符号列表。这有助于为所选方法提供背景和理由。]

- **ALT-001**: 备选方案 1
- **ALT-002**: 备选方案 2

## 4. 依赖项

[列出需要处理的任何依赖项，例如计划所依赖的库、框架或其他组件。]

- **DEP-001**: 依赖项 1
- **DEP-002**: 依赖项 2

## 5. 文件

[列出受功能或重构任务影响的文件。]

- **FILE-001**: 文件 1 的描述
- **FILE-002**: 文件 2 的描述

## 6. 测试

[列出需要实施以验证功能或重构任务的测试。]

- **TEST-001**: 测试 1 的描述
- **TEST-002**: 测试 2 的描述

## 7. 风险与假设

[列出与计划实施相关的任何风险或假设。]

- **RISK-001**: 风险 1
- **ASSUMPTION-001**: 假设 1

## 8. 相关规范 / 延伸阅读

[链接到相关规范 1]
[链接到相关外部文档]

create-implementation-plan

相关 Skills

创建实施计划

主要指令

执行上下文

核心要求

计划结构要求

阶段架构

AI 优化实施标准

输出文件规范

强制模板结构

模板验证规则

标识符唯一性检查

状态

你可能还喜欢

architecture-patterns

camsnap

dogfood

继续探索