---
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 名称，也不要写成普通文件名或自然语言描述。

## 使用流程

1. 先确认用户要的是“生成 prompt”，不是直接执行任务。
2. 读取目标项目 `AGENTS.md` 或同类规则文件，再读取与任务相关的 README、开发日志、测试说明、版本 / 报告规则或真实调用链文件。
3. 从用户输入和项目材料中提取：
   - 仓库路径、项目类型、当前版本、版本策略。
   - 本轮目标、硬性边界、禁止修改范围。
   - 必读文件、参考材料、真实调用链线索。
   - 必做 TODO、测试验证、交付物和报告要求。
4. 读取 `references/prompt-template.md`，按本轮任务删减和填充。
5. 输出前将生成的 prompt 保存为临时草稿或在内存中逐项核对，并运行专项校验脚本检查关键执行约束：

```powershell
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 按下面顺序组织：

1. 任务开场：明确仓库、目标和“不允许跳过”的执行口吻。
2. `【硬性前置要求（必须先做）】`
3. `【项目定位与边界】`
4. `【版本与文档策略（必须遵守）】`
5. `【本次要完成的 TODO，必须全部落地】`
6. `【实现约束】`
7. `【测试与验证要求，必须执行】`
8. `【交付物要求】`
9. `【注意】`

不适用的章节要删除或合并，不要保留空标题。

## 输出包裹规则

- 最终 prompt 必须整体放入一个 Markdown 文本块。
- 如果 prompt 内部包含三反引号，外层使用四反引号或更长围栏。
- 不要用 XML/HTML 风格标签、引用块或普通列表替代文本块。
- 输出代码块前最多写一句中文引导；输出代码块后不要追加额外正文。

## 质量标准

- 最终 prompt 要像执行指令，不像建议、教程或泛泛计划。
- 约束必须具体、可检查、可落地。
- 交付物必须明确到文件、报告、命令或证据路径层面。
- 不触发版本或报告时，prompt 必须要求执行者在最终总结中说明原因。
- 用户明确要求生成报告时，prompt 必须按用户指定路径或项目规则生成报告。

## 自检

输出 prompt 前逐条检查：

1. 是否明确本轮只是生成 prompt，不是已经执行任务。
2. 是否读取并遵守项目 `AGENTS.md`。
3. 是否没有把 Plan mode 或 code review 的完整规则复制进本 skill。
4. 如果 prompt 中交叉引用其他 skill，是否统一使用 `$skill-name` 形式。
5. 是否没有把旧项目私有路径、测试命令、版本号或专项风险规则写成通用要求。
6. 是否没有把未验证事实写成已验证。
7. 是否避免加入无依据的保护逻辑，并要求执行者说明依据、影响、可观测性、验证方式和后续调整方式。
8. 是否已运行 `validate_project_prompt.py` 或对同等规则逐项校验，并根据失败项循环修改到通过。
9. 是否最终只交付一个 Markdown 文本块。