一套面向 Codex 的产品实施规划 skills。它把“判断方案是否值得实施”“将方案拆成任务”“设计真实目标验收”分成清晰阶段，避免错误架构被顺利拆解、实现和测试后，才发现没有解决用户问题。
用户只需要记住一个入口：
$plan-product-implementation
它会在方向验证通过后调用内部的 planning-and-task-breakdown，再收回控制权，为最终计划补齐真实目标验收与停止门禁。
传统实施计划通常从已有 PRD 或方案直接开始拆任务。这种流程擅长回答“怎么做”，但容易跳过更关键的问题：
- 现有系统是否真的需要重写？
- 局部缺陷能否通过兼容扩展解决？
- 新架构会接管什么职责，又能删除什么旧路径？
- 产品文档描述的目标是否对应当前真实入口、API、数据和运行配置？
- 自动化测试通过是否真的代表用户目标已经验证？
- 哪些失败应立即停止扩展并回到产品或架构判断？
本项目通过两个职责互补的 skill 建立完整规划链路。
将 PRD、需求说明或迭代文档转化为有事实基础、可执行、可验收的实施计划，尤其适合架构迁移、Agent/AI 工作流、跨模块状态和大型功能。
在重写、替换框架或引入新领域模型前，验证是否存在真正的不兼容约束，并记录职责迁移、Legacy 处置和回滚边界。
获得边界明确、按依赖排序、优先打通真实薄链路的任务清单，减少在错误方向上持续扩展的风险。
通过目标身份、验收案例、Gate Matrix 和分层交付状态，区分“代码存在”“运行时启用”“真实路径执行”“证据验证”和“完整交付”。
flowchart TD
A["产品文档、仓库规则与当前代码"] --> B["Skill 1：方向准入"]
B -->|"READINESS_BLOCKED"| X["返回缺失证据，不拆任务"]
B -->|"READY"| C["Skill 2：任务拆分"]
C -->|"READINESS_REVIEW_REQUIRED"| B
C -->|"PLAN_TASKS_READY"| D["Skill 1：真实目标验收与停止门"]
D -->|"计划仍不可验收"| C
D -->|"PLAN_READY"| E["实施工作"]
E --> F["Skill 1：按冻结合同验证真实目标"]
F -->|"VERIFICATION_BLOCKED"| Y["保留未验项，不用 fallback 冒充完成"]
F -->|"TARGET_VERIFIED"| G["核对全部核心需求"]
G -->|"全部验证"| H["COMPLETE"]
plan-product-implementation 先读取产品文档、仓库规则、当前代码路径以及相关决策或事故记录，然后：
- 冻结正式目标身份，包括 UI 入口、API、Service、Repository、数据存储、Feature Flags、构建和 Provider。
- 将每项问题分类为
local fix、compatible extension或incompatible constraint。 - 对替换或迁移方案建立“当前职责 → 当前 owner → 新 owner → Legacy 处置”映射。
- 为状态、权限、Agent、多模态或费用流程建立字段级事实流和确定性门禁。
- 定义第一条使用真实入口、真实数据的用户薄链路。
- 提前写出证伪条件和停止动作。
缺少关键证据时返回 READINESS_BLOCKED，不会生成一份貌似完整的实施任务清单。
只有状态为 READY 时，Skill 1 才会调用 planning-and-task-breakdown。Skill 2 负责：
- 建立需求追踪和依赖图；
- 将工作切成可实现、可测试、可回滚的垂直任务；
- 将高风险假设转成前置证据任务；
- 把真实用户薄链路放在大规模基础设施扩展之前；
- 定义任务级自动化验证、文档、Legacy 和提交边界；
- 规划安全的并行工作和集成门禁。
Skill 2 不负责重新解释产品目标或扩展架构。发现交接材料矛盾时，它返回 READINESS_REVIEW_REQUIRED，将控制权交回 Skill 1。
任务拆分完成后，Skill 1 会再次接管流程。它为每条核心用户旅程定义可执行验收案例，包括：
- 目标产品、入口、路由、构建和运行身份；
- 实际 Provider、模型、用户、数据和环境；
- 精确操作步骤与用户可见结果；
- 数据库、Action、Run、Artifact、日志或截图证据；
- 权限、费用和破坏性操作边界；
- 禁止作为替代的 Legacy、Mock、fallback 或邻近能力；
- 失败后的停止动作与恢复位置。
计划只有在任务、真实验收案例和停止 Gate 全部可追踪时，才能进入 PLAN_READY。
实施完成后，可以再次使用同一个 Skill 1 对照 PLAN_READY 计划执行验收。它会重新确认实际构建和目标身份，拒绝使用错误路由或测试 Provider 的结果冒充正式验收。
| Skill | 用户是否需要直接记住 | 主要职责 | 不负责 |
|---|---|---|---|
plan-product-implementation |
是 | 准入判断、调用 Skill 2、验收设计、停止门、实施后验证 | 产品代码实现 |
planning-and-task-breakdown |
通常不需要 | 需求追踪、依赖排序、垂直任务、检查点和回滚边界 | 架构准入和最终完成判断 |
| 状态 | 含义 |
|---|---|
READINESS_BLOCKED |
方向缺少关键证据，不进入任务拆分 |
READY |
方向允许拆分，但完整计划尚未通过后置检查 |
READINESS_REVIEW_REQUIRED |
拆分时发现前置判断矛盾，需要返回准入阶段 |
PLAN_NOT_VERIFIABLE |
已有任务，但核心用户旅程无法形成真实验收 |
PLAN_READY |
准入、任务、验收案例和停止门均已定义 |
VERIFICATION_BLOCKED |
实施存在，但真实验收受权限、费用或环境阻塞 |
TARGET_VERIFIED |
指定构建和真实目标案例已经通过 |
COMPLETE |
所有核心要求均已验证，没有剩余必需工作 |
计划阶段最多只能进入 PLAN_READY，不能声称 TARGET_VERIFIED 或 COMPLETE。
将仓库中的两个目录安装到 Codex skills 目录：
git clone git@github.com:jialezhang/skill.git
mkdir -p ~/.codex/skills/plan-product-implementation
mkdir -p ~/.codex/skills/planning-and-task-breakdown
rsync -a skill/plan-product-implementation/ ~/.codex/skills/plan-product-implementation/
rsync -a skill/planning-and-task-breakdown/ ~/.codex/skills/planning-and-task-breakdown/重新打开 Codex task 后，技能列表中应出现：
plan-product-implementation
planning-and-task-breakdown
$plan-product-implementation
请基于 docs/product/prd/example.md 制定实施计划。
$plan-product-implementation
请基于这份 PRD 制定计划，不修改文件，只在回复中输出完整计划。
此时使用 response-only artifact mode；准入、任务拆分和后置验收阶段仍会完整执行。
$plan-product-implementation
请按照现有 PLAN_READY 实施计划验证当前实现，不要用 Legacy 或 Mock 路径替代正式目标。
仅在工作规模小、风险低，且产品结果、代码路径、修改方向和验收边界都已经明确时使用：
$planning-and-task-breakdown
将这个已经验证的局部修改拆成可实现任务。
架构迁移、新运行时、跨边界状态、Agent 控制流或数据删除不应直接进入 Skill 2。
Skill 1 支持两种模式：
file：按照目标仓库规范保存计划文件；response-only：不写文件，在当前回复中维护同样结构的完整 Markdown 计划。
详细契约见：
.
├── README.md
├── plan-product-implementation/
│ ├── SKILL.md
│ ├── agents/openai.yaml
│ └── references/
│ ├── plan-artifact-template.md
│ └── verification-contract.md
└── planning-and-task-breakdown/
├── SKILL.md
├── agents/openai.yaml
└── references/
└── definition-of-done.md
如果本机存在 Codex 的 skill-creator，可以运行：
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py plan-product-implementation
python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py planning-and-task-breakdown- 清晰需求不等于正确实施方向。
- 局部缺陷不能直接推出整体重写。
- 架构复用必须落到正式入口和实际调用链。
- 第一条真实用户薄链路必须早于全面扩展。
- Prompt 不能独自承担权限、安全、费用、证据或完成门禁。
- 自动化合同测试不能替代真实目标验收。
Implemented、Enabled、Executed、Verified和Complete必须分开。- 错误目标和 fallback 结果只能作为诊断证据。
- 每个停止条件必须包含停止动作和恢复位置。
- 大改动必须提前设计提交、迁移、回滚和 Legacy 删除边界。
- Skill 间调用属于 Codex 工作流级编排，不是程序函数调用。
- 本项目不负责执行产品代码实现；实施应交给合适的执行工作流。
- 真实验收仍受目标环境、权限、费用和外部 Provider 可用性约束。
- 仓库或项目的
AGENTS.md、Definition of Done 和数据保护规则始终优先。