⚡

提示架构师Skill prompt-architect

这是一个基于Claude 4.x最佳实践的提示生成技能，用于将用户需求转化为结构化、可执行的提示，优化AI交互效果。关键词：提示工程，Claude AI，提示生成，最佳实践，Nate B. Jones，Contract-Style模板，AI应用。

AI应用 0 次安装 0 次浏览 更新于 3/18/2026

name: prompt-architect description: | 基于Claude 4.x标准（2025年12月）将需求转化为最佳实践提示。

基础来源：

  • Nate B. Jones 的4个初学者步骤：Shape, Context, Silent Plan, Self-Check
  • Anthropic Claude 4.x 最佳实践：Explizitheit, Contract-Style, Examples beat Adjectives
  • Pipelines over Prompts 哲学

自动激活于clarify-spec之后或使用/prompt-architect命令时。 生成结构化、可执行的提示，包含所有最佳实践。 triggers:

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

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

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

来源：

  • Nate B. Jones Prompting Playbook 2025
  • Anthropic Official Claude 4.x Prompting Guide
  • Claude Code Best Practices

激活方式

自动于clarify-spec之后

当clarify-spec生成JSON输出后，prompt-architect可以将此JSON转化为结构化提示。

手动使用触发器

/prompt-architect [任务描述]

4个初学者步骤（Nate B. Jones）

步骤1：定义输出形状

不要：写好的代码 而要：生成包含接口X的TypeScript文件，导出函数Y

定义具体产出物：

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

步骤2：提供最少但充分的上下文

步骤3：建议一个无声计划

  • Claude应在回复前内部计划
  • 对于Claude 4.5：先考虑你的方法
  • 在禁用Extended Thinking时避免think步骤

步骤4：添加快速自检

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

Claude 4.x 特定模式

明确性 + 修饰符

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

上下文 + 动机（解释原因以说明内容）

不要：永远不要使用省略号 而要：你的回复将通过TTS朗读，所以永远不要使用省略号，因为TTS无法发音。

示例优于形容词

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

XML标签用于结构

<output_structure>, <constraints>, <verification>

不确定性许可

如果不确定，明确说明并提问。 大大减少幻觉。

Contract-Style模板

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

—BEGIN GENERATED PROMPT—

角色和目标

你是：[基于任务类型的角色，例如高级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]？ [ ] 是否未修改禁止修改区域？

—END GENERATED PROMPT—

工作流程

步骤1：分析输入

接受：

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

步骤2：自动收集上下文

步骤3：填充模板

用以下内容填充Contract-Style模板：

  • 基于任务类型的角色（前端、后端、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？ [ ] 错误处理是否覆盖网络故障？

Token效率

生成的提示优化于：

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

集成

与clarify-spec

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

与/supervisor

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

独立

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