Agents 共享规范与技能库
为多种 AI 编程助手复用协作规范、写作指南和任务技能。
- Star 数
- ★ 222
- 最近更新
- 5 天前
- License
- Apache-2.0
- 主语言
- Python
- FA 评分
- 50/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 开始前需要
- 典型场景
- 同时使用 Codex CLI 和 Claude Code 的开发者，希望两者遵循同一套项目协作与编码规范。
- 主要局限
- 它不是独立智能体或托管服务，实际执行能力取决于读取这些文件的外部编码助手或 CLI。
这个 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 共享规范与技能库 当前 | 50 · 缺口较多 | ★ 222 | 5 天前 | Python | Codex · Claude Code |
| oh-my-agent 多智能体开发框架 | 48 · 缺口较多 | ★ 1.3k | 今天 | TypeScript | Codex · Claude Code |
| Self-Learning Skills | 56 · 缺口较多 | ★ 959 | 9 天前 | — | Codex · Claude Code |
| Finding-Unknowns Skills | 76 · 表现良好 | ★ 338 | 7 天前 | Python | Claude Code · Claude.ai |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
CI 明确将权限限制为 contents: read，安装方式允许选择单个技能，测试夹具也覆盖权限拒绝与认证失败；但所给材料没有系统说明各技能的数据流、敏感信息处理、网络访问或实际命令权限。外部 CLI、npx 包和 GitHub Actions 仅使用版本标签而非不可变提交，供应链控制较薄。工作树技能暗示一定隔离和恢复能力，但没有通用回滚流程。Apache-2.0、仓库归属和 NOTICE 路径提供了较好的来源线索，不过 NOTICE 内容未提供，发布者身份仍未知。
README 的目录、安装命令和打包说明相互一致；同步测试验证各独立技能携带的运行时副本与规范源一致。离线夹具覆盖启动挂起、错误 JSON、进程退出、超时、权限拒绝、错误会话及子进程等多种失败，并包含具体错误文本，因此失败消息处理有实质证据；但实际运行时和主要测试文件未提供，无法确认这些场景最终都被正确处理。外部 gh、npx、Python、Claude Code、Codex CLI、Grok 和 Antigravity 的可用性及版本要求没有完整说明。
材料清楚面向多种 AI 编码代理，并区分项目级、用户级规则以及写作、规划、变更控制、委派和工作树等场景。各技能摘要给出了大致能力边界，README 也解释了 product-writing 与 ux-writing 的选择关系；但完整 SKILL.md 未提供，无法审核触发条件是否精确、是否存在重叠或误触发。多代理和两种安装器体现了一定环境适配性，但缺少支持版本、操作系统差异和兼容性矩阵。
README 的内容索引、技能表、安装、打包、贡献和许可结构清楚，信息架构可获满分。安装示例同时覆盖交互式和非交互式路径，但没有明确前置条件、卸载或故障排查。命名总体一致，并有自动检查目录的工作流；不过没有稳定性或弃用政策。示例主要集中于命令行，FAQ 和完整限制说明缺失。Apache-2.0 正文完整且 README 指向 NOTICE。没有版本发布或变更日志证据；维护渠道仅明确 GitHub Issues 和 PR，责任人、支持承诺及发布流程不明。
技能目录、可选安装、独立打包和跨代理设计使产物较容易采用，且共享标准与可复用运行时相对复制零散提示具有明确增量价值。测试夹具表明 CLI 委派技能考虑了复杂进程和协议边界；但未提供真实输出样例、用户成果比较、评测结果或采用成效。安装会引入外部 CLI、包下载和维护成本，而材料没有量化这些成本或说明何时收益不足。
主要功能声明可追溯到明确的仓库路径、命令和 CI 检查；README 目录由技能元数据生成并由工作流校验，运行时同步声明也有专门测试交叉支撑。夹具提供了具体协议事件和失败场景，而不是笼统宣称。扣分原因是完整技能正文、规范运行时、主测试套件、NOTICE 和执行结果均未提供，因此部分声明只能确认存在验证机制，不能静态确认最终行为。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 这是低置信度的静态审查；未执行测试、安装器或任何技能。
- 安装前应逐项审阅对应 SKILL.md、捆绑运行时及其网络、文件和命令权限；这些关键文件未在证据中提供。
- gh skill、npx skills 以及基于标签的 GitHub Actions 会引入外部供应链依赖；在受控环境中应固定并验证具体版本或提交。
- 不要把离线失败夹具视为测试已通过的证明；所给材料没有实际 CI 结果或完整测试实现。
- 发布者未获企业注册表验证；这表示身份未知，不表示恶意，但采用方应自行核验维护者和 NOTICE 信息。
常见问题
它会自行运行代码或调用模型 API 吗？
需要 API 密钥或付费服务吗？
可以只安装一个技能吗？
<skill>，skills CLI 则支持 --skill <skill>。如何避免项目规范与个人偏好混在一起？
AGENTS.md 中；个人协作偏好使用单独的 user/AGENTS.md。技能安装失败时有哪些已知排查步骤？
npx 环境以及目标目录写权限；其他失败模式需通过仓库 Issues 反馈。