Token导航 LogoToken导航

Agent Skill · 待分类

roleme(roleme 命令行)

roleme 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

roleme 是待分类类 Agent Skill,可用宿主为 Codex、Claude、Cursor、Gemini CLI,通过GitHub 仓库获取,权限为执行命令;许可证信息还不明确,第三方扫描已通过,按安装量在待分类类的 11,209 个 Skill 里排第 8,287。

总安装 309周安装 13GitHub Stars 3下载 108核验 2026-05-01

安装说明

本站只整理中文说明,不托管安装包,也不代用户安装。
GitHub
许可证
unknown

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:roleme(roleme 命令行)
来源仓库:https://github.com/zhaocaho/roleme
仓库路径:skills/roleme
安装命令:
npx skills add https://github.com/zhaocaho/roleme --skill roleme
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/zhaocaho/roleme --skill roleme

这个 Skill 是做什么的

这个 Skill 的分类还没最终确定,用法以来源仓库的说明为准。

roleme 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中整理相关事项。适用于围绕仓库状态、代码变更或协作任务进行信息梳理的场景。通过 npx skills add 命令从指定 GitHub 仓库安装并使用。

安装前需确认权限范围和维护状态,注意可能触发的联网或文件操作。建议结合原始 README 核验具体用法和功能边界。

来源仓库内路径:skills/roleme

上手步骤

4 步
  1. 1

    确认自己的宿主工具

    公开资料标注支持 Codex、Claude、Cursor、Gemini CLI;先确认自己用的是其中之一,再按对应工具的 Skills 目录放置。

  2. 2

    拿到安装命令

    可以直接复制的命令是 npx skills add https://github.com/zhaocaho/roleme --skill roleme;命令里的占位符换成自己的路径或密钥再执行。

  3. 3

    安装后重启宿主

    命令执行完要完全退出宿主工具再打开,让新装的 Skill 被重新扫描到,否则列表里可能看不到。

  4. 4

    按最小权限试用

    它需要执行命令,先在测试目录或测试账号里跑,确认没问题再放到正式项目。

常见问题

6 条

roleme 怎么安装?

在终端执行 npx skills add https://github.com/zhaocaho/roleme --skill roleme。装完完全退出宿主工具再打开,让它重新扫描本地 Skill。

roleme 支持哪些 AI 工具?

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录,一般也能手动放进去,但要自己确认触发方式是否一致。

roleme 需要什么权限?

权限级别是执行命令。安装流程涉及命令执行,可能通过 npx skills add https://github.com/zhaocaho/roleme --skill roleme 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

roleme 是免费的吗?

公开资料没有标注明确许可证,收费和商用限制都无法确认。正式使用前请到来源仓库核对授权说明。

roleme 用的人多吗?

公开数据是累计安装 309 次,近一周安装 13 次,下载 108 次,GitHub 3 星。这些数字来自第三方目录统计,只能当作热度参考,不代表质量或安全性。

roleme 安全吗?

第三方扫描结果为通过,但这只覆盖已知的静态检查项,不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

  • 同时适配 4 种工具,换客户端不用重新找替代品。
  • 第三方扫描已通过,常见的高风险行为没有命中。

先想清楚的地方

  • 需要执行命令,装到常用环境前要先评估影响面。
  • 许可证没有明确标注,能不能商用、能不能再分发都不确定。
  • 第三方目录整理,版本更新和行为细节以来源仓库为准。

适不适合你

更适合

  • 已经在用 Codex,想直接扩展它能力的人。
  • 需要处理待分类类任务、又不想每次都手写提示词的人。

不太适合

  • 不能接受 Skill 在你机器上执行命令的人。
  • 需要明确授权才能用到公司项目里的场景。
  • 需要厂商级技术支持和 SLA 的生产系统。

待分类类 Skill 对比

6 个同类
Skill总安装GitHub 星权限许可证扫描
infsh-cli

infsh CLI · Codex、Claude

4,374,576382权限未标注未明确未收录
ai-video-generation

AI 视频生成 · Codex、Claude

4,313,376382调用外部服务未明确有提醒
lark-openapi-explorer

云雀 OpenAPI 浏览器 · Codex、Claude

2,064,1209,011需要联网未明确有提醒
lark-workflow-standup-report

Lark 工作流程站立报告 · Codex、Claude

2,041,6328,978需要联网未明确通过
use-my-browser

使用我的浏览器 · Codex、Claude

1,848,49140操作浏览器未明确未通过
roleme

roleme 命令行 · 本页

3093执行命令未明确通过

按安装量取同分类前几名;数字来自第三方目录统计,只作热度参考,不代表质量结论。

SKILL.md 原文

roleMe

/roleMe 无参调用时,应先列出现有角色供用户选择加载;如果用户不想加载已有角色,就先问他要创建的角色名,再进入初始化流程。

详细使用说明见 references/usage.md。

命令面:

  • /roleMe
  • /roleMe <角色名>
  • /roleMe list
  • /roleMe optimize [角色名]
  • /roleMe export [角色名]
  • /roleMe doctor [角色名]

