戰(zhàn)：插件安裝、@ 調(diào)用與清單文件工作機(jī)制)
agent-skills 接入 Codex 實(shí)戰(zhàn)插件安裝、 調(diào)用與清單文件工作機(jī)制【免費(fèi)下載鏈接】agent-skillsProduction-grade engineering skills for AI coding agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills本篇指南聚焦 docs/codex-setup.md 講解的主題如何把 agent-skills 倉(cāng)庫(kù)作為原生 Codex 插件安裝到你的 Codex CLI并理解安裝背后的清單文件結(jié)構(gòu)與調(diào)用機(jī)制。讀完后你可以獨(dú)立完成遠(yuǎn)程/本地克隆兩種安裝方式掌握前綴調(diào)用任意 skill 的方法并看懂.codex-plugin/plugin.json、.agents/plugins/marketplace.json兩份關(guān)鍵清單是如何讓 Codex 與 Claude Code 共享同一份skills/目錄的。一、核心前提一份 skills 目錄兩個(gè)平臺(tái)消費(fèi)agent-skills 倉(cāng)庫(kù)本身就是一個(gè) Codex 插件。它的核心設(shè)計(jì)是Claude Code 使用的根級(jí)skills/目錄會(huì)被 Codex 直接消費(fèi)安裝過(guò)程中不會(huì)復(fù)制、不會(huì)生成任何副本文件。這意味著兩個(gè)平臺(tái)讀的是同一批skills/name/SKILL.md維護(hù)一份即可同時(shí)服務(wù)兩端。倉(cāng)庫(kù)內(nèi)skills/目錄下共有 25 個(gè) skill覆蓋從需求規(guī)格到上線發(fā)布的完整研發(fā)流程例如spec-driven-development編碼前先寫(xiě)規(guī)格說(shuō)明speccode-review-and-quality合并前的多維度代碼審查test-driven-development紅-綠-重構(gòu)循環(huán)performance-optimization、security-and-hardening、shipping-and-launch等。README.md 的 Codex 小節(jié)同樣強(qiáng)調(diào)Codex 通過(guò) .codex-plugin/plugin.json 直接讀取根目錄的skills/目錄。二、安裝插件遠(yuǎn)程倉(cāng)庫(kù)方式要求Codex CLI v0.122 或更高版本。兩條命令依次執(zhí)行codex plugin marketplace add addyosmani/agent-skills codex plugin add agent-skillsagent-skills兩條命令的分工是明確的第一條把這個(gè)倉(cāng)庫(kù)注冊(cè)為一個(gè)名為agent-skills的 marketplace插件市場(chǎng)第二條從該 marketplace 中安裝并啟用agent-skills插件。安裝完成后必須啟動(dòng)一個(gè)新的 Codex 會(huì)話skill 才會(huì)被發(fā)現(xiàn)discovered并可用。版本注意在 v0.122 之前的舊版本 Codex CLI 中命令是codex marketplace add沒(méi)有plugin子命令。如果執(zhí)行報(bào)錯(cuò)先檢查 CLI 版本是否過(guò)舊。三、本地克隆安裝如果你在開(kāi)發(fā)、調(diào)試這份倉(cāng)庫(kù)或者網(wǎng)絡(luò)環(huán)境不便直連遠(yuǎn)程倉(cāng)庫(kù)可以直接用本地克隆codex plugin marketplace add /path/to/your/clone codex plugin add agent-skillsagent-skills注意第二條命令與遠(yuǎn)程方式完全相同marketplace 注冊(cè)的是本地路徑但插件標(biāo)識(shí)符仍然是agent-skillsagent-skills。之所以能這樣工作與倉(cāng)庫(kù)內(nèi) marketplace 清單的聲明方式有關(guān)——見(jiàn)下文第四節(jié)。四、工作原理三個(gè)關(guān)鍵文件原文檔用三個(gè)文件解釋整個(gè)集成機(jī)制下面逐一展開(kāi)并給出倉(cāng)庫(kù)中的真實(shí)文件內(nèi)容。4.1 .codex-plugin/plugin.json —— Codex 插件清單.codex-plugin/plugin.json 是 Codex 識(shí)別本倉(cāng)庫(kù)為插件的入口文件。它把skills字段指向./skills/并提供 Codex 所需的完整元數(shù)據(jù)。真實(shí)內(nèi)容如下{ name: agent-skills, version: 0.6.8, description: Production-grade engineering skills for AI coding agents covering the full software development lifecycle from spec to ship., author: { name: Addy Osmani, url: https://github.com/addyosmani }, homepage: https://github.com/addyosmani/agent-skills, repository: https://github.com/addyosmani/agent-skills, license: MIT, skills: ./skills/, interface: { displayName: Agent Skills, shortDescription: Senior-engineer workflows for AI coding agents: spec, plan, build, test, review, ship., longDescription: Agent Skills bundles 24 production engineering workflows from Addy Osmani, covering requirements, planning, implementation, testing, review, and shipping., developerName: Addy Osmani, category: Productivity, capabilities: [Interactive, Read, Write], defaultPrompt: [ Help me choose the right engineering workflow for this task, Plan and implement this change using the relevant Agent Skills ] } }逐字段說(shuō)明字段作用name/version插件標(biāo)識(shí)。安裝命令codex plugin add agent-skillsagent-skills中的名稱(chēng)即來(lái)自這里當(dāng)前版本為0.6.8skills: ./skills/核心字段。告訴 Codex 去倉(cāng)庫(kù)根目錄的skills/目錄發(fā)現(xiàn)全部 skill這是兩個(gè)平臺(tái)共享同一目錄的直接依據(jù)author/homepage/repository/license元數(shù)據(jù)供插件市場(chǎng)展示interface.capabilities聲明插件需要的交互能力Interactive、Read、Writeinterface.defaultPrompt安裝后在 Codex 中提供的默認(rèn)提示語(yǔ)模板對(duì)比來(lái)看倉(cāng)庫(kù)根目錄另有一份 plugin.json僅含name、version、description三個(gè)字段它是 Claude Code 側(cè)的插件清單.claude-plugin/ 目錄下的plugin.json、marketplace.json則服務(wù)于 Claude Code 的/plugin市場(chǎng)機(jī)制。兩套清單各自獨(dú)立互不影響。4.2 .agents/plugins/marketplace.json —— marketplace 條目.agents/plugins/marketplace.json 是聲明本倉(cāng)庫(kù)可作為 marketplace 源的條目。真實(shí)內(nèi)容{ name: agent-skills, interface: { displayName: Agent Skills }, plugins: [ { name: agent-skills, version: 0.6.8, description: Production-grade engineering skills covering every phase of software development: spec, plan, build, verify, review, and ship., source: { source: local, path: ./ }, policy: { installation: AVAILABLE, authentication: ON_INSTALL }, category: Productivity } ] }要點(diǎn)解析source.path: ./聲明倉(cāng)庫(kù)根目錄就是插件源。因此無(wú)論是codex plugin marketplace add addyosmani/agent-skills遠(yuǎn)程克隆后根目錄即./還是codex plugin marketplace add /path/to/your/clone本地克隆Codex 都能用同一份 marketplace.json 找到插件且插件標(biāo)識(shí)符保持一致。policy.installation: AVAILABLE表示該插件可直接安裝policy.authentication: ON_INSTALL表示認(rèn)證發(fā)生在安裝時(shí)。4.3 skills/ /SKILL.md —— 兩端共享的 skill 格式skill 文件本身沒(méi)有任何平臺(tái)專(zhuān)屬改動(dòng)。以 skills/spec-driven-development/SKILL.md 為例其 YAML frontmatter 形如--- name: spec-driven-development description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. ... ---Codex 與 Claude Code 采用相同的namedescriptionfrontmatter 約定因此同一個(gè) SKILL.md 文件同時(shí)服務(wù)兩個(gè)平臺(tái)name決定調(diào)用標(biāo)識(shí)description決定 agent 在自然語(yǔ)言場(chǎng)景下如何判斷該 skill 是否適用何時(shí)使用、何時(shí)不使用都寫(xiě)在描述和正文里。這也是整個(gè)倉(cāng)庫(kù)多平臺(tái)一份內(nèi)容設(shè)計(jì)的根基。五、日常使用 調(diào)用與自然語(yǔ)言觸發(fā)安裝并重啟會(huì)話后有兩種方式使用 skill顯式調(diào)用在 Codex 聊天中用前綴指定 skill例如spec-driven-development。全部 25 個(gè) skill 均可用命名與skills/下的目錄名一一對(duì)應(yīng)隱式觸發(fā)直接用自然語(yǔ)言描述任務(wù)比如幫我評(píng)審一下這個(gè) diff由 Codex 根據(jù)各 skill 的description自行挑選合適的 skill。六、能力邊界哪些是 Claude Code 專(zhuān)屬的這一點(diǎn)是原文檔特意強(qiáng)調(diào)的也是 Codex 用戶最容易踩坑的地方。以下三類(lèi)內(nèi)容仍然是 Claude Code 專(zhuān)屬不會(huì)隨插件帶入 Codex內(nèi)容所在位置在 Codex 中的替代方式斜杠命令.claude/commands/ 下的spec.md、plan.md、test.md、review.md、ship.md、webperf.md等直接調(diào)用底層 skill用spec-driven-development替代/spec用test-driven-development替代/test角色人格personasagents/ 目錄下的code-reviewer.md、security-auditor.md等無(wú)直接等價(jià)物按 skill 調(diào)用生命周期鉤子hooks/ 目錄如 hooks/hooks.json 聲明的SessionStart鉤子不適用也就是說(shuō)Codex 側(cè)拿到的是純 skill 能力而 Claude Code 側(cè)額外擁有命令包裝層、人格與鉤子。如果你在 Codex 中找不到/spec這類(lèi)斜杠命令這不是安裝失敗而是按設(shè)計(jì)如此。七、驗(yàn)證安裝是否成功完成安裝后的驗(yàn)證步驟啟動(dòng)一個(gè)新的Codex 會(huì)話舊會(huì)話不會(huì)發(fā)現(xiàn)新裝的 skill輸入確認(rèn)補(bǔ)全列表中出現(xiàn)spec-driven-development、code-review-and-quality等 25 個(gè) skill 名稱(chēng)輸入一句自然語(yǔ)言任務(wù)觀察 Codex 是否自動(dòng)選中了對(duì)應(yīng) skill若命令執(zhí)行即報(bào)錯(cuò)先確認(rèn) Codex CLI 版本 ≥ v0.122舊版本需改用codex marketplace add的舊命令形式或升級(jí) CLI 后按本文第二節(jié)的命令重新安裝。小結(jié)agent-skills 的 Codex 接入遵循一條清晰的主線.agents/plugins/marketplace.json 讓倉(cāng)庫(kù)根目錄成為合法的插件源支撐遠(yuǎn)程與本地克隆兩種安裝路徑.codex-plugin/plugin.json 中的skills: ./skills/讓 Codex 直接消費(fèi)根級(jí)skills/目錄零復(fù)制、零漂移統(tǒng)一的namedescriptionfrontmatter 讓每個(gè)SKILL.md同時(shí)被 Codex 和 Claude Code 理解斜杠命令、personas 與生命周期鉤子保留在 Claude Code 側(cè)Codex 用戶以skill-name直接調(diào)用 skill 作為等價(jià)替代?！久赓M(fèi)下載鏈接】agent-skillsProduction-grade engineering skills for AI coding agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 agent-skills 接入 Codex 實(shí)戰(zhàn)：插件安裝、@ 調(diào)用與清單文件工作機(jī)制
agent-skills 接入 Codex 實(shí)戰(zhàn)插件安裝、 調(diào)用與清單文件工作機(jī)制【免費(fèi)下載鏈接】agent-skillsProduction-grade engineering skills for AI coding agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills本篇指南聚焦 docs/codex-setup.md 講解的主題如何把 agent-skills 倉(cāng)庫(kù)作為原生 Codex 插件安裝到你的 Codex CLI并理解安裝背后的清單文件結(jié)構(gòu)與調(diào)用機(jī)制。讀完后你可以獨(dú)立完成遠(yuǎn)程/本地克隆兩種安裝方式掌握前綴調(diào)用任意 skill 的方法并看懂.codex-plugin/plugin.json、.agents/plugins/marketplace.json兩份關(guān)鍵清單是如何讓 Codex 與 Claude Code 共享同一份skills/目錄的。一、核心前提一份 skills 目錄兩個(gè)平臺(tái)消費(fèi)agent-skills 倉(cāng)庫(kù)本身就是一個(gè) Codex 插件。它的核心設(shè)計(jì)是Claude Code 使用的根級(jí)skills/目錄會(huì)被 Codex 直接消費(fèi)安裝過(guò)程中不會(huì)復(fù)制、不會(huì)生成任何副本文件。這意味著兩個(gè)平臺(tái)讀的是同一批skills/name/SKILL.md維護(hù)一份即可同時(shí)服務(wù)兩端。倉(cāng)庫(kù)內(nèi)skills/目錄下共有 25 個(gè) skill覆蓋從需求規(guī)格到上線發(fā)布的完整研發(fā)流程例如spec-driven-development編碼前先寫(xiě)規(guī)格說(shuō)明speccode-review-and-quality合并前的多維度代碼審查test-driven-development紅-綠-重構(gòu)循環(huán)performance-optimization、security-and-hardening、shipping-and-launch等。README.md 的 Codex 小節(jié)同樣強(qiáng)調(diào)Codex 通過(guò) .codex-plugin/plugin.json 直接讀取根目錄的skills/目錄。二、安裝插件遠(yuǎn)程倉(cāng)庫(kù)方式要求Codex CLI v0.122 或更高版本。兩條命令依次執(zhí)行codex plugin marketplace add addyosmani/agent-skills codex plugin add agent-skillsagent-skills兩條命令的分工是明確的第一條把這個(gè)倉(cāng)庫(kù)注冊(cè)為一個(gè)名為agent-skills的 marketplace插件市場(chǎng)第二條從該 marketplace 中安裝并啟用agent-skills插件。安裝完成后必須啟動(dòng)一個(gè)新的 Codex 會(huì)話skill 才會(huì)被發(fā)現(xiàn)discovered并可用。版本注意在 v0.122 之前的舊版本 Codex CLI 中命令是codex marketplace add沒(méi)有plugin子命令。如果執(zhí)行報(bào)錯(cuò)先檢查 CLI 版本是否過(guò)舊。三、本地克隆安裝如果你在開(kāi)發(fā)、調(diào)試這份倉(cāng)庫(kù)或者網(wǎng)絡(luò)環(huán)境不便直連遠(yuǎn)程倉(cāng)庫(kù)可以直接用本地克隆codex plugin marketplace add /path/to/your/clone codex plugin add agent-skillsagent-skills注意第二條命令與遠(yuǎn)程方式完全相同marketplace 注冊(cè)的是本地路徑但插件標(biāo)識(shí)符仍然是agent-skillsagent-skills。之所以能這樣工作與倉(cāng)庫(kù)內(nèi) marketplace 清單的聲明方式有關(guān)——見(jiàn)下文第四節(jié)。四、工作原理三個(gè)關(guān)鍵文件原文檔用三個(gè)文件解釋整個(gè)集成機(jī)制下面逐一展開(kāi)并給出倉(cāng)庫(kù)中的真實(shí)文件內(nèi)容。4.1 .codex-plugin/plugin.json —— Codex 插件清單.codex-plugin/plugin.json 是 Codex 識(shí)別本倉(cāng)庫(kù)為插件的入口文件。它把skills字段指向./skills/并提供 Codex 所需的完整元數(shù)據(jù)。真實(shí)內(nèi)容如下{ name: agent-skills, version: 0.6.8, description: Production-grade engineering skills for AI coding agents covering the full software development lifecycle from spec to ship., author: { name: Addy Osmani, url: https://github.com/addyosmani }, homepage: https://github.com/addyosmani/agent-skills, repository: https://github.com/addyosmani/agent-skills, license: MIT, skills: ./skills/, interface: { displayName: Agent Skills, shortDescription: Senior-engineer workflows for AI coding agents: spec, plan, build, test, review, ship., longDescription: Agent Skills bundles 24 production engineering workflows from Addy Osmani, covering requirements, planning, implementation, testing, review, and shipping., developerName: Addy Osmani, category: Productivity, capabilities: [Interactive, Read, Write], defaultPrompt: [ Help me choose the right engineering workflow for this task, Plan and implement this change using the relevant Agent Skills ] } }逐字段說(shuō)明字段作用name/version插件標(biāo)識(shí)。安裝命令codex plugin add agent-skillsagent-skills中的名稱(chēng)即來(lái)自這里當(dāng)前版本為0.6.8skills: ./skills/核心字段。告訴 Codex 去倉(cāng)庫(kù)根目錄的skills/目錄發(fā)現(xiàn)全部 skill這是兩個(gè)平臺(tái)共享同一目錄的直接依據(jù)author/homepage/repository/license元數(shù)據(jù)供插件市場(chǎng)展示interface.capabilities聲明插件需要的交互能力Interactive、Read、Writeinterface.defaultPrompt安裝后在 Codex 中提供的默認(rèn)提示語(yǔ)模板對(duì)比來(lái)看倉(cāng)庫(kù)根目錄另有一份 plugin.json僅含name、version、description三個(gè)字段它是 Claude Code 側(cè)的插件清單.claude-plugin/ 目錄下的plugin.json、marketplace.json則服務(wù)于 Claude Code 的/plugin市場(chǎng)機(jī)制。兩套清單各自獨(dú)立互不影響。4.2 .agents/plugins/marketplace.json —— marketplace 條目.agents/plugins/marketplace.json 是聲明本倉(cāng)庫(kù)可作為 marketplace 源的條目。真實(shí)內(nèi)容{ name: agent-skills, interface: { displayName: Agent Skills }, plugins: [ { name: agent-skills, version: 0.6.8, description: Production-grade engineering skills covering every phase of software development: spec, plan, build, verify, review, and ship., source: { source: local, path: ./ }, policy: { installation: AVAILABLE, authentication: ON_INSTALL }, category: Productivity } ] }要點(diǎn)解析source.path: ./聲明倉(cāng)庫(kù)根目錄就是插件源。因此無(wú)論是codex plugin marketplace add addyosmani/agent-skills遠(yuǎn)程克隆后根目錄即./還是codex plugin marketplace add /path/to/your/clone本地克隆Codex 都能用同一份 marketplace.json 找到插件且插件標(biāo)識(shí)符保持一致。policy.installation: AVAILABLE表示該插件可直接安裝policy.authentication: ON_INSTALL表示認(rèn)證發(fā)生在安裝時(shí)。4.3 skills/ /SKILL.md —— 兩端共享的 skill 格式skill 文件本身沒(méi)有任何平臺(tái)專(zhuān)屬改動(dòng)。以 skills/spec-driven-development/SKILL.md 為例其 YAML frontmatter 形如--- name: spec-driven-development description: Creates specs before coding. Use when starting a new project, feature, or significant change and no specification exists yet. ... ---Codex 與 Claude Code 采用相同的namedescriptionfrontmatter 約定因此同一個(gè) SKILL.md 文件同時(shí)服務(wù)兩個(gè)平臺(tái)name決定調(diào)用標(biāo)識(shí)description決定 agent 在自然語(yǔ)言場(chǎng)景下如何判斷該 skill 是否適用何時(shí)使用、何時(shí)不使用都寫(xiě)在描述和正文里。這也是整個(gè)倉(cāng)庫(kù)多平臺(tái)一份內(nèi)容設(shè)計(jì)的根基。五、日常使用 調(diào)用與自然語(yǔ)言觸發(fā)安裝并重啟會(huì)話后有兩種方式使用 skill顯式調(diào)用在 Codex 聊天中用前綴指定 skill例如spec-driven-development。全部 25 個(gè) skill 均可用命名與skills/下的目錄名一一對(duì)應(yīng)隱式觸發(fā)直接用自然語(yǔ)言描述任務(wù)比如幫我評(píng)審一下這個(gè) diff由 Codex 根據(jù)各 skill 的description自行挑選合適的 skill。六、能力邊界哪些是 Claude Code 專(zhuān)屬的這一點(diǎn)是原文檔特意強(qiáng)調(diào)的也是 Codex 用戶最容易踩坑的地方。以下三類(lèi)內(nèi)容仍然是 Claude Code 專(zhuān)屬不會(huì)隨插件帶入 Codex內(nèi)容所在位置在 Codex 中的替代方式斜杠命令.claude/commands/ 下的spec.md、plan.md、test.md、review.md、ship.md、webperf.md等直接調(diào)用底層 skill用spec-driven-development替代/spec用test-driven-development替代/test角色人格personasagents/ 目錄下的code-reviewer.md、security-auditor.md等無(wú)直接等價(jià)物按 skill 調(diào)用生命周期鉤子hooks/ 目錄如 hooks/hooks.json 聲明的SessionStart鉤子不適用也就是說(shuō)Codex 側(cè)拿到的是純 skill 能力而 Claude Code 側(cè)額外擁有命令包裝層、人格與鉤子。如果你在 Codex 中找不到/spec這類(lèi)斜杠命令這不是安裝失敗而是按設(shè)計(jì)如此。七、驗(yàn)證安裝是否成功完成安裝后的驗(yàn)證步驟啟動(dòng)一個(gè)新的Codex 會(huì)話舊會(huì)話不會(huì)發(fā)現(xiàn)新裝的 skill輸入確認(rèn)補(bǔ)全列表中出現(xiàn)spec-driven-development、code-review-and-quality等 25 個(gè) skill 名稱(chēng)輸入一句自然語(yǔ)言任務(wù)觀察 Codex 是否自動(dòng)選中了對(duì)應(yīng) skill若命令執(zhí)行即報(bào)錯(cuò)先確認(rèn) Codex CLI 版本 ≥ v0.122舊版本需改用codex marketplace add的舊命令形式或升級(jí) CLI 后按本文第二節(jié)的命令重新安裝。小結(jié)agent-skills 的 Codex 接入遵循一條清晰的主線.agents/plugins/marketplace.json 讓倉(cāng)庫(kù)根目錄成為合法的插件源支撐遠(yuǎn)程與本地克隆兩種安裝路徑.codex-plugin/plugin.json 中的skills: ./skills/讓 Codex 直接消費(fèi)根級(jí)skills/目錄零復(fù)制、零漂移統(tǒng)一的namedescriptionfrontmatter 讓每個(gè)SKILL.md同時(shí)被 Codex 和 Claude Code 理解斜杠命令、personas 與生命周期鉤子保留在 Claude Code 側(cè)Codex 用戶以skill-name直接調(diào)用 skill 作為等價(jià)替代?！久赓M(fèi)下載鏈接】agent-skillsProduction-grade engineering skills for AI coding agents.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考