1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | prompt-architect | GitHub 独立仓库名 |
| 作者/维护者 | Charles Kelsoe（ckelsoe，个人开发者） | GitHub API |
| 来源链接 | https://github.com/ckelsoe/prompt-architect | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 254 / 31 | GitHub API（认证取数） |
| 最新版本 | v3.5.0（正式 GitHub Release） | GitHub API |
| 安装方式 | npx @ckelsoe/prompt-architect 交互式多 Agent 安装器 |
官方 README |
2. 功能介绍与亮点
prompt-architect 是一个纯提示词工程技能：围绕 7 类意图（创建、转换、推理、批判、还原、澄清、agentic）匹配 31 种命名提示框架（CO-STAR、RISEN、TIDD-EC、Chain of Thought、Tree of Thought、Self-Refine 等），先按清晰度、具体性、上下文、完整性、结构五个维度给原始提示打分，再引导式提问补全缺失信息，最终产出结构化的高质量提示词，并给出改写前后的分数对比。
核心亮点：① 覆盖面广——31 种框架分属 7 大类意图，从简单的一次性提示到 agentic 工具调用场景均有对应框架，而非只服务单一任务；② 安装体验成熟——npx 交互安装器会自动探测本机已安装的 Claude Code、Gemini CLI、Windsurf 等工具并让用户勾选安装目标，也提供 ~/.agents/skills/ 通用路径覆盖遵循 Agent Skills 规范的其他工具；③ 维护活跃——采用正式 GitHub Release 流程，最新 v3.5.0 于近日发布，且历史提交频率高，非一次性发布后弃置；④ 无外部依赖——SKILL.md 明确声明“不需要任何外部依赖”，本身是纯文本规则文件，不需要 API Key 或联网服务。
3. 适用场景
固定分类：元技能与 Agent 增强
面向所有需要频繁向 Claude Code、Codex 等编码 agent 或 ChatGPT、Gemini 等对话模型下达指令、但常常因提示写得模糊而要反复重来的用户：包括希望系统性学习提示工程方法论的开发者、需要为团队规范化提示写法的技术负责人，以及单纯想减少“来回澄清需求”轮次的日常用户。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 安装器内置专属探测与安装分支（检测 ~/.claude 目录，写入 ~/.claude/skills/） |
| Codex | 支持（通用路径） | 官方文档与安装器帮助文本明确列出 Codex 通过 ~/.agents/skills/ 通用 Agent Skills 标准路径覆盖，非专属安装分支 |
| OpenClaw | 未验证 | 已抓取的 README 与安装脚本均未点名 OpenClaw |
| Hermes Agent | 未验证 | 同上，公开材料未提及 |
5. 推荐理由
系统性覆盖 31 种命名提示工程框架、按七类意图自动匹配，配合改写前后量化打分与引导式澄清对话，安装体验成熟（自动探测多个 agent 并一键安装），且技能本身无代码执行、无外部依赖，安全风险极低。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 254 stars、31 forks；npm 包过去一月约 525 次下载，说明存在真实使用，规模不大且未检索到独立于项目自身的第三方讨论 |
| 可用性 | 9 | npx @ckelsoe/prompt-architect 一次运行即可自动探测并安装到多个 agent；SKILL.md 长达 27KB，31 种框架逐一说明用法与适用场景；已发布正式 GitHub Release v3.5.0（2026-07-22），此前近一周内仍有多次提交；运行不依赖任何外部服务或付费订阅 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 安装脚本仅用 which/where 探测本机是否装有 Gemini CLI 等工具，用于决定安装目标；技能运行本身（SKILL.md 正文）不含任何 shell 调用 |
| ② 运行时联网外发 | 无——已抓取安装脚本全文，未发现任何网络请求代码 |
| ③ API Key/凭据 | 不需要；SKILL.md frontmatter 明确声明无外部依赖 |
| ④ 可疑指令排查 | 已抓取 SKILL.md 全文与安装脚本，未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | 个人开发者出品，非官方机构；仓库公开透明，无刷星迹象 |
| ⑥ License | MIT，条款清晰 |
| ⑦ 最近维护 | 近日仍有多次提交与正式 Release，维护活跃 |
纯提示词/模板类技能，无代码执行、无外联，安装脚本唯一涉及的本地命令仅用于环境探测，检查清单各项结果良好；作者为个人开发者而非官方机构，故未给满分。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| prompt-master（nidhinjs/prompt-master） | 按目标工具（Claude、GPT、Midjourney 等 30 余种）匹配对应提示习惯，产出可直接使用的最终提示 | 以“目标工具”为分类维度；prompt-architect 以“命名提示框架”（CO-STAR、RISEN 等 31 种）为分类维度，更强调方法论本身的可迁移性，并提供改写前后量化打分 |
| promptfoo-evals（promptfoo/promptfoo） | 为已有的提示词与 RAG 流水线生成回归测试配置与断言 | 定位是提示词写好之后的“测试评估”环节；prompt-architect 定位是提示词写之前/写的过程中的“生成改写”环节，两者服务同一工作流的不同阶段 |
核心差异化：多数同类技能围绕“该用哪个工具的措辞习惯”展开，prompt-architect 是少见的、以命名提示工程框架体系为核心方法论、并配套量化打分与引导式澄清对话的通用型方案。
8. 用户评价
该技能目前在 GitHub Issues 之外的第三方平台尚无检索到具名用户评价；仓库自身 Issues 中有一条外部用户提交的文档修正记录，另有一条来自第三方技能目录网站的收录通知。
9. 其他补充
仓库采用正式 GitHub Release 流程记录版本历史，同时提供 npm 包分发（@ckelsoe/prompt-architect），过去一个月下载量约 525 次；adapters/ 目录内含针对 Windsurf 等工具的专属适配说明文档。
10. 安装使用方式
方式一：交互式安装（推荐）
npx @ckelsoe/prompt-architect安装器会自动探测本机已安装的 Claude Code、Gemini CLI、Windsurf 等工具，交互式选择安装目标。
方式二：安装到全部检测到的 agent
npx @ckelsoe/prompt-architect --all方式三：仅安装到 Claude Code
npx @ckelsoe/prompt-architect --claude安装后注意事项：无需重启，安装完成后直接用自然语言提出“帮我改写这个提示”“这个提示该用什么框架”等请求即可自动触发；再次运行安装命令会覆盖已安装版本，便于升级。
11. 注意事项
- 本技能只输出提示词文本本身，不代替用户执行后续任务
- 作者为个人开发者，非官方机构出品，长期维护取决于个人持续投入
- OpenClaw、Hermes Agent 的兼容性在已抓取的公开材料中未见点名说明，标记为未验证；技能遵循通用 Agent Skills 规范，理论上可手动适配，但未经证实