PromptingCraft Guidance

PromptingCraft.com

网站：promptingcraft.com

产品的公开名称为 PromptingCraft.com。自 0.3.0 起，技能和插件标识符为 promptingcraft（此前为 promptcraft）；请参阅迁移说明。

将开发讨论转化为新编码 Agent 可执行的提示词。PromptingCraft.com 会保留任务约定，查阅适用的官方指南，起草提示词、评议一次，并在必要时修订，然后检查需求和权限是否得到保留。编写提示词的助手和执行提示词的 Agent 可以不同。目标：Claude Code 和 OpenAI Codex；也支持将 Cursor 作为目标 Agent（请参阅在 Cursor 中使用）。当前源代码树中的独立 Skill 版本为 0.4.0。其插件包是单独的 0.4.0 升级候选版本；已发布的 ChatGPT 插件仍为 0.3.0，且该候选版本尚未发布，也未获批准取代现有版本。现有的远程指南 MCP 服务报告版本为 0.3.0；它是独立的服务。

不可变的 v0.1.0 标签仍是历史源代码发行版本；它不会被独立的 ChatGPT 插件取代。此分支包含尚未发布的指南、兼容性和软件包变更。最新的约定保真度样例在此前出现诊断差异后，发现 0/14 项存在实质性偏差；这并非保证。原生 Codex 调用已通过验证。ChatGPT 原生激活和下游效果更优仍未经验证。开发 CI 归档不能取代 v0.1.0 发行资产。

当原始任务已经足够合适时，PromptingCraft.com 可以返回： “原始提示词已经足够合适。无需进行实质性修改。” 它会保留原始文本；即使不作修改，仍需检查约定和来源。

它有助于生成可用的交接内容；但无法提供缺失的访问权限、授权、代码库证据，也无法保证下游结果正确。

规范源代码库：GitLab。 也提供可供浏览和安装的公开 GitHub 镜像。GitLab CI 具有权威性；GitHub Actions 未启用。可在任一平台提出贡献；变更通过规范的 GitLab 项目集成。

发布消息

PromptingCraft.com 已发布于 ChatGPT 插件目录，其可选的指南 MCP 已列入官方 MCP Registry。这两项已发布服务的版本均为 0.3.0；当前源代码树中的独立 Skill 版本为 0.4.0。请阅读发布公告，了解安装、功能和验证详情。

两种使用方式

将 PromptingCraft 用作独立的 Agent Skill，或连接其 MCP 服务，以结构化方式访问官方 AI 开发者指南。

	独立 Agent Skill	Skill + MCP 服务
安装内容	skills/promptingcraft/（说明和标注日期的参考资料）	插件：同一 Skill 加上 mcp.json
宿主	Codex、Claude Code 和 Cursor（本地 Skill 文件夹）	可加载该插件 MCP 服务的宿主；已在 Codex 中验证
提示词编写（约定、草稿、评审、定稿、不作更改）	是	是，使用相同的 Skill
官方指南	附带精选参考资料并标注日期；如果宿主支持，则使用宿主自带的文档搜索或浏览功能	还提供 search_guidance 和 get_guidance：包含来源信息和适用性的记录
时效性	只有当宿主在本次运行中实际读取官方页面时，才是实时内容；否则会标注为有日期的缓存内容	check_source_freshness 会将某个官方页面与其已验证的快照进行比较（缓存时间最长为 15 分钟）
网络	无需网络	通过 HTTPS 访问 https://mcp.promptingcraft.com/mcp（仅限固定类别和 ID；参见隐私）
指南检索失败时	使用附带的参考资料，并说明这一点	说明服务不可用，然后使用其他官方来源或附带的参考资料

MCP 服务是可选的。它提供依据，而非权威：Skill 仍会提取约定、起草、评审并定稿；用户的要求和权限始终优先。两种模式都不能保证文档实时更新：附带的参考资料会注明检索日期；时效性检查只能显示页面自上次验证以来是否发生变化。promptingcraft_methodology 类型的记录是 PromptingCraft.com 自身的方法，不代表服务提供商的建议。服务详情：参见 mcp/README.md 和数据边界。

