| name | project-prompt-creator |
| description | 在项目 AGENTS.md 约束下生成可直接交给 Codex 或 Agent 执行的中文任务 prompt。用于开发、修复、文档、验证、审计、治理或交接任务的 prompt 化，但不承载 Plan mode 和 code review 的完整模式规则。 |
project-prompt-creator
技能定位
生成一次具体任务的执行 prompt。它的唯一主产物是一份能复制给 Codex/Agent 立刻执行的中文 prompt，不是建议清单、教程、变量表，也不是直接开始执行 prompt 中的任务。
计划优先任务交给 $plan-mode-planner，代码审查任务交给 $code-reviewer，创建项目本地 skill 交给 $project-skill-creator。只有用户明确要求合并多个模式时，才在最终 prompt 中引用对应原则。
如果一次开发、修复、文档或方案 prompt 的执行依赖外部最新知识、官方 API、库版本、论文、benchmark、标准、许可证或技术选型依据，最终 prompt 应明确要求后续执行者先调用 $web-search，再把外部结论转成工程约束和验证要求。不要把未检索的外部事实写成已确认结论。
Skill 交叉引用规则
如果生成的 prompt 需要明确要求后续执行者调用其他 skill，必须使用 $skill-name 形式引用，例如 $plan-mode-planner。不要只写反引号包裹的 skill 名称，也不要写成普通文件名或自然语言描述。
使用流程
- 先确认用户要的是“生成 prompt”，不是直接执行任务。
- 读取目标项目
AGENTS.md 或同类规则文件，再读取与任务相关的 README、开发日志、测试说明、版本 / 报告规则或真实调用链文件。
- 从用户输入和项目材料中提取：
- 仓库路径、项目类型、当前版本、版本策略。
- 本轮目标、硬性边界、禁止修改范围。
- 必读文件、参考材料、真实调用链线索。
- 必做 TODO、测试验证、交付物和报告要求。
- 读取
references/prompt-template.md，按本轮任务删减和填充。
- 输出前将生成的 prompt 保存为临时草稿或在内存中逐项核对，并运行专项校验脚本检查关键执行约束：
python -X utf8 vibe-coding-template/skills/project-prompt-creator/scripts/validate_project_prompt.py path/to/generated-prompt.md
脚本失败时，必须按缺失项继续补齐 prompt 并复跑。该脚本只检查关键结构和质量约束是否保留，不判断任务内容是否已经完全覆盖用户意图。
6. 输出一个完整、连续、可复制、可执行的中文 prompt。
默认补全规则
- 仓库路径来自用户输入或当前工作目录；无法确认时要求执行者先核对。
- 语言、编码、测试、版本、文档和报告策略优先来自项目
AGENTS.md。
- 没有证据的版本号、接口、路径、测试结果、发布状态不能写成事实。
- TODO 多时按
A / B / C / D 分块；单任务只保留一个任务块，不堆空标题。
- 保留用户原话中的硬性边界，再做项目化归纳。
- 不要生硬照搬其他项目的模块名、测试命令、版本号、专项风险规则、评测口径或发布流程。
- 涉及
{{风险域}} 中的真实服务、用户数据、权限、外部系统、人工步骤或生产环境时，必须要求执行者写清验证边界和不可验证项。
- 不新增没有依据的保护逻辑；保护逻辑包括但不限于中断条件、容量边界、输入输出限制、重试 / 轮询策略、降级 / 回退策略、异常捕获策略和默认值策略。错误处理必须显式暴露问题，不能吞异常或伪造成功。
- 必须明确禁止无依据固定超时、长度截断、条数上限、重试上限、静默降级和隐藏兜底；这些不是“默认稳健性”，只有存在用户要求、平台限制、项目既有约定或真实故障证据时才能写入 prompt。
Prompt 固定结构
除非用户要求极短版，最终 prompt 按下面顺序组织：
- 任务开场：明确仓库、目标和“不允许跳过”的执行口吻。
【硬性前置要求（必须先做）】【项目定位与边界】【版本与文档策略（必须遵守）】【本次要完成的 TODO，必须全部落地】【实现约束】【测试与验证要求，必须执行】【交付物要求】【注意】
不适用的章节要删除或合并，不要保留空标题。
输出包裹规则
- 最终 prompt 必须整体放入一个 Markdown 文本块。
- 如果 prompt 内部包含三反引号，外层使用四反引号或更长围栏。
- 不要用 XML/HTML 风格标签、引用块或普通列表替代文本块。
- 输出代码块前最多写一句中文引导；输出代码块后不要追加额外正文。
质量标准
- 最终 prompt 要像执行指令，不像建议、教程或泛泛计划。
- 约束必须具体、可检查、可落地。
- 交付物必须明确到文件、报告、命令或证据路径层面。
- 不触发版本或报告时，prompt 必须要求执行者在最终总结中说明原因。
- 用户明确要求生成报告时，prompt 必须按用户指定路径或项目规则生成报告。
自检
输出 prompt 前逐条检查：
- 是否明确本轮只是生成 prompt，不是已经执行任务。
- 是否读取并遵守项目
AGENTS.md。
- 是否没有把 Plan mode 或 code review 的完整规则复制进本 skill。
- 如果 prompt 中交叉引用其他 skill，是否统一使用
$skill-name 形式。
- 是否没有把旧项目私有路径、测试命令、版本号或专项风险规则写成通用要求。
- 是否没有把未验证事实写成已验证。
- 是否避免加入无依据的保护逻辑，并要求执行者说明依据、影响、可观测性、验证方式和后续调整方式。
- 是否已运行
validate_project_prompt.py 或对同等规则逐项校验，并根据失败项循环修改到通过。
- 是否最终只交付一个 Markdown 文本块。
