这个项目能做什么
Jules Prompts是一个精选的机器可读任务提示、Agent Skills和植入失败夹具库,专为编码代理设计。该名称具有历史意义;其指令与具体工具无关,不依赖于任何特定产品,如Jules、Claude Code、Codex或Cursor。
该仓库按多个层次组织:
- `_prompts/`:规范程序文本,包括网站、JSON索引和MCP斜杠命令。
- `skills/`:相同文本格式化为Agent Skills,由`_prompts/`生成,可直接复制到`.claude/skills/`或`.agents/skills/`。
- `fixtures/`:带有植入缺陷的微型仓库,用于演示技能如何失败。
- `plugin/`:整个库作为可安装包,包含清单、技能和斜杠命令。
- `library.json`:每个程序、类别和层级的机器可读列表。
所有生成的输出在CI中逐字节检查,确保与源保持同步。添加新的输出格式只需在`scripts/emit.py`的`TARGETS`列表中添加一个条目。
程序被分类为`core`,除非标记为`status: legacy`。核心程序针对代理实际遇到的失败,而遗留程序是2025年以来的通用任务文本,仍然有用,但并非本库的独特之处。
该库在`harness/AGENTS.md`中包含`AGENTS.md`的常设规则,以确保在未选择技能时触发。
入门指南在`PROMPTS_GUIDE.md`(解释每个提示和推荐顺序)和`ENVIRONMENT_SETUP.md`(准备仓库以供代理克隆、安装和测试)中提供。
使用选项包括:
- 作为Agent Skills:将技能目录复制到`.claude/skills/`,并将`harness/AGENTS.md`粘贴到项目的`AGENTS.md`中。
- 作为MCP服务器:在`mcpServers`中配置服务器,将提示作为斜杠命令暴露在Claude Code、Claude Desktop、VS Code/Copilot Chat、Windsurf和Zed中。服务器实时读取仓库,`<PR_URL_OR_DIFF_RANGE>`等占位符作为参数暴露。
- 供人类使用:复制YAML前置元数据后的提示文件正文,粘贴到代理的指令输入中。
- 供代理使用:获取`https://jules-prompts.wecanuseai.com/prompts.json`,按标题/描述/类别选择提示,并从其URL获取渲染后的提示或读取`_prompts/<slug>.md`。
- 针对夹具:使用`python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md`对夹具评分,判定为holds/broken/skipped,并附带覆盖率行。
贡献指南强调仅添加未覆盖的重复任务提示,保持YAML前置元数据对齐,编写与工具无关的指令,重新生成技能,更新指南和工作流,为捕获失败的提示添加夹具,并通过完整性检查。
评论
0 评分人数达到10人后显示
登录后参与讨论。