Vibe Prompt Compiler Portable

将粗略的实现需求转化为可移植的编码简报，可直接粘贴至几乎任意 AI 编程工具中使用。

默认行为

当用户提出模糊的编程请求时，自动启用本技能。无需用户预先运行脚本。

具体流程如下：

1. 对请求进行分类。
2. 提取请求中已明确提供的事实信息。
3. 将缺失的细节显式转化为合理假设。
4. 编译生成一份清晰、自洽的内部实现简报。
5. 以该简报作为编码响应的唯一事实依据（source of truth）。

仅当用户明确要求可移植性、可复用的 CLI 命令，或需为其他工具保存交接文档时，才提及脚本相关内容。

任务类型

将请求归类为以下其中一种：

• new-project
• page-ui
• crud-feature
• api-backend
• bugfix
• refactor
• ai-feature
• architecture-review
• integration
• automation-workflow
• deployment
• general

优先选择最窄、最明确的类型。仅当某一关键缺失信息严重阻碍有效推进时，才向用户提出补充问题。

可移植默认原则

除非用户另有说明，否则默认遵循以下原则：

• 优先选择 MVP 方案，避免过度工程化
• 优先采用最小化变更（minimal diffs），而非大范围重写
• 不修改与当前任务无关的文件
• 避免引入新依赖，除非有充分理由
• 所有假设均须显式声明
• 确保输出易于测试与验证
• 当明确排除某些目标有助于减少偏离（drift）时，应主动申明非目标（non-goals）
• 对现有系统，优先采用渐进式演进（evolutionary changes），而非整体重写
• 严格区分当前任务执行内容与未来状态构想

主要命令

默认行为：在脑内完成编译，并直接将结构化结果用于回答或编码工作流中。

必要时可通过 CLI 编译提示词：

python3 scripts/compile_prompt.py --request ""

生成交接简报（handoff brief）：

python3 scripts/create_handoff.py --request "" --output handoff

提取仓库感知规则（repository-aware rules）：

python3 scripts/extract_repo_rules.py --repo-root .

常用参数标志（flags）：

• --task auto
• --stack "Next.js, Supabase, Tailwind"
• --audience "运营人员"
• --mode plan-only
• --mode build-first-slice
• --mode bugfix
• --target-tool codex-cli
• --language-preset chinese-first
• --ruleset minimal-diff
• --repo-root .
• --auto-repo-rules
• --output json

目标工具使用建议

当请求范围宽泛、涉及架构设计，或存在较高漂移（drift）风险时，应优先生成交接式简报（handoff-style brief），而非基于原始请求直接作答。

Cursor / VS Code 聊天界面

• 运行 compile_prompt.py 或 create_handoff.py
• 将输出内容粘贴至聊天窗口
• 让工具仅实现当前切片（current slice）

Claude Code / Codex CLI / Gemini CLI

• 以编译后的提示词或交接简报作为唯一事实依据（source of truth）
• 对于宽泛型任务，应首先要求编码工具进行规划（plan first）
• 对于缺陷修复类任务，应明确要求最小化修复（minimal fixes）
• 推荐使用 --target-tool、--ruleset 及仓库感知类参数（如 --repo-root），以强化执行约束力

发布说明

本技能现已具备对外共享条件，可作为一款可移植的编码简报编译器，支持：

• 结构化提示词编译
• 更强健的执行交接机制
• 中文优先输出（chinese-first output）
• 面向特定工具的预设配置（tool-specific presets）
• 开发规则集（development rulesets）
• 仓库感知的规则提取与合并（repository-aware rule extraction and merging）
• 覆盖路由、黄金输出（golden outputs）、预设项、代码检查（linting）及仓库感知流程的回归测试保障

参考文档

• 请首先阅读 references/auto-mode.md，了解默认自动行为。
• 请阅读 references/templates.md 查看提示词模板（prompt skeletons）。
• 当分类不明确时，请查阅 references/routing.md。
• 请阅读 references/usage.md 了解主流 IDE 和编程工具中的推荐工作流。
• 请阅读 references/tool-examples.md 查看 Cursor、Claude Code、Codex CLI 和 Gemini CLI 中的具体使用示例。
• 请阅读 references/real-examples.md 查看真实请求到简报的转化案例，尤其适用于架构设计、系统集成、自动化工作流及模糊编程请求等场景。