⚡

提示架构师Skill prompt-architect

这个技能用于根据Claude 4.x标准，将用户需求转化为结构化、可执行的最佳实践提示。它基于Nate B. Jones的四个初学者动作（定义输出形状、提供上下文、建议静默计划、添加自检）和Anthropic的最佳实践，通过合同风格模板生成优化提示，提升AI模型交互效率和质量。适用于大模型微调、提示工程优化，关键词：提示架构、Claude 4.x、最佳实践、提示生成、AI模型优化、Nate B. Jones、大模型微调、提示工程、合同风格模板、自检验证。

大模型微调 0 次安装 0 次浏览 更新于 3/18/2026

名称: prompt-architect 描述: | 根据Claude 4.x标准（2025年12月）将需求转化为最佳实践提示。

基于：

  • Nate B. Jones 的四个初学者动作：形状、上下文、静默计划、自检
  • Anthropic Claude 4.x 最佳实践：明确性、合同风格、示例胜过形容词
  • 管道优于提示的哲学

在clarify-spec之后自动激活或通过/prompt-architect触发。 生成结构化、可执行的提示，包含所有最佳实践。 触发器:

  • /prompt-architect
  • /prompt
  • /architect
  • /build-prompt

Prompt-Architect：最佳实践提示生成器

基于Claude 4.x最佳实践（2025年12月）

来源：

  • Nate B. Jones 提示工程手册 2025
  • Anthropic 官方Claude 4.x提示指南
  • Claude 代码最佳实践

激活

在clarify-spec之后自动

如果clarify-spec生成了JSON输出，prompt-architect可以将此JSON转换为结构化提示。

手动通过触发器

/prompt-architect [任务描述]

四个初学者动作（Nate B. Jones）

动作1：定义输出形状

不要：写好的代码 而是：生成一个带有接口X的TypeScript文件，导出函数Y

定义具体工件：

  • 哪些文件将被创建/修改？
  • 输出的格式是什么？
  • 示例输出是什么样子？

动作2：提供最小但足够的上下文

  • 自动读取相关文件
  • CLAUDE.md/AGENTS.md 摘要
  • 仅需必要内容 - 避免上下文溢出
  • 注意令牌预算

动作3：建议静默计划

  • Claude 应在内部计划后再回答
  • 对于Claude 4.5：首先考虑您的方法
  • 在禁用扩展思维时避免思考

动作4：添加快速自检

  • 在提示末尾添加评估块
  • 检查清单：格式是否遵循？约束是否满足？
  • 在响应前，验证：[检查清单]

Claude 4.x 特定模式

明确性 + 修饰符

不要：创建仪表板 而是：创建仪表板。尽可能包含相关功能。超越基础。

上下文 + 动机（为什么解释什么）

不要：永远不要使用省略号 而是：您的响应将被TTS朗读，所以永远不要使用省略号，因为TTS无法发音。

示例胜过形容词

不要：写得专业 而是：展示示例输出，演示格式

用于结构的XML标签

<output_structure>, <constraints>, <verification>

不确定性许可

如果不确定，明确说明并询问澄清问题。 大幅减少幻觉。

合同风格模板

分析任务后，生成此结构化提示：

—开始生成提示—

角色和目标

您是：[基于任务类型的角色，例如高级TypeScript开发人员] 目标：[来自clarified_task.goal的具体成功定义，一句话]

上下文

[自动收集：]

  • 项目：[来自CLAUDE.md的项目名称]
  • 相关文件：[列表，带简短内容概述]
  • 现有模式：[从代码库中提取]
  • 禁止触碰区域：[来自clarified_task.scope.no_touch]

约束

  • [约束1作为项目符号，来自clarified_task.constraints]
  • [约束2作为项目符号]
  • [最多5个约束]
  • 如果不确定任何方面：明确说明并请求澄清

任务

[清晰的任务描述，来自clarified_task.goal + problem_statement]

成功标准

  • [标准1来自clarified_task.success_criteria]
  • [标准2]
  • 所有现有测试必须通过

