mcpField
O
octocode-prompt-optimizer

octocode-prompt-optimizer

github.com/bgauryyAgent 工作流95695 次安装9 周前更新
代码仓库

关于 octocode-prompt-optimizer

Octocode Prompt Optimizer 是一项优化指令行为而非文风的技能。它引导用户分阶段理解、评估、修改和验证提示词,同时保留原意、权限边界和有效逻辑。

主要功能

  1. 01分阶段审查与修改提示词
  2. 02基于证据评定问题严重性
  3. 03验证意图与行为是否保留
  4. 04工具及 MCP 契约优化指南
  5. 05留出评测指导

适用场景

  1. 01修复导致行为不可靠的指令
  2. 02明确面向工具的提示词契约
  3. 03减少提示词冗余并保留原意
  4. 04用留出场景评估修改效果

MCP 相关

技能包含优化工具和 MCP 契约的指导,涵盖输入、输出、权限和失败状态。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bgauryy/octocode --skill octocode-prompt-optimizer

安装后在 Claude Code 中输入/octocode-prompt-optimizer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
agent-communication.md
attention.md
conciseness-toolkit.md
context-budget.md
evaluation-data.md
fix.md
gates.md
improve-loop.md
output.md
patterns.md
prompt-caching.md
prompt-techniques.md
rate.md
tool-contracts.md
untrusted-content.md
validate.md
zod-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