一个简短示例

请求：“编写一项 Codex 任务：API 出错后，保存操作仍显示成功。保留 API 结构；不要部署。”

草稿：“修复保存问题并运行测试。”

评审：草稿遗漏了问题现象、API 约束和部署边界。

定稿：

Fix Save so an unsuccessful API response is not reported as success. Preserve
the API shape. Locate the existing save path and verify the requested failure
behavior. Do not deploy.

Optional suggestion: use the existing error-display pattern if one is available.

这是原创示例，不能证明执行效果有所提升。参见完整示例和评估协议。

在 ChatGPT 中使用

PromptingCraft.com 插件包含该 Skill，并声明一个可选的远程 MCP 服务（指南服务，无需账户或凭据）。构建一次本地源代码，注册真实的仓库根目录，然后通过受支持的 Codex 或 ChatGPT Desktop 插件控制项进行安装。参见准确的本地安装和 ChatGPT 操作流程。 安装后，开始新聊天；使用 @ 明确选择 PromptingCraft.com，或询问 “为这项任务准备一条 Codex 提示词。” 它会使用已有讨论内容，并以一个可复制的代码块返回最终执行提示词。

当前 OpenAI 文档支持在 Chat 中使用插件，但本地源代码和账户的可用性各不相同。Codex CLI 安装已单独验证，与 ChatGPT Desktop 和普通 Chat 激活分开。Computer Use 在此环境中无法访问 ChatGPT；这些原生检查仍是有文档记录的所有者侧准入条件。受支持的安装流程不包括反复粘贴或上传 SKILL.md。 如果检索不可用，来源指南仍会标注为有日期或不可用。

安装独立 Skill

在希望 Claude Code 使用该 Skill 的项目中，使用 skills CLI 安装当前的 公开 GitHub 源：

DISABLE_TELEMETRY=1 npx -y [email protected] add revanbcn/promptingcraft-skill --skill promptingcraft --agent claude-code --copy --yes

这会将仓库当前默认分支中的独立 Skill 安装到项目的 .claude/skills/promptingcraft/。该分支包含 Skill 版本 0.4.0；随着仓库更新，版本可能会变化。此命令会退出 CLI 遥测，并使用 CLI 的非交互式复制模式。安装不会启用 Skill，也不会安装可选的远程 MCP 服务。要使用 Skill，请启动新的 Claude Code 会话，并使用你的提示词编写请求调用 /promptingcraft。

如需获取历史版本，请从 GitLab v0.1.0 下载 v0.1.0 Skill 压缩包和 SHA256SUMS。 提取前请验证校验和。目前尚无 0.2.0 版本；克隆仓库可获取当前候选版本：

git clone https://gitlab.com/revanalex/promptingcraft-skill.git
cd promptingcraft-skill
python3 scripts/install_skill.py --host codex --project-dir /path/to/your/project
# Or, for Claude Code:
python3 scripts/install_skill.py --host claude --project-dir /path/to/your/project
# Or, for Cursor:
python3 scripts/install_skill.py --host cursor --project-dir /path/to/your/project

可选安装程序需要 Python 3.11+，会拒绝已存在的目标目录，并且只会操作明确指定项目的 Skill 目录。你也可以自行将解压后的 promptingcraft/ 目录连同其中所有参考资料和许可证复制到 .agents/skills/（Codex）、.claude/skills/（Claude Code）或 .cursor/skills/（Cursor；Cursor 也会读取 .agents/skills/）。 如果发现结果尚未刷新，请重启宿主。在 Codex 中调用 $promptingcraft；在 Claude Code 中调用 /promptingcraft，然后描述你需要的提示词。 此 Skill 不会执行任何开发任务。

在 Cursor 中使用

