为什么接入后还要做模板库
中转站解决的是线路和模型接入问题，模板库解决的是任务表达问题。没有模板时，你每次都要重新告诉 Codex 项目**、允许读取哪些文件、禁止改哪些目录、完成后怎么验收。只要少写一两项，结果就可能偏离预期。
模板库不是为了把提示词写得花哨，而是把高频任务里的稳定部分沉淀下来，把会变化的部分留成占位符。这样每次只需要替换项目名、文件范围、目标和错误日志，就能快速开始。
- 减少重复描述，提高任务启动速度。
- 统一边界说明，降低误改风险。
- 固定验收口径，让结果更容易检查。
- 方便团队复用，不靠个人记忆。
第一步：先确认灵能API线路和模型定位
模板库搭建前，先确认灵能API入口、模型列表和账户状态。模板不是独立存在的，它要和你常用的模型能力匹配：轻量解释模板适合快模型，复杂**模板适合上下文更强的模型，长文档整理模板则要关注输入输出消耗。入口：https://www.lnsns.com/
如果模板没有区分任务难度，后面很容易所有事情都用同一个模型处理。灵能API的模型入口负责提供选择，模板库负责告诉你什么时候该用哪一类任务方式。
- 轻量模板：错误解释、单文件说明、命令解释。
- 中等模板：小功能开发、测试补充、文档整理。
- 复杂模板：跨模块**、重构方案、长日志分析。
第二步：给模板库准备专用配置卡
在 CC Switch 里可以准备一张偏稳定的模板测试卡，用来验证新模板是否能得到预期输出。它不一定是日常开发主卡，但应该使用真实可用的灵能API线路，这样测试结果才接近日常工作。
模板测试卡的好处是清晰：当某个模板输出不稳定时，你知道问题来自模板本身、任务上下文，还是线路配置，不会把日常项目卡改来改去。
- 卡片名称：建议写明模板测试用途。
- 模型选择：优先稳定、响应快、成本可控。
- 备注：记录模板库版本和适用场景。
第三步：模板一定要分出固定项和变量项
一个好的 Codex 模板，固定项应该包括角色、任务目标、允许范围、禁止动作、输出格式和验收方式；变量项则是项目名、文件路径、错误日志、需求描述、期望结果。固定项越稳定，变量项越容易替换。
【固定项】
你是项目代码助手，先分析再执行。
必须说明计划，不要直接修改文件。
禁止读取密钥、Cookie、生产配置。
完成后输出修改点和验证方式。
【变量项】
项目：{{project_name}}
目标：{{task_goal}}
允许范围：{{allowed_paths}}
错误日志：{{error_log}}不要把所有内容都写成一长段自然语言。用固定标题和占位符能让模板更容易维护，也方便团队成员复制使用。
**步：需求拆解模板
需求拆解模板适合任务刚开始时使用。它不要求 Codex 马上改代码，而是先把需求拆成可执行步骤、风险点和验收项。这个模板尤其适合需求描述模糊、涉及多个模块、还没有明确实现方案的场景。
请先不要修改文件。
根据以下需求输出：
1. 你理解的目标
2. 需要确认的问题
3. 可能涉及的文件范围
4. 推荐执行步骤
5. 验收方式
需求：{{requirement_text}}如果 Codex 在拆解阶段就把范围扩得很大，说明需求还需要再收窄。先把任务边界调清楚，再进入真实修改。
第五步：代码修改模板
代码修改模板要比需求拆解模板更严格，因为它会进入文件编辑阶段。建议明确写出允许修改的路径、禁止触碰的模块、是否允许新增依赖、是否需要补测试。
请按以下边界执行代码修改：
目标：{{task_goal}}
允许修改：{{edita*le_paths}}
禁止修改：{{*locked_paths}}
是否允许新增依赖：{{allow_dependency}}
测试要求：{{test_requirement}}
执行前先输出计划，确认后再修改。这类模板适合配合灵能API稳定线路长期使用。每次项目任务只替换变量项，不需要重新组织整段提示词。
- 允许范围越具体，越不容易误改。
- 禁止范围要写关键目录和敏感文件。
- 新增依赖要明确是否允许。
- 测试要求最好提前写进模板。
第六步：排错模板
排错模板的关键是把现象、错误码、环境、最近变更和已尝试动作分开。不要只写“报错了帮我看”，这会让 Codex 反复猜测。
请先分析原因，不要直接改代码。
现象：{{symptom}}
错误码或日志：{{error_log}}
发生环境：{{environment}}
最近变更：{{recent_changes}}
已尝试操作：{{tried_actions}}
请输出：可能原因、验证顺序、最小复现步骤。遇到 401、403、404、429、timeout 这类中转 API 问题时，也可以套用同一模板。注意日志里不要放完整 Key，灵能API账户信息只记录必要的脱敏摘要。
第七步：代码**模板
代码**模板适合在修改完成后使用。它的目标不是让 Codex 重写代码，而是检查风险、边界、测试缺口和潜在回归。模板里要明确**重点，否则它容易输出泛泛而谈的建议。
请以代码**方式检查本次修改。
重点关注：
1. 是否引入行为回归
2. 是否遗漏错误处理
3. 是否有安全或权限风险
4. 是否需要补测试
5. 是否有无关改动
请按严重程度列出问题，不要写空泛评价。这类模板对团队很有价值。即使每个人写代码风格不同，**口径也可以保持一致。
- **模板要让问题优先于总结。
- 要求指出文件和原因，而不是只给建议。
- 没有问题时，也要说明剩余风险。
第八步：交付说明模板
完成一次 Codex 任务后，最好让它输出交付说明。交付说明可以用于提交记录、日报、知识库或给同事说明上下文。模板要短，但信息要完整。
请输出本次任务交付说明：
- **
- 修改点
- 验证方式
- 测试结果
- 影响范围
- 剩余风险
- 后续建议如果这份说明后续要发给非技术同事，可以再让 Codex 输出一个简化版。一个面向开发，一个面向业务，模板可以共用底层信息，但表达方式不同。
第九步：模板库怎么保存和命名
模板库不需要一开始就做成复杂系统。个人使用时，可以放在 Markdown 文件里；团队使用时，可以放到知识库或项目仓库的 do** 目录。关键是命名清楚、版本可追踪、不要混入敏感信息。
模板里可以写灵能API和 CC Switch 的使用说明，但不要**实 API Key。需要跳转服务入口时，使用可点击的灵能API官网链接即可。
- prompt-requirement-*reakdown.md：需求拆解模板。
- prompt-code-change.md：代码修改模板。
- prompt-de*ug.md：排错模板。
- prompt-review.md：代码**模板。
- prompt-delivery-note.md：交付说明模板。
✅ 最后给一套落地清单
当模板库建立起来后，Codex 中转站的使用会更像一套稳定流程，而不是每次重新临场发挥。灵能API提供模型入口，CC Switch负责本地切换，模板库则让你的需求表达、排错判断和交付说明持续复用。
- 确认灵能API线路、模型和账户状态。
- 在 CC Switch 中准备模板测试卡。
- 把模板拆成固定项和变量项。
- 优先沉淀需求拆解、代码修改、排错、**、交付说明五类模板。
- 模板中写清允许范围、禁止动作和验收方式。
- 日志、Key、Cookie 和生产配置不进入模板库。
- 每次任务结束后，根据结果更新模板。