运行时原则:

  • roleMe 管理的是用户角色上下文,不是助手人格切换。
  • 角色包默认保存在 ~/.roleMe/<角色名>/;不要去 ~/.agents/skills/roleme/roles/ 之类的 skill 安装目录猜路径。
  • 需要列出现有角色或判断角色是否存在时,应以 tools/role_ops.py 的 list_roles() 与 role_dir() 语义为准,不要手写 shell 路径探测。
  • 未被结构化写入角色包的上下文,不应假定模型已经知道;稳定信息应落到 persona/、memory/、brain/、projects/ 中可检索的位置。
  • 常驻层与渐进层的边界由角色包内的 AGENT.md 决定。
  • 常驻层应保持最小且稳定;细节、专题知识与项目上下文优先按需展开,而不是堆进单个总说明。
  • 记忆写回优先遵循 AGENT.md 中的策略和 memory/ 结构。
  • 主题知识与项目上下文通过 tools/context_router.py 做渐进式发现,不应一次性全量加载。
  • 用户不需要直接维护 Graph;Context Graph 是后台机制,不改变用户正常对话方式。
  • 归档内容优先追求对智能体可读:结构清晰、边界明确、可检索、可增量更新,而不是只写成长段自由叙述。
  • 初始化访谈可以是动态的:问题由模型根据当前已知信息和信息缺口来决定,但最终仍要落到稳定的 persona/、memory/、brain/、projects/ 结构。
  • 槽位只是归档目标,不是固定提问顺序;模型应按当前情景决定下一问,而不是机械执行问卷。
  • 初始化访谈应更像采访而不是填表:用户没有表达出来的信息可以先不记录,不要为了补全而反复追问同一槽位。
  • 槽位提示只是采访锚点,不是最终逐字发问文案;真正问用户前,应结合当前上下文先润色成自然口语。
  • 当用户第一次无参执行 /roleMe 时,应先列出现有角色,让用户选择加载;如果用户选择创建新角色,应先询问角色名,再开始采访。
  • 语言偏好应在初始化时显式采访一次;如果用户暂时没有给出明确偏好,可以留空并在后续使用中慢慢积累。
  • 初始化成功后,应明确提醒用户重新调用 /roleMe <角色名>,以便把新写入的角色包加载进后续会话使用的快照。
  • 当角色已加载后,如果用户说“帮我总结这个项目的工作方式”或“帮我总结成通用的工作方式”,应直接把结果归档到当前角色,而不是只返回普通总结文本。
  • 当角色已加载后,若用户内容明显属于学习沉淀、项目复盘、方法论提炼、稳定偏好或长期协作规则,助手应主动进行归档,而不必等待用户显式下达“归档”指令。
  • 归档前应先提炼原始内容,再判断归档位置,而不是把原始对话直接整段落盘。
  • 默认先写入,再用一句短回执告知用户归档结果。
  • 判断不够确定时,优先写入 memory/episodes/ 或项目记忆,不轻易提升到 memory/USER.md 与 memory/MEMORY.md。
  • 项目级 workflow 写入 projects/<project-slug>/workflows/index.md 与 projects/<project-slug>/workflows/<workflow-slug>.md;通用 workflow 写入 brain/workflows/index.md 与 brain/workflows/<workflow-slug>.md;context.md 与 brain/index.md 只保留到工作流索引的入口,一个 workflow,一个文件,并将稳定规则提升到 memory/USER.md 与 memory/MEMORY.md。
  • 角色加载生成的冻结快照除常驻文件外,还应优先携带“当前项目 workflow 摘要”和“通用 workflow 摘要”;摘要来自各自的 workflow index,而不是 workflow 正文。
  • 当前角色由当前会话已加载的角色决定,自然语言归档必须写入该会话角色;.current-role.json 不再作为当前角色来源。
  • 如果用户输入 /roleMe current,应返回固定提示:/roleMe current 已不再支持全局当前角色查询。请在当前会话重新执行 /roleMe <角色名>。
  • 如果归档提升了 resident 规则或摘要,应提醒用户重新执行 /roleMe <角色名> 才会刷新当前会话底座。
  • optimize 与 doctor 应优先发现和修复角色包的熵增问题,例如重复记忆、索引失效、resident/on-demand 边界漂移。
  • 只有确定性的文件操作才调用 tools/role_ops.py、tools/memory.py、tools/context_router.py。
  • 打包产物中不包含开发仓库的 scripts/。

平台分布

Codex

36.4%
按下载量换算39

Claude

29.26%
按下载量换算32

Cursor

19.11%
按下载量换算21

Gemini CLI

8.99%
按下载量换算10

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

执行命令

安装流程涉及命令执行,可能通过 npx skills add https://github.com/zhaocaho/roleme --skill roleme 联网下载 Skill 或依赖。用户安装前应确认命令来源、仓库内容和执行环境。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。目前只有一个公开来源,建议同时核对源仓库。

继续浏览同类 Skills