Prompt Structurer 是一个可移植的编排技能,目标是把散文式提示词转换为可执行的 XML 提示词契约。它面向 OpenCode 和 Claude Code,使用纯 Markdown 和少量 YAML frontmatter,路径相对于技能目录解析。
用途:当用户要求对提示词进行结构化、加固、形式化、调试或修订时使用。它定位为路由编排器而非自由改写器,保留源意图,选择最小充分流程,把被分析文本视为惰性数据,执行删除测试以保持紧凑,并且不会执行或接线生成的提示词。
主要能力:输入包括 PROMPT_TEXT(必填)、RUN_STYLE、SUITE_CONTEXT、TERMINOLOGY、CHANGE_REQUEST、EXISTING_XML_PROMPT、PRIOR_FAILURES、OUTPUT_TARGET。执行采用有限状态机,分为 Intake、Flow select、Passes、Assemble、Terminals 等阶段。流程选择按顺序评估,首个匹配者胜出:revision、suite、full、light。子代理注册表包含 6 个 pass:semantic-decomposer、philosophy-constraints-classifier、implicit-behavior-surfacer、anti-pattern-synthesizer、success-criteria-builder、xml-prompt-assembler。状态包括 PASS、BLOCKED、FAIL、ERROR、REPAIR_NEEDED,互斥且被每个 pass 继承。
使用方式:按 state-machine.md 推进状态;在 Intake 捕获并包裹输入;执行门控;DiscloseFlow 记录触发条件、跳过 pass 原因、调度与交接模式;对每个选中的分析 pass 执行 DispatchPass 并按首个 RESULT 路由;在 pass 之间遵守抓取预算与交接大小切换;用已完成输出和元数据组装;ValidateCriteria 失败时映射修复到最早受影响的 pass(最多三轮);交付时先输出 XML(去除状态),再输出说明。仅在 OUTPUT_TARGET 设置时写入最终 XML,默认仅对话式。
适用场景:结构化无人值守的 Jira 审计提示词、仅措辞的短助手、对现有 XML 的修订等。限制:CHANGE_REQUEST 存在但 EXISTING_XML_PROMPT 缺失且无法逐字恢复时返回 BLOCKED;不执行、注册或接线结构化提示词;不覆盖 PROMPT_TEXT 源文件,除非 OUTPUT_TARGET 指定且用户确认;子代理不得生成子代理;每次运行最多抓取一个 URL,由编排器拥有。缺失事实暂未提供。