composer-agent-skill-plugin

一个Composer插件,用于在PHP项目中管理和集成AI Agent技能。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:composer-agent-skill-plugin。
它的用途是:一个Composer插件,用于在PHP项目中管理和集成AI Agent技能。
完整的 Skill 内容见:https://321skill.com/skills/composer-agent-skill-plugin/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“在我的PHP项目中,我想引入一个数据库分析技能和一个代码审查技能。”,它会指导你通过`composer require`安装相应的技能包,或引导你在`composer.json`中直接声明技能源。安装后,运行`composer install`,插件会自动发现这些技能,经过你的信任确认后,将它们的信息整合并生成`AGENTS.md`索引文件,供你的AI Agent框架读取和使用。

介绍

Composer AI Agent Skill Plugin 是一个专为PHP项目设计的Composer插件,旨在解决AI Agent技能依赖管理的复杂性问题。它通过统一的管道,将来自不同来源的技能(如专用技能包、普通库附带的技能、或直接声明的GitHub/本地路径)进行自动发现、信任验证,并最终生成标准化的技能索引文件(AGENTS.md)。

使用方式非常灵活。开发者可以通过三种主要途径将技能引入项目:安装声明为type: ai-agent-skill的专用技能包;安装任何在其composer.jsonextra.ai-agent-skill字段中声明了技能的普通库;或者在项目根目录的composer.json中通过extra.ai-agent-skills直接声明GitHub仓库或本地路径,并通过composer skills命令进行管理。所有技能最终都通过相同的信任和生成流程处理。

这个插件非常适合需要在PHP项目中集成、管理和复用多个AI Agent技能的开发者,特别是那些构建复杂智能体应用或希望将AI能力模块化的团队。无论是全栈开发、后端开发还是智能体开发者,都能通过它来简化技能生态的管理。

建议在初次安装插件时仔细阅读其信任提示,并根据项目环境(如CI/CD)预先配置allow-plugins。对于直接声明的技能源,注意使用composer skills:update来更新锁定文件,并利用composer outdated命令来追踪技能版本状态。

核心特点

与单一功能的技能不同,此插件本身是一个技能管理平台和集成工具。它首创了“通用发现”机制,允许任何Composer包(无论其类型)通过`extra`字段携带AI技能,并提供了直接管理GitHub/本地技能源的能力,将所有来源的技能统一到同一个发现、信任和文档生成管道中,实现了技能生态的集中化管理。

注意事项

此插件主要服务于PHP生态内的Composer项目,非PHP项目或未使用Composer的PHP项目无法直接使用。

常见问题

这个插件和直接安装一个AI技能包有什么区别?

此插件是技能的管理器和集成器,它不仅能安装专用技能包,还能从普通库中发现技能,并支持直接管理GitHub等外部技能源,最终统一生成技能索引。而直接安装一个技能包只是引入了单一功能。

如何在非交互式环境(如CI/CD)中安装?

需要在项目的`composer.json`中预先配置`config.allow-plugins`,将`"netresearch/composer-agent-skill-plugin": true`加入,以避免安装时的交互式信任询问。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/composer-agent-skill-plugin/raw/index.md 读取 composer-agent-skill-plugin 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。