Agentic Awesome Skills 在 Codex CLI 中的安装与使用指南从技能安装到插件集成【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skillsAgentic Awesome SkillsAAS是一个面向 Agent 的本地技能库通过.codex/skills/标准路径为 Codex CLI 提供 2,000 个可复用的任务剧本。本文以仓库中的 Codex CLI 技能文档 为主线结合仓库源码与插件元数据完整讲解如何在 Codex CLI 中安装、验证、调用这些技能并给出从规划、实现、测试到交付的完整提示词工作流。读完本文你将掌握npx agentic-awesome-skills --codex的标准安装、精确筛选安装、仓库本地插件集成以及brainstorming、concise-planning等高频技能的实战用法。Codex CLI 技能为什么选择这个仓库Codex CLI 技能的核心使用场景是本地编码循环中的即插即用你不希望在对话中反复复制粘贴冗长的提示词而是希望把一套经过编排的任务剧本规划、实现、调试、测试、安全审查、交付直接安装到 Codex 的技能目录里然后在提示词中通过技能名的方式一键调用。Agentic Awesome Skills 正是为这一用例设计的它在 Codex CLI 下的典型工作流可以概括为三步使用npx agentic-awesome-skills --codex将技能库安装到 Codex 的技能路径选择一个工作流导向的技能例如brainstorming、concise-planning或test-driven-development要求 Codex 将该技能应用于具体文件、功能、测试或错误修复。选择这个仓库用于 Codex CLI 的核心理由包括原生支持通过专用安装标志--codex和标准技能布局SKILL.md为 Codex CLI 提供一等支持本地仓库内工作技能安装在本地编码环境中可以从规划到实现再到验证全程使用无需修改技能库本身覆盖面广既包含通用工程技能规划、TDD、代码审查也包含深入的专业技能轨道安全、数据、基础设施、移动端等附带文档与捆绑包仓库不仅提供原始技能文件还提供使用文档和编排好的捆绑包bundles方便按主题选择。安装 Codex CLI 技能标准安装命令在终端中执行npx agentic-awesome-skills --codex安装器会从 npm 解析发布版本将技能复制到 Codex 的技能目录。从 安装器源码 可以看到--codex标志的底层逻辑当没有显式设置CODEX_HOME环境变量时技能会被安装到~/.codex/skills如果设置了CODEX_HOME则安装到$CODEX_HOME/skillsif (opts.codex) { const codexHome process.env.CODEX_HOME; const codexPath codexHome ? path.join(codexHome, skills) : path.join(HOME, .codex, skills); targets.push({ name: Codex CLI, path: codexPath }); }这也解释了为什么验证安装同时检查两种路径。精细化的选择性安装安装器支持多种筛选参数在 Codex 场景下同样适用适合只安装当前项目需要的技能子集# 只安装指定技能支持逗号分隔的精确技能名、ID 或嵌套路径 npx agentic-awesome-skills --codex --skills brainstorming,concise-planning # 按风险标签筛选safe、none 等 npx agentic-awesome-skills --codex --risk safe,none # 按分类筛选 npx agentic-awesome-skills --codex --category development # 先预览写入计划不实际安装推荐在任何真实安装前先跑 npx agentic-awesome-skills --codex --skills frontend-design --dry-run需要说明的是--dry-run只会预览每个目标的安装、更新、移除计划不写入任何文件所有技能在安装前会经过静态安全审计安装器会扫描命令执行、网络访问、凭据关键字、文件系统写入、特权操作等信号并生成报告参见 安装器源码 中的AUDIT_PATTERNS每个技能目录都通过SKILL.md声明自身的元数据name、description、risk、source、date_added安装器据此完成筛选与审计。验证安装安装完成后可以通过下面的命令确认技能目录已就位test -d .codex/skills || test -d ~/.codex/skills该命令检查当前目录.codex/skills即仓库/项目级配置或用户主目录~/.codex/skills即全局配置两者之一存在即返回成功。如果命令没有输出且退出码为 0说明技能目录已正确创建。插件风格集成仓库本地 Codex 插件如果更喜欢插件风格的 Codex 集成仓库提供了完整的本地插件元数据无需经过 npm 安装流程市场清单仓库根目录的.agents/plugins/marketplace.json插件清单plugins/agentic-awesome-skills/.codex-plugin/plugin.json。从市场清单的测试用例 codex_plugin_marketplace.test.js 可以确认插件元数据的结构约定marketplace.name为agentic-awesome-skills展示名为 Agentic Awesome Skills首个插件条目agentic-awesome-skills的source指向仓库本地目录./plugins/agentic-awesome-skills插件策略声明policy.installation: AVAILABLE、policy.authentication: ON_INSTALL归类为Productivity。插件清单 plugin.json 的关键字段包括skills: ./skills/插件技能目录的相对路径插件内已按兼容性筛选出插件安全plugin-safe的技能子集version与仓库package.json版本保持同步interface.defaultPrompt给出了开箱即用的提示词建议例如 Use brainstorming to plan a new feature。值得注意的是插件目录内的技能并非全量复制而是依据 data/plugin-compatibility.json 的兼容性矩阵生成只有targets.codex标记为supported的技能才会进入 Codex 插件。当前兼容性矩阵中全库 2,126 个技能有 2,045 个被标记为 Codexsupported另有 81 个被标记为blocked测试用例codex_plugin_marketplace.test.js会逐项断言插件目录包含所有 supported 技能、排除所有 blocked 技能。Codex CLI 的最佳入门技能以下是官方文档推荐的五个入门技能全部位于 skills 目录下且均在兼容性矩阵中被标记为 Codexsupported、无需额外 setup技能定位源码位置brainstorming在接触代码之前明确需求skills/brainstorming/SKILL.mdconcise-planning将模糊的工作转化为原子执行计划skills/concise-planning/SKILL.mdtest-driven-development围绕红-绿-重构构建变更skills/test-driven-development/SKILL.mdlint-and-validate保持质量检查接近实现循环skills/lint-and-validate/SKILL.mdcreate-pr在实现完成后干净地收尾工作skills/create-pr/SKILL.md下面结合每个技能的SKILL.md实际内容说明它们解决什么问题、如何使用。brainstorming动手前先明确需求该技能用于在接触代码之前澄清需求边界避免边写边猜。它的典型触发场景是需求本身模糊、存在多个隐含假设或一次性提出多个方案尚未收敛时。技能会引导 Agent 通过少量提问锚定目标用户、场景与验收标准然后再进入实现。concise-planning把模糊工作变成原子清单这是规划阶段使用频率最高的技能之一。从 SKILL.md 可以看到其核心工作流扫描上下文阅读README.md、文档和相关代码文件识别语言、框架、测试等约束最小交互最多只问 12 个真正阻塞的问题对非阻塞的未知项做出合理假设生成计划按照固定结构输出——Approach13 句说明做什么与为什么、ScopeIn/Out 清单、Action Items610 个动词开头的原子化有序任务、Validation至少包含一项测试验证。这套结构可以直接用于 Codex 提示词把帮我做个功能升级为请生成可执行、可验证的实施清单。test-driven-development红-绿-重构该技能把变更构建在先写失败测试、再写最小实现、最后重构的循环之上核心原则是如果没有亲眼看到测试失败就无法确定它测的是对的东西。从 SKILL.md 看它要求先了解仓库的测试运行器与既有覆盖情况再写失败测试如果实现已经存在则保留既有工作并补充特征化/回归测试而不是为了理想化的测试先行重写代码。它配套了testing-anti-patterns.md用于识别和规避常见的测试反模式。lint-and-validate让质量检查贴近实现循环该技能强调配置化、只读的质量检查先读取仓库的package.json脚本因为名为lint的脚本可能修改文件或执行任意代码再运行项目已声明的npm run lint、npm run typecheck、ruff check .、mypy .等命令且不允许用npx静默拉取未安装的检查器。配套的scripts/lint_runner.py会运行一组保守的候选检查缺失命令或检查失败时退出码为 1无配置检查时退出码为 2。它适合作为实现循环末尾的完成门槛。create-pr干净地收尾交付实现与验证完成之后由该技能负责把工作收束为可审查的 Pull Request包括分支整理、提交信息、面向用户的变更摘要等避免交付环节的手工遗漏。Codex CLI 提示词示例安装完成后在 Codex CLI 中通过技能名引用即可。以下是文档给出的三个可直接复制的示例使用 concise-planning 将此功能请求分解为实施清单。在更改此解析器之前使用 test-driven-development 添加测试。一旦所有测试都通过使用 create-pr 并总结面向用户的变更。三个示例恰好覆盖了规划 → 实现测试驱动→ 交付的完整编码循环。在真实项目中可以将技能名替换为上面表格中的任意一项并把此功能请求此解析器替换为具体的功能描述或文件路径。如何选择技能完整指南与工作流当你在广泛技能库与精选技能集之间做选择时可以继续参考ai-agent-skills.md提供在广泛和精选技能库之间进行选择的决策框架workflows.md提供常见工程目标的逐步执行模式workflow 编排README.md查看完整的客户端兼容性矩阵与仓库总览aas-core.md如果需要让 Codex 通过只读 MCP 搜索完整目录、由 Agent 自主选择技能并产出可复现的技能栈清单aas-stack.json与不可变计划可阅读 AAS Core 指南。小结Agentic Awesome Skills 为 Codex CLI 提供了安装即用、按需筛选、可插拔的三层使用路径npx agentic-awesome-skills --codex直装、--skills/--risk/--category精确筛选、以及仓库本地插件marketplace.jsonplugin.json集成。配合brainstorming、concise-planning、test-driven-development、lint-and-validate、create-pr五个入门技能即可在本地编码循环中完成从需求澄清、计划生成、测试驱动实现、质量验证到 PR 交付的完整闭环。所有技能均以SKILL.md标准格式组织兼容性由 data/plugin-compatibility.json 维护并有自动化测试保证插件内容与兼容性矩阵一致。【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,115 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考