Cursor 会从项目中的 .cursor/skills/ 或 .agents/skills/，以及用户的 ~/.cursor/skills/ 读取 Agent Skills。插件根目录（包含使用 Agent Plugins 1.0.0 架构的 plugin.json 和 skills/promptingcraft/）遵循 Cursor 文档所述的 Agent Plugins 格式；尚未提交给 Cursor Marketplace，也未经过其审核。

当执行器是 Cursor 时，PromptingCraft.com 会加载其 Cursor 说明：在 Auto 模式下，底层模型会被视为未知，因此除非已确定所选模型，否则不会应用 Claude、GPT 或 Composer 的提示词规则。

根据 Cursor CLI 中的测量结果（Cursor 激活评估）： 使用默认 Auto 设置（显示为 Composer 2.5 Fast）时，该 Skill 可用，但不会自动激活（0/30 个提示词请求）；明确提及它，例如 “使用 promptingcraft skill 为此任务准备一个 Cursor 提示词”，即可加载 Skill，成功率为 2/2（使用 0.2.0 标识符测量，并使用 promptingcraft 重复测量）。 在编辑器中，你也可以从 / 菜单中选择它。激活情况取决于所选模型。尚未测试在 Cursor 编辑器中加载插件。

插件包

插件 ZIP 包含根目录的 plugin.json（使用 Agent Plugins 1.0.0），一个 skills/promptingcraft/ 目录树、assets/ 下的列表图标/标志，以及 Claude Code 兼容性清单；还包含一个声明可选指导 MCP 服务的根目录 mcp.json。 其中未声明任何钩子或凭据。 验证器会检查其 ChatGPT 列表元数据（显示名称、描述、网站、支持信息、 隐私与条款 URL、品牌颜色和图标）。 现有的 0.3.0 插件已发布；此 0.4.0 候选版本尚未提交审核。在 Claude Code 中，仅限会话的加载方式如下：

claude --plugin-dir /path/to/extracted/promptingcraft-plugin
# In that session: /promptingcraft:promptingcraft

仓库已包含供 dondego-local 使用的 .agents/plugins/marketplace.json。 注册前，请准备好实际的插件目录：

python3 scripts/prepare_marketplace.py
python3 scripts/validate.py --marketplace

生成的 dist/promptingcraft-plugin/ 来自规范 Skill，并由现有的可复现压缩包构建器生成。 它是一个快照，而不是另一个需要维护的 Skill。目录会根据仓库根目录解析其路径。请参阅 安装、刷新和移除。

验证与时效性

python3 -m unittest discover -s tests -v
python3 scripts/validate.py
python3 scripts/package.py --output dist
python3 scripts/prepare_marketplace.py
python3 scripts/validate.py --marketplace
# Optional live maintenance, kept separate from merge checks:
python3 scripts/freshness.py --output /tmp/promptingcraft-freshness --write-baseline

常规检查具有确定性、可离线运行，并使用合成文档。实时来源检查会比较可用的规范化内容哈希，使用来源提供的 HTTP 验证器，并从官方索引中发现候选链接。检查会报告已更改、未更改、新增、缺失／不可用以及部分／错误状态。这些检查既不能证明指南正确，也不会自动更改技能。抓取时间不等于发布时间。缓存和原始模型跟踪记录不会纳入受版本控制的内容；报告包含元数据，而非整份提供方文档。

请参阅时效性操作与排期门槛、已验证的来源决策、实际验证和有范围限制的路线图。如果宿主网络功能允许，技能使用期间会重新验证来源指南；离线说明永远不是最新的。

范围与许可证

原创内容采用 MIT 许可证。与 OpenAI/Anthropic 无官方关联，亦未获其认可。v0.1 或 0.2.0 候选版本中不包含托管应用、遥测、注册、模型路由器、API 计费、市场提交、部署或自动重写指令。 请参阅 LICENSE、CONTRIBUTING、SECURITY 和 CHANGELOG。

由 dondego.com 团队开发。