SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场create-implementation-plan

create-implementation-plan

编程与开发

查看项目

更新于 10-15 12:25

技能介绍

用途

create-implementation-plan 用于创建新的实施计划文件，覆盖新功能开发、现有代码重构、依赖包升级，以及设计、架构或基础设施变更等场景。其核心目标是生成机器可读、确定性强、结构化的计划，供其他 AI 系统或人类自主执行。该提示词面向 AI 到 AI 的通信与自动化处理，所有指令需按字面解释并系统化执行，不依赖人工解读或澄清。

主要能力

  • 生成可由 AI 智能体或人类完全执行的实施计划。
  • 使用零歧义的确定性语言。
  • 将全部内容组织为可自动解析和执行的格式。
  • 保证计划自包含，理解时不依赖外部信息。
  • 计划由离散的原子阶段组成，每个阶段包含可执行任务；除非显式声明，各阶段可独立处理，无跨阶段依赖。
  • 每个阶段具有可衡量的完成标准；阶段内任务除非指定依赖，否则可并行执行。
  • 任务描述包含具体文件路径、函数名和精确实现细节，无需人工判断或决策。
  • 使用显式无歧义语言，内容采用表格、列表、结构化数据等机器可解析格式。
  • 在适用处包含具体文件路径、行号和精确代码引用。
  • 显式定义所有变量、常量和配置值。
  • 每个任务描述提供完整上下文。
  • 所有标识符使用标准化前缀（如 REQ-、TASK- 等）。
  • 包含可自动验证的校验标准。

使用方式

计划文件保存在 /plan/ 目录，命名约定为 [purpose]-[component]-[version].md。purpose 前缀可选：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、Dependencies 章节指向已在上游声明的 DEP 等）。引用是预期行为，不算冲突。

定稿前需运行标识符唯一性检查。检查 (1) 和 (2) 针对声明，必须返回零行；检查 (3) 为宽泛信息性扫描，会同时暴露合法引用，仅用于了解情况而非作为门槛。

# Set PLAN_FILE to the plan being validated.
PLAN_FILE="/plan/<purpose>-<component>-<version>.md"

# 1) Duplicate TASK / GOAL declarations in table rows.
grep -oE '\| (TASK|GOAL)-[0-9]+ \|' "$PLAN_FILE" \
  | sed -E 's/.*((TASK|GOAL)-[0-9]+).*/\1/' \
  | sort | uniq -d

# 2) Duplicate declaration IDs in bullet-style spec lines.
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) Broad duplicate scan (diagnostic only; may include valid references).
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（可选）、owner（可选，负责该规范的团队/个人）、status（Completed | In progress | Planned | Deprecated | On Hold）、tags（可选，相关标签或类别，如 feature、upgrade、chore、architecture、migration、bug 等）。

正文包含以下章节：

  1. Introduction：状态徽章与简短引言，说明计划及其目标。
  2. Requirements & Constraints：显式列出影响计划及其实施方式的所有需求与约束，使用要点或表格。标识符示例包括 REQ-001、SEC-001、[3 LETTERS]-001、CON-001、GUD-001、PAT-001。
  3. Implementation Steps：按阶段组织。每个阶段以 GOAL-NNN 描述目标，并用表格列出任务，表格列为 Task、Description、Completed、Date。
  4. Alternatives：列出考虑过的替代方案及未选用的原因，标识符如 ALT-001。
  5. Dependencies：列出计划依赖的库、框架或其他组件，标识符如 DEP-001。
  6. Files：列出受功能或重构任务影响的文件，标识符如 FILE-001。
  7. Testing：列出为验证功能或重构任务需实现的测试，标识符如 TEST-001。
  8. Risks & Assumptions：列出与计划实施相关的风险或假设，标识符如 RISK-001、ASSUMPTION-001。
  9. Related Specifications / Further Reading：相关规范或外部文档链接。

适用场景

适用于需要为软件工程变更生成可自动执行、可解析、可验证计划的场景，包括新功能、重构、包升级、设计、架构与基础设施变更。特别适合 AI 到 AI 的自动化处理流程。

限制

该技能要求输出严格遵循模板，不得残留占位文本，标识符必须唯一声明。计划需自包含，不依赖外部信息即可理解。所有指令按字面解释，不进行人工澄清。关于收费、价格、平台支持范围等具体信息，资料中暂未提供。