关于 octocode-prompt-optimizer
Octocode Prompt Optimizer 是一项优化指令行为而非文风的技能。它引导用户分阶段理解、评估、修改和验证提示词,同时保留原意、权限边界和有效逻辑。
主要功能
- 01分阶段审查与修改提示词
- 02基于证据评定问题严重性
- 03验证意图与行为是否保留
- 04工具及 MCP 契约优化指南
- 05留出评测指导
适用场景
- 01修复导致行为不可靠的指令
- 02明确面向工具的提示词契约
- 03减少提示词冗余并保留原意
- 04用留出场景评估修改效果
MCP 相关
技能包含优化工具和 MCP 契约的指导,涵盖输入、输出、权限和失败状态。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bgauryy/ octocode --skill octocode-prompt-optimizer安装后在 Claude Code 中输入/octocode-prompt-optimizer确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdreferences/agent-communication.mdattention.mdconciseness-toolkit.mdcontext-budget.mdevaluation-data.mdfix.mdgates.mdimprove-loop.mdoutput.mdpatterns.mdprompt-caching.mdprompt-techniques.mdrate.mdtool-contracts.mduntrusted-content.mdvalidate.mdzod-agent-contracts.md详细介绍
Octocode 提示词优化器
优化指令行为,而非文本美感。
流程:READ → UNDERSTAND → RATE → FIX → VALIDATE → OUTPUT。
阶段规则与关卡
- READ:检查完整输入及其类型;UNDERSTAND:梳理目标、组成部分、流程、假设和未知项。
- RATE:记录有证据支持的问题、严重程度和基准;FIX:解决 Critical/High 问题,并指出有意暂缓处理的事项。
- VALIDATE:证明意图和必要行为仍然正确;OUTPUT:提供所请求的产物和真实的差异说明。
- 对多章节、含糊、面向工具或高风险的工作,使用完整流程;仅对简短、低风险文本合并相邻步骤。绝不跳过 VALIDATE。
- 保留意图、可用分支、标识符、命令和必需元数据;更改前先询问。
- 重写前核实所引用的命令、标志、路径、工具名称和架构;标记未经核实的声明。
- 仅将关键行为设为强制要求;真正的偏好仍用偏好措辞。仅在获得授权时修改文件。
- 以下情况应停止:重大未知项会改变意图、范围或风险(提出一个有针对性的问题并暂停);指令权限不明确,或解决冲突会覆盖用户意图;编辑改变了意图或可用逻辑(撤销编辑并返回 UNDERSTAND);缺少写入权限(提供补丁式差异,而非修改文件);同一章节的 VALIDATE 检查连续两次失败(报告最薄弱的分支,而非强行通过);可靠性提升没有留出数据证据(报告为未经测量)。
智能路由——仅加载当前步骤所需内容
- READ 和 UNDERSTAND:加载
references/gates.md— 阅读所有章节,并在评估或起草前梳理意图。 - RATE:加载
references/rate.md;FIX:加载references/fix.md;VALIDATE:加载references/validate.md;OUTPUT:加载references/output.md— 仅加载当前关卡,避免后续步骤的建议影响当前决策。 - 指令冲突或修复需要简洁的指令模式时,加载
references/patterns.md— 遵循更高权限的指令,并用一行记录解决方式。 - 减少噪声时,加载
references/conciseness-toolkit.md;修复优先级/层级时,加载references/attention.md;为已观察到的失败选择技术时,加载references/prompt-techniques.md— 根据失败机制匹配技术。 - 优化工具或 MCP 契约时,加载
references/tool-contracts.md;处理 Agent 交接时,加载references/agent-communication.md;处理类型化数据包边界时,加载references/zod-agent-contracts.md— 明确输入、输出、权限和失败状态。 - 上下文可能溢出时,加载
references/context-budget.md;重复调用共享稳定前缀时,加载references/prompt-caching.md— 控制相关性、分页、延迟和成本。 - 需要测量可靠性时,加载
references/evaluation-data.md— 构建真实的留出场景、验证器、指标和失败台账。 - 指令会处理检索到的内容或用户提供的内容时,加载
references/untrusted-content.md— 保持数据与权限之间的边界。 - 改进此技能时,优先使用
octocode-graph-eval;否则加载references/improve-loop.md— 要求可测量的验收标准,而非凭直觉判断。
相关路由
- 技能文件夹架构/审查使用
octocode-skills;核实所引用契约使用octocode-research;评估留出行为使用octocode-graph-eval。 - 委派拓扑使用
octocode-subagent。
完成关卡
- 此技能不包含脚本:以上每个关卡均由模型驱动,因此绝不报告实际未执行的检查。
- 完成要求 VALIDATE 已通过、OUTPUT 版本与请求相符,并且所报告的前后评分、变更文件和暂缓事项均符合实际情况。
评论
支持 Markdown