这个项目能做什么

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前置元数据对齐,编写与工具无关的指令,重新生成技能,更新指南和工作流,为捕获失败的提示添加夹具,并通过完整性检查。