Agents 共享规范与技能库
为多种 AI 编程助手复用协作规范、写作指南和任务技能。
- Star 数
- ★ 227
- 最近更新
- 6 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 73/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Codex CLI 和 Claude Code 的开发者,希望两者遵循同一套项目协作与编码规范。
- 不适合
- 需要开箱即用、自带执行引擎的团队
- 只使用 Codex CLI 和 Claude Code 之外助手的用户
- 希望获得托管服务或模型 API 的团队
- 源码审查
- 73/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
这是一个面向 AI 编程助手的共享标准与技能仓库,并非独立运行的智能体应用。核心内容包括项目级 AGENTS.md、用户级 user/AGENTS.md,以及采用 SKILL.md 格式组织的 skills/ 目录。仓库列出了规划、范围控制、产品与 UX 写作、营销文案、工作树 PR,以及调用 Codex CLI、Antigravity CLI 和 Grok Build 等技能。用户可把基础规范复制到项目中,也可通过 GitHub CLI 或 skills CLI 按技能安装到 Codex CLI、Claude Code 等受支持的助手。技能的主要产物是供编码助手读取的 Markdown 指令和配套资源;仓库还提供 Python 脚本,可把单项技能打包成适合网页上传的 ZIP。它适合希望统一多个编码助手行为的个人或团队,但没有提供托管服务、模型 API 或自身的智能体执行引擎。
项目通过 AGENTS.md 提供与具体项目无关的基础规则,通过 user/AGENTS.md 保存用户层面的协作偏好,并在 skills/<skill>/SKILL.md 中定义可复用技能。编码助手读取这些文件后,依照所选技能执行规划、文档与文案编写、变更范围控制、工作树 PR 准备,或向 Codex CLI、Antigravity CLI、Grok Build 委派任务。gh skill install scarletkc/agents 和 npx skills add scarletkc/agents 用于浏览并安装技能;对应命令也支持指定单个技能和目标助手。python scripts/package_skill.py <skill> 会生成 dist/<skill>.zip,其根目录包含 SKILL.md 及支持文件,并排除根级 evals/ 和本地构建产物。修改共享任务运行时后,python scripts/sync_agent_runtime.py 可同步各 CLI 技能内置的运行时副本。
- 同时使用 Codex CLI 和 Claude Code 的开发者,希望两者遵循同一套项目协作与编码规范。
- 维护多个代码仓库的团队,需要以基础
AGENTS.md为模板,再为每个项目补充结构、命令和领域说明。 - 只想安装某一项工作流的用户,例如用
scoped-change限制改动范围,或用ask-to-plan把模糊需求整理成实施计划。 - 产品或技术写作者,需要在
product-writing与规则更细的ux-writing之间选择合适的编辑指南。 - 需要向支持技能上传的网页应用分发技能的维护者,希望生成包含
SKILL.md和配套文件的 ZIP 包。 - 使用 CLI 委派工作流的开发者,需要面向 Codex CLI、Antigravity CLI 或 Grok Build 的专用技能。
如何安装或部署这个 Agent?
需要可执行 shell、网络访问和可写的技能安装目录。仓库未说明任何模型 API 密钥要求。使用 GitHub CLI 交互式浏览并为当前用户安装到 Codex:gh skill install scarletkc/agents --agent codex --scope user。非交互式安装单个技能:gh skill install scarletkc/agents <skill> --agent codex --scope user。也可使用支持 npx 的环境交互式全局安装:npx skills add scarletkc/agents -g;指定技能与助手时运行:npx skills add scarletkc/agents --skill <skill> --agent codex -g -y。命令中的 codex 可替换为其他受支持的助手,例如 claude-code。
如何使用这个 Agent?
安装前先查看技能列表并选择所需技能;每个技能的完整触发条件和操作说明位于对应的 skills/<skill>/SKILL.md。项目级使用时,将仓库根目录的 AGENTS.md 复制到目标代码仓库,并在其前面加入该项目的结构、命令和领域说明;用户偏好则参考独立的 user/AGENTS.md。安装后,在所选编码助手中提出符合技能触发描述的任务,让助手读取并遵循相应 SKILL.md。更新通过 GitHub CLI 安装的全部技能可运行 gh skill update --all;更新 skills CLI 的全局技能可运行 npx skills update -g -y。如需上传包,运行 python scripts/package_skill.py <skill>,然后使用生成的 dist/<skill>.zip。
这个 Agent 有哪些优点和局限?
- 同时提供项目级规范、用户级协作偏好和独立技能,便于按不同作用域复用配置。
- 明确支持 Codex CLI、Claude Code,并采用其他能读取
AGENTS.md或SKILL.md的工具也可消费的文件格式。 - 技能覆盖规划、范围控制、写作、营销内容、工作树 PR 和多种 CLI 委派场景,而非只提供单一提示词。
- 提供两套可选择单项技能的安装命令,以及生成独立 ZIP 的打包脚本。
- CLI 技能自带共享任务运行时,仓库还用同步脚本和测试检查副本是否与维护源一致。
- 它不是独立智能体或托管服务,实际执行能力取决于读取这些文件的外部编码助手或 CLI。
- 不同助手是否完整支持全部技能语义没有逐项兼容性说明;除 Codex CLI 和 Claude Code 外,其他工具需自行确认。
- 安装依赖 GitHub CLI 或支持
npx的 skills CLI,并需要网络与本地文件写入权限。 - 打包与运行时同步使用 Python 脚本,但来源未给出 Python 版本或完整环境要求。
- README 只提供技能摘要;采用前仍需逐项审阅每个
SKILL.md的触发条件和详细指令。
这个 Agent 与同类方案有什么区别?
product-writing 是面向产品文案和技术文档的精简指南,保留更多结构与编辑选择;ux-writing 规则更详细,适合需要更严格清晰度、一致性和状态检查的任务。仓库建议同一任务选择其中一个,而不是同时使用。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agents 共享规范与技能库 当前 | 73 · 存在缺口 | Agent 插件 / 技能免费 | ★ 227 | 6 天前 | Python | Codex · Claude Code |
| Code Abyss:编码助手人格与工程技能套件 | 60 · 存在缺口 | 命令行工具 | ★ 245 | 3 个月前 | JavaScript | Codex · Claude Code |
| oh-my-agent 多智能体开发框架 | 60 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.4k | 今天 | TypeScript | Codex · Claude Code |
| Spec Kit 多运行时技能集 | 53 · 缺口较多 | Agent 插件 / 技能 | ★ 172 | 6 天前 | Shell | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
AGENTS.md 要求避免提交凭据、清理路径与不可信输入,并将凭据放在专用配置通道;Devin 技能限定为单次授权且默认拒绝若干高影响操作,Antigravity 技能也反对用跳过权限绕过审批。README 提供安装与更新命令,便于用户了解外部操作。扣分在于这些是指引而非强制控制;所给材料没有完整说明所有技能的数据流、敏感数据处理和依赖审查机制。
AGENTS.md 要求错误可见、避免静默降级并覆盖失败路径;多个离线代理夹具模拟认证失败、超时、权限拒绝、格式错误和非零退出,CI 则列出测试与校验步骤,整体相互支持。扣分在于夹具样例不等于实际运行结果,且所给技能文件截断或仅为样本,无法核对全仓库的一致性。
技能覆盖规划访谈、文案、UX、范围控制、工作树和多种外部编码代理,README 说明目标受众包含 Claude Code、Codex CLI 及读取相关格式的其他代理。描述普遍细分触发场景与不适用条件,也给出 Python 版本、已安装认证等环境前提。扣分在于不同代理环境的兼容细节在本样本中并不完整。
README 按基础指南、用户偏好与技能目录组织内容,列出技能索引、安装、更新、打包、贡献和反馈方式;LICENSE 为 Apache-2.0,README 指向 NOTICE。扣分在于样本没有展示版本策略或变更日志,也无法确认命名与目录规则在完整仓库中的稳定性;安装说明涵盖 CLI,但未见所有代理的安装细节。
每个技能给出针对具体任务的指导;README 提供可执行的安装、更新和打包命令,CLI 技能则描述启动、跟进及检查结果的方法,预期输出较易使用。共享技能可减少重复设置,但是否节省成本或相对其他指南具有多少增益,材料未作比较或量化,因此不满分。
README 的技能目录指向各自 SKILL.md,文档中的安装步骤、运行约束及错误处理可追溯;CI 工作流列明测试、目录校验和技能发布干运行,离线夹具提供了多种失败场景作为支持。扣分在于这些文件不能证明 CI 实际通过;声明与夹具只在部分流程上互相佐证,且当前样本不完整。
- 这是低置信度的静态抽样审查;未执行测试,也未核验未提供的文件。
- 技能包含调用外部 CLI、访问工作区及可能触发工具权限请求的操作;使用者应按各技能说明核对权限、工作目录和输出。
常见问题
它会自行运行代码或调用模型 API 吗?
需要 API 密钥或付费服务吗?
可以只安装一个技能吗?
<skill>,skills CLI 则支持 --skill <skill>。如何避免项目规范与个人偏好混在一起?
AGENTS.md 中;个人协作偏好使用单独的 user/AGENTS.md。技能安装失败时有哪些已知排查步骤?
npx 环境以及目标目录写权限;其他失败模式需通过仓库 Issues 反馈。谢谢反馈,我们会据此改进页面。