示例（如果examples_needed = true）

输入：[示例输入] 预期输出：[预期输出]

输出格式

<output_structure> [基于任务类型的精确格式：]

  • 对于代码：完整文件，无差异，无占位符
  • 对于文档：带标题的Markdown
  • 对于配置：带注释的JSON/YAML </output_structure>

验证（自检）

在响应前，验证： [ ] 输出格式是否完全遵循？ [ ] 约束部分的所有约束是否满足？ [ ] 任务部分的所有成功标准是否达到？ [ ] 不确定的声明是否标记为[UNCERTAIN]？ [ ] 是否没有更改禁止触碰区域？

—结束生成提示—

工作流程

步骤1：分析输入

接受：

  1. 来自clarify-spec的JSON（首选）
  2. 自由文本描述
  3. 结合当前项目上下文

步骤2：自动收集上下文

步骤3：填充模板

用以下内容填充合同风格模板：

  • 基于任务类型的角色（前端、后端、DevOps等）
  • 来自clarified_task.goal的目标
  • 来自项目分析的上下文
  • 来自clarified_task.constraints的约束
  • 来自goal + problem_statement的任务
  • 基于预期工件的输出格式
  • 验证检查清单

步骤4：呈现提示

向用户显示生成的提示：

生成的最佳实践提示

[完整提示在此]

选项：

  • 执行：立即执行此提示
  • 调整：修改提示
  • 复制：提示到剪贴板
  • 保存：保存为模板

步骤5：执行

在执行时：

  1. 内部使用提示
  2. 与质量门（如果/supervisor激活）
  3. 呈现结果

示例：从模糊任务到最佳实践提示

输入（来自clarify-spec）：

{ clarified_task: { goal: 修复PPTX导出，使AI图片可靠出现， problem_statement: 图片有时在PPTX下载中缺失， scope: { files: [presentationBuilder.ts, chartVisualGenerator.ts], no_touch: [api/analyze.ts] }, success_criteria: [所有图片出现，小于500KB，无错误], constraints: [无破坏性更改] } }

输出（生成的提示）：

角色和目标

您是：专门从事基于浏览器的文件生成的高级TypeScript开发人员 目标：修复PPTX导出，使AI生成的图片在下载文件中可靠出现

上下文

  • 项目：fabrikIQ分析器（制造AI平台）
  • 相关文件：
    • presentationBuilder.ts：PptxGenJS集成，幻灯片生成
    • chartVisualGenerator.ts：Gemini图片生成，base64处理
  • 现有模式：Async/await，try-catch错误处理
  • 禁止触碰区域：api/analyze.ts（核心分析）

约束

  • 不对现有PPTX导出功能进行破坏性更改
  • 图片必须压缩到500KB以下
  • 保持现有错误处理模式
  • 如果不确定任何方面：明确说明并询问

任务

修复PPTX导出，确保AI生成的图片在下载中可靠出现。 当前问题：图片有时在最终PPTX文件中未能出现。

成功标准

  • 所有AI生成的图片出现在PPTX中
  • 每个图片文件大小小于500KB
  • 下载过程中无控制台错误
  • 现有测试仍然通过

输出格式

<output_structure> 提供完整的、修改后的TypeScript文件。 无差异，无占位符，无部分实现。 包括简要注释解释关键更改。 </output_structure>

验证

在响应前，验证： [ ] 所有图片将正确嵌入？ [ ] 压缩逻辑处理边缘情况？ [ ] 没有更改api/analyze.ts？ [ ] 错误处理覆盖网络失败？

令牌效率

生成的提示优化用于：

  • 最小上下文（仅相关信息）
  • 最大清晰度（无歧义）
  • 自验证（减少迭代）

集成

与clarify-spec

clarify-spec -> JSON -> prompt-architect -> 执行

与/supervisor

prompt-architect -> 提示 -> /supervisor -> 质量门 -> 结果

独立

/prompt-architect [任务] -> 提示 -> 执行