rolebox
通过YAML文件快速定义AI智能体角色
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：rolebox。 它的用途是：通过YAML文件快速定义AI智能体角色 完整的 Skill 内容见：https://321skill.com/skills/rolebox/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“加载‘技术文档工程师’这个角色配置。”，它会根据YAML文件中定义的系统提示词、选定的模型以及集成的文档写作技能，自动切换为一个专注于撰写清晰技术文档的AI助手，帮助你起草或润色API说明。
介绍
Rolebox 是一个 OpenCode 插件，旨在解决AI智能体角色定义和管理复杂、难以复用的问题。它允许开发者通过编写简单的YAML配置文件，来快速定义和部署具有特定角色、提示词、模型、技能和权限的AI智能体，从而将角色配置从代码中分离出来，实现更好的模块化和可维护性。
使用方式非常直观：用户只需创建一个YAML文件，在其中指定角色的名称、系统提示词、可调用的模型、集成的技能列表以及操作权限等。然后，通过Rolebox插件加载这个配置文件，即可实例化一个符合预设的AI智能体，并集成到OpenCode生态中进行调用。
这个工具非常适合AI应用开发者、希望为团队或项目创建标准化AI助手的工程师，以及需要快速实验不同角色配置的研究人员。它降低了定制AI智能体的技术门槛，提升了配置的灵活性和迭代速度。
在使用时，建议从简单的角色定义开始，逐步添加技能和复杂权限。由于依赖OpenCode平台，请确保运行环境已正确配置。同时，YAML文件的语法和结构需要遵循Rolebox的规范，编写时需注意格式正确性。
核心特点
与同类工具相比，Rolebox的核心区别在于其“配置即代码”的理念，通过标准化的YAML文件来完整定义AI角色，实现了角色配置的版本化、可复用和易于协作管理；同时，它深度集成于OpenCode插件体系，能直接利用其生态中的技能和模型，提供了开箱即用的部署体验。
注意事项
该工具主要面向OpenCode生态，不适用于其他AI开发框架或需要完全独立部署的场景。
常见问题
Rolebox和直接写代码定义AI角色有什么区别？
Rolebox用YAML配置替代硬编码，使角色定义更清晰、易修改、可复用，便于团队协作和版本管理。
需要会写YAML吗？
需要基本的YAML语法知识，但Rolebox的配置结构直观，通常参考示例即可上手。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/rolebox/raw/index.md 读取 rolebox 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/rolebox/raw/index.md（查看排版版本）