【项目自荐】Agent System Prompt Architect v0.1：让 AI Agent 更稳定地编写系统提示词的 Skill

发现频道
, ,
1

软件名称

Agent System Prompt Architect Skill

应用平台

  • Windows
  • MacOS
  • Linux
  • 在线服务

推荐类型

【开发者自荐】

一句简介

一个帮助 Codex / Claude Code 风格 Agent 编写可部署系统提示词的 Skill。

应用简介

Agent System Prompt Architect 是一个面向 AI Agent 开发者的 Skill，用于让 Codex / Claude Code 风格的 code agent 帮你为其他 agent 项目生成更稳定、更可部署的 system prompt。

起因是我在用 Codex 写 agent 项目时，经常遇到它生成的系统提示词质量不稳定，比如：

  1. 根据项目名、品牌名乱推角色；
  2. 把工具能力写成不存在的 API；
  3. 把 schema 字段、class 名、上下游管线词直接塞进 system prompt；
  4. 生成过长、重复、不可部署的提示词；
  5. 缺少对领域、工具、证据、输出格式和失败处理的判断标准；
  6. 输出最终 prompt 前夹带"设计说明""供你审阅"等非部署内容。

这个 Skill 的目标不是让 Agent 写一段"看起来很完整"的提示词，而是让它生成可以直接放进 system message 的系统提示词。

主要能力：

  1. 生成可直接部署的 Agent System Prompt；
  2. 设计清晰的角色、任务范围、非目标和失败处理；
  3. 区分"语义工具能力"和"真实运行时工具规格"；
  4. 没有真实工具 schema 时，不虚构 API、参数或返回字段；
  5. 处理资料来源、检索、引用、证据冲突和不确定性；
  6. 应用 prompt engineering 原则，例如具体指令、正向引导、格式示例和可衡量成功标准；
  7. 按需选择 few-shot、reasoning policy、ReAct-style tool use、retrieval grounding 等提示技术；
  8. 写完初稿后用 evaluation 清单检查、压缩和修正。

这次 v0.1 更新内容：

  1. README 改为中文项目首页，补充适用场景、核心问题、安装方式、使用示例、评估结果和设计思路；
  2. 新增 .codex/INSTALL.md，包含 macOS / Linux / Windows 的安装、验证、更新和卸载步骤；
  3. 新增 test/ 评估资产，包括输出质量评估和触发评估；
  4. 新增 MIMO 兼容的自动化 eval runner；
  5. test/README.md 改为中文评估说明；
  6. Skill 正文和 reference 文件仍保持英文，方便 Agent 在运行时稳定理解和执行。

当前内部基准结果：

  • 模型：mimo-v2.5-pro
  • with skill 平均通过率：0.917
  • without skill 平均通过率：0.554
  • 触发评估：14 / 14 通过

目录结构：

skills/agent-system-prompt-architect/
SKILL.md
agents/openai.yaml
references/

test/
evals.json
triggers.json
README.md

scripts/
run_skill_evals.py

.codex/
INSTALL.md

适合人群：

  1. 正在做 AI Agent 的开发者；
  2. 经常让 Codex / Claude Code 帮忙写 agent prompt 的用户；
  3. 想系统化设计 system prompt 的提示词工程爱好者；
  4. 需要处理多工具、RAG、研究、客服、代码执行类 agent 的用户；
  5. 想用 eval 迭代 prompt / skill 的用户。

官方网站