| name | codenote-plan-mode-prompt |
| description | 为 CodeNote Helper 生成要求 Codex 使用 Plan mode 的中文 prompt。用于高层设计、架构取向、协作流程、版本边界或风险较高任务，需要先只读探索、提炼 2 到 4 个关键决策点、等待用户选择后再实现；不直接执行计划或修改代码。 |
CodeNote Helper Plan Mode Prompt 生成
技能定位
本 skill 只生成“要求 Codex 使用 Plan mode 的 prompt”。它不进入 Plan mode，不直接给最终实现方案，不替用户拍板，也不修改仓库文件。
适用场景：
- 用户要求先计划、先给选择空间、先不要改代码。
- 任务涉及架构边界、目录归属、长期维护策略、权限审核风险、版本和报告策略。
- 问题反复修复仍未闭环，需要先抽象关键决策，再收敛实现。
不适用场景：
- 普通执行 prompt 使用
$codenote-fix-prompt。
- code review prompt 使用
$codenote-code-review-prompt。
- 创建或更新本地 skill 使用
$codenote-skill-creator。
Skill 交叉引用规则
如果生成的 Plan mode prompt 需要指向其他 skill，必须使用 $skill-name 形式引用，例如 $codenote-fix-prompt。不要只写反引号包裹的 skill 名称，也不要把 skill 名称写成普通说明。
使用流程
- 确认用户需要的是 Plan mode prompt，而不是本轮直接进入 Plan mode。
- 读取项目材料：
AGENTS.md- 仅当
AGENTS.override.md 存在时读取它。
DEVLOG.mdREADME.md- 与本轮主题相关的项目文件、历史报告或参考模板。
- 读取
references/plan-template.md，按 CodeNote Helper 背景裁剪。
- 输出一份完整、连续、可复制的中文 Plan mode prompt。
Prompt 必须表达的规则
最终 prompt 必须要求后续执行者：
- 先使用 Plan mode。
- 只读探索真实仓库、调用链、文档和约束，不直接编辑文件。
- 不要一开始写死完整方案，也不要把细枝末节包装成用户决策。
- 从现场事实中提炼 2 到 4 个关键决策点。
- 每个决策点说明为什么必须现在决策、不同选择影响什么、当前事实倾向是什么、需要用户确认什么。
- 等用户选择后，再收敛文件级计划、验证方式、版本与报告策略、风险和回滚边界。
CodeNote Helper 专属关注点
根据任务相关性，把下列背景写进 Plan mode prompt：
- CodeNote Helper 是 Chrome MV3 扩展，主线覆盖算法刷题笔记、间隔复习、深度学习复盘和 AI 对话时间轴。
- 默认简体中文、Windows 与 UTF-8 编码。
- 默认保持当前版本；升版必须由用户明确要求并同步版本位置。
- 涉及功能修复、行为变更、UI 调整、结构调整或测试闭环时，通常需要
DEVLOG.md 和 docs 修复报告；计划中必须提醒后续报告要通俗可读，Chrome MV3、权限、OAuth / Google Drive / WebDAV、测试工具和 manifest 字段都要配中文解释，不能只堆路径和英文术语。
- 涉及
manifest.json、权限、host、content scripts、远程请求、README、隐私政策或商店说明时，必须先评估 Chrome Web Store 审核成本。
- 不要新增无依据的固定超时、截断、上限、重试、静默兜底或吞异常。
- 不要提前把所有规则塞成一个完整实现方案；Plan mode 的重点是先识别少数关键选择。
输出包裹规则
- 最终 Plan mode prompt 必须整体放入一个 Markdown 文本块。
- 如果 prompt 内部包含三反引号，外层使用四反引号或更长围栏。
- 输出代码块前最多写一句中文引导；代码块后不要追加正文。
自检
输出前检查：
- 是否明确本 skill 只是生成 Plan mode prompt。
- 是否要求后续执行者先只读探索，再提炼 2 到 4 个关键决策点。
- 是否没有替用户拍板或直接给完整实现方案。
- 是否没有把普通执行、code review 或 skill creator 的完整职责塞进本 prompt。
- 如果 prompt 中交叉引用其他 skill，是否统一使用
$skill-name 形式。
- 是否保留 CodeNote Helper 的版本、报告、权限审核、编码和用户偏好边界。
