conventions-codex
面向 OpenAI Codex CLI 制品编写与评分的约定叠加层,覆盖 .codex/config.toml、.codex-plugin/plugin.json、.agents/skills/ 布局、钩子事件、AGENTS.md 等规范,供评分器与检查器在校验 Codex 类制品时使用。
找到适合任务的 Agent Skill,阅读介绍并复制安装命令。
更新于 11-20 00:12
41,968 个结果
面向 OpenAI Codex CLI 制品编写与评分的约定叠加层,覆盖 .codex/config.toml、.codex-plugin/plugin.json、.agents/skills/ 布局、钩子事件、AGENTS.md 等规范,供评分器与检查器在校验 Codex 类制品时使用。
介绍如何设计和构建 Claude Code 等工具的插件:架构选择、产物类型(命令、智能体、技能、钩子)、文件结构、plugin.json 清单配置、共享片段、测试与市场发布流程,并总结常见错误。
关于如何编写 Claude Code 项目 .claude/rules/ 规则的指南,用于创建、改进或审查项目规则。涵盖规则格式、正面表述、可执行性、篇幅预算、路径范围、冲突预防等要点。
中文代码审查规范技能,帮助国内团队在保持专业严谨的同时,用符合团队文化的方式给出有效反馈。核心原则是用「建议」代替「命令」、用「提问」代替「否定」,但不因面子放过 bug。提供分级标注([必须修复]、[建议修改]、[仅供参考]、[问题])、审查评论模板、中英混排代码注释规范、Commit Message 中英双语格式、常见反模式与对策,以及审查流程建议和检查清单。
中文 Git 提交规范,基于 Conventional Commits 1.0.0 针对中文团队适配,规定 type 用英文关键字、scope 与 description 用中文,提供 commit message 模板、Subject 与 Body 编写规则、Breaking Changes 标注、Issue 关联格式,并给出 changelog 自动生成、commitlint、husky + lint-staged 与交互式提交的配置示例,帮助国内团队落地统一提交规范与 changelog 自动化。
用于开发工作收尾的技能:在实现完成且测试通过后,通过“验证测试→展示选项→执行选择→清理”的流程,引导用户选择本地合并、创建 PR、保持现状或丢弃分支,并处理分支与工作树清理。
一款面向 AI 编码助手的工作流技能:在当前会话中执行包含独立任务的实现计划时,为每个任务分派全新子智能体,并按“先规格合规、后代码质量”两阶段审查,以减少上下文污染、提升实现质量与迭代速度。
一套测试驱动开发(TDD)技能规范,要求在任何功能实现或 Bug 修复前先编写失败测试,遵循红-绿-重构循环。包含铁律、验证步骤、常见借口反驳与检查清单,适用于新功能、Bug 修复、重构与行为变更。
这是一个用于在 Git 仓库中创建隔离工作树的技能,适用于需要开始与当前工作区隔离的功能开发,或在执行实现计划之前使用。它通过系统化的目录选择和安全验证来建立可靠的隔离环境。核心流程包括:按优先级检查现有目录(.worktrees 优先于 worktrees)、检查 CLAUDE.md 中的偏好设置、必要时询问用户选择项目本地或全局位置;对项目本地目录必须验证已被 gitignore 忽略,否则先修复再继续;然后检测项目名并创建带新分支的工作树、自动检测并运行依赖安装、验证基线测试通过并报告位置。技能强调遵循目录优先级、始终验证忽略状态、自动检测项目设置、验证测试基线,并明确列出了不应跳过忽略验证、不应假设目录位置、不应带着失败测试继续等红线。
「完成前验证」是一个用于约束 AI 编码代理行为的技能规则,核心要求是在宣称工作完成、已修复或测试通过之前,必须先运行验证命令并确认输出,用证据支撑结论。它给出了一套门控流程:确定能证明结论的命令、完整执行、阅读完整输出与退出码、判断输出是否支持结论,最后才做出陈述。技能还列出了常见失败模式(如用旧结果代替新验证、用 linter 通过代替构建成功、信任代理的成功报告)、需要停下来的红线信号,以及针对各种借口的反驳。适用于提交代码、创建 PR、标记任务完成、进入下一任务或委派代理之前。
compose-next 是一个用于多步骤功能开发、缺陷修复或重构的端到端工作流技能,将需求澄清、工作区准备、功能文档、实现、验证、评审、定稿和收尾串联为一个紧凑流程。它以功能文档(docs/compose/spec/)承载设计、任务与交付证据,默认在 .worktrees/{{slug}} 创建链接工作树,并通过独立评审子代理检查变更。该技能仅在用户明确要求时进入,未明确请求时不应推断同意。
用于回答 Effect(TypeScript 框架)相关问题的技能,要求先克隆 Effect 源码仓库并借助 explore agent 检索,基于真实源码而非记忆作答。
这是 WTF 技能集中的一项技能,用于将特性(Feature)的 Trace 计划转化为一组 Trace 事项(issues)。它适用于用户想要规划并创建某个特性的完整 Trace 集合时,例如输入“规划所有 traces”或“创建……的 traces”。该技能会先检查 GitHub CLI 配置,解析规划模式,读取特性及其 Trace 状态,验证现有 Trace 计划并填补空缺,或在计划缺失时从用户故事和 Gherkin 场景推导出计划,然后按计划顺序创建 Trace 事项并建立子事项与阻塞关系。它强调计划与场景以特性正文为权威,不按层切片,并支持引导模式与流程模式。
xingyu 是一套主观的工具链与 JavaScript/TypeScript 项目约定技能,用于统一新项目搭建、代码组织、类型与注释规范、测试写法以及工程工具选型。其核心内容包括:代码组织上强调单一职责、大文件拆分、类型集中到 types.ts 或 types/*.ts、常量提取到 constants.ts;运行时优先编写同构代码,环境特定代码需在文件顶部用 // @env node 或 // @env browser 标注;TypeScript 要求显式返回类型、避免复杂内联类型;注释强调解释“为什么”而非“怎么做”;测试基于 Vitest,测试文件与源文件同目录命名(foo.ts → foo.test.ts),使用 describe/it 而非 test,复杂输出用 toMatchSnapshot,语言相关快照用 toMatchFileSnapshot 指定路径。工具链采用 @antfu/ni 命令(ni、nr、nu、nun、nci、nlx 等),ESLint 使用 @antfu/eslint-config,Git 钩子使用 simple-git-hooks 与 lint-staged,pnpm 使用命名 catalog 管理依赖版本。适用于新项目初始化、ESLint/Prettier 替代方案配置、monorepo、库发布,或当用户提到 xingyu 偏好时。
adr 是一个用于管理架构决策记录(Architecture Decision Record)的技能,由 xobotyi/cc-foundry 提供。它在 design-docs/adr/ 下创建、重写、合并和删除 ADR 文件,并维护始终加载的索引 design-docs/ADR.md。每份 ADR 记录当前生效的决策规则、规则成立的理由、代价、已放弃的选项以及重新开启该决策的条件。主要读者是即将修改受该决策约束代码的智能体,因此当前规则置于首位,被替换的内容不再保留。ADR 按 <group>.<n>-<topic>.md 命名,从模板创建,包含 Header、Summary、Decision、Why、Consequences、Rejected、Revisit if 和 History 等部分,并限制正文篇幅。索引汇总所有 ADR,可导入项目的 CLAUDE.md。适用于需要长期追踪架构决策的编程项目。
xrk-botutil 是面向 Bot 开发的“基础设施工具箱”,用于在业务代码中统一复用日志、缓存、文件、网络与批处理等基础能力。它提供日志相关方法(makeLog、makeLogID)、缓存方法(getMap、cache)、文件操作(readFile、writeFile、fileToUrl)、命令与异步控制(exec、promiseEvent、sleep),以及时间、大小格式化等工具函数。Bot 通过代理透传 BotUtil 的静态方法,例如 Bot.makeLog、Bot.fileToUrl、Bot.exec、Bot.promiseEvent。该工具还提供跨平台桌面用户目录解析(getDefaultDesktopDirSync / resolveUserDesktopDirAsync),供 BaseTools、tools/desktop 等工作流复用,避免写死 ~/Desktop。推荐优先使用这些封装方法,而不是在业务代码中直接使用 fs、fetch、child_process,以保证行为统一、可观测。适用场景包括为新模块选择合适的工具函数、定位子系统实现路径与配置入口、评估改动落点与兼容性;不适用于替代其他子系统的实现说明,也不应在缺少证据时臆造路径或字段。
xrk-crawl 是面向开发者的网页抓取与受控浏览器统一入口模块,用于开发或排查 HTTP 抓取、SSRF 防护、Playwright 受控浏览器以及本地字体增强截图,并帮助判断 web_fetch 与 browser 工作流的选型。模块以 lib/crawl/index.js 作为唯一对外入口,业务代码、插件和 stream 均从该文件导入。HTTP 抓取侧提供 fetchWithPolicy(经通用 HTTP fetcher 导出,支持超时、重试、代理)、runWebFetch(正文提取、Readability、Firecrawl)以及 MCP web_fetch 流程;浏览器侧提供 PlaywrightAgentSession,支持启动、自动关闭、SSRF 校验导航、gotoAndCapture 一步完成准备—导航—等待—截图、区域截图与区域文本读取;截图增强方面提供 createLocalFontScreenshotHelper,用于让截图字体与样式贴近线上效果。SSRF 防护由 ssrf-guard.js 统一提供,HTTP 与 Playwright 导航共用同一校验逻辑。
xrk-docs 是 XRK-AGT 项目的文档导航技能,用于在用户询问「某功能在哪配置、在哪修改、如何接入」时,快速给出最短路径,包括配置路径、代码文件和对应文档。它以 docs/README.md 为文档导航入口,覆盖工厂与 LLM、工作流(AIStream)、system-Core 能力、HTTP API 与业务层、鉴权、MCP、可扩展性等主题,并针对常见问题给出具体落点:例如 v3 OpenAI 兼容入口、LLM 运营商选择字段、工作流扫描规则、LLM 配置文件、前端表单 Schema、鉴权职责与 HTTP 统一响应等。回答规范要求配置类问题给出配置文件路径、关键字段与最小示例,行为类问题给出代码入口路径与函数/类名;文档与代码不一致时以代码为准,并注明需修订的文档路径。适用于定位子系统实现路径与配置入口、确定改动落点与兼容性注意事项,不替代其他子系统的实现说明,也不在缺少证据时臆造路径或字段。
xrk-http-api 是 XRK-AGT 的 HTTP/API 层专家技能,用于开发或排查 HTTP API(core/*/http/*.js),帮助理解 HttpApi 基类、ApiLoader、路由实现与业务层约定。它可回答“怎么加新接口”“为什么 handler 里看不到鉴权”“某路由在哪里实现”等问题,并给出代码路径、配置入口、关键字段以及风险点、验证步骤与回归范围。核心约定包括:API 模块放在 core/*/http/*.js,导出对象或继承 HttpApi;路由数组 routes 声明 method/path/handler/middleware;鉴权由各模块自行决定。响应统一使用 src/utils/http-utils.js 中的 HttpResponse,提供 success、error、validationError、notFound、unauthorized、forbidden、asyncHandler、streamResponse 及 MCP 的 jsonRpcError/jsonRpcSuccess/validateJsonRpcRequest 等方法;handler 内应 return HttpResponse.xxx 提前返回,不与 res.json() 混用。
xrk-renderer 是 xrk-agt 项目中的渲染器技能,用于说明和扩展 HTML 模板渲染与截图输出能力,也可在需要让 AI 生成图片报表或可视化时使用。该技能以文档和代码路径为线索,帮助使用者定位渲染子系统的实现与配置入口。根据资料,Renderer 基类只负责模板读写、缓存与监听(dealTpl),具体截图逻辑由 Puppeteer/Playwright 等实现负责;全局配置来源为 agt.browser.renderer,各渲染器配置位于 data/server_bots/{port}/renderers/{type}/config.yaml,缺省时从 src/renderers/{type}/config_default.yaml 合并。典型用法是在插件中通过 RendererLoader.getRenderer('puppeteer') 获取实例,调用 dealTpl 渲染 HTML,再调用 renderImage 输出图片。适用场景包括定位渲染子系统实现路径与配置入口、快速确定改动落点与兼容性注意事项。
xrk-system-core 是 xrk-agt 项目中的系统核心说明技能,用于快速理解 system-Core 子系统所提供的 HTTP API、工作流(Stream)、插件(Plugin)、Tasker、CommonConfig 表单 Schema 与 Web 控制台能力,并定位各模块的具体实现位置。该技能给出权威文档入口 docs/system-core.md、项目概览 PROJECT_OVERVIEW.md,以及 HTTP、Stream、Plugin、Tasker、CommonConfig、Web UI 的目录约定与常用定位(如 v3 Chat Completions 位于 core/system-Core/http/ai.js,配置管理 API 位于 config.js,MCP API 位于 mcp.js,控制台入口位于 www/xrk/)。其用途偏重于代码考古与改动落点分析:先确认需求是否属于该子系统职责边界,再给出代码路径、配置路径与关键字段,最后补充风险点、验证步骤与回归范围。适用于需要定位实现路径与配置入口、快速给出改动落点与兼容性注意事项的场景;不适用于替代其他子系统说明,也不应在缺少证据时臆造路径或字段。
该技能用于根据 GitHub 提交历史生成并整理 rippled 版本的发布说明草稿,将条目归入 Amendments、Bug Fixes 等正确小节,并按发布说明格式重新排版。
claude-skill-review 是一个用于审查 Claude Code 技能(SKILL.md)质量的技能,依据官方最佳实践进行评审。当 PR 中包含 SKILL.md 文件,或被要求检查技能质量,以及创建新技能时进行自我评审,都可以使用它。它通过一系列步骤检查技能质量,包括:前端元数据(frontmatter)验证(如 name 是否必需、长度不超过64字符、只含小写字母数字和连字符、无保留字;description 是否必需、非空、不超过1024字符);description 质量(必须说明做什么和何时使用,建议用第三人称、包含具体关键词);目录结构(分发用技能应放在 {domain}/skills/{skill-name}/ 下,命名应使用 kebab-case,推荐动名词形式);SKILL.md 正文质量(建议不超过500行、含示例、有明确工作流、术语一致、省略常识);引用文件检查(引用文件须存在、嵌套不超过一层、长文件有目录、使用正斜杠路径);并检测应避免的模式(如时效性信息、并列过多选项、提示注入漏洞、深层嵌套引用、Windows 风格路径)。最终按10分制评分并输出包含 frontmatter、目录结构、正文、引用文件、检测问题表格的固定格式报告。具体安装命令、代码示例、官方文档链接、许可证与价格信息暂未提供。
用于 Flow2API 多模态生成的技能,支持文生图、图生图(OpenAI 兼容与 Gemini 原生)、文生视频、首尾帧视频等,需通过内置 CLI 调用而非直接请求 HTTP API。