Agent Skills
› areal-project/AReaL
areal-project/AReaL
GitHub指导如何在Archon引擎中为新HuggingFace模型架构添加支持。通过分析模型配置和源码，选择参考实现并扩展代码，以集成新的LLM模型类型。
Install All Skills
npx skills add areal-project/AReaL --all -g -y
Skills in Collection (25)
指导如何在Archon引擎中为新HuggingFace模型架构添加支持。通过分析模型配置和源码，选择参考实现并扩展代码，以集成新的LLM模型类型。
用户询问如何向Archon添加新模型
用户希望支持新的模型家族（如Llama、Mistral）
用户提到需要添加新的ModelSpec或模型类型
npx skills add areal-project/AReaL --skill add-archon-model -g -y
指导在AReaL框架中添加新数据集加载器的步骤，包括创建包含SFT和RL处理逻辑的Python文件及注册到__init__.py。
用户询问如何添加数据集
用户希望集成新数据集
用户提到创建数据集加载器
npx skills add areal-project/AReaL --skill add-dataset -g -y
指导在AReaL框架中创建和注册自定义奖励函数，包括编写Python文件、注册到模块及添加单元测试。
用户询问如何添加奖励函数
用户想要实现自定义奖励逻辑
用户提及奖励计算
npx skills add areal-project/AReaL --skill add-reward -g -y
指导在AReaL项目中添加单元测试，涵盖测试类型、文件结构、编写规范及Pytest标记与CI策略。
询问如何添加测试
希望提高测试覆盖率
为新功能编写测试
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导如何在AReaL框架中创建和注册新的RolloutWorkflow，包括编写Python类、更新模块导出及修改训练脚本入口。
用户询问如何添加工作流
用户想要创建新的RolloutWorkflow
用户提到实现自定义推出流程
npx skills add areal-project/AReaL --skill add-workflow -g -y
提供AReaL仓库的Conventional Commits提交规范，包括类型选择与基于文件路径的作用域推断规则，指导Agent生成标准化的Git提交信息。
执行git commit操作
创建Pull Request时
npx skills add areal-project/AReaL --skill commit-conventions -g -y
自动将当前分支变基至最新主干、压缩提交为单条规范Commit，并生成PR标题与正文。通过gh CLI创建或更新GitHub Pull Request，支持草稿模式及冲突处理，确保提交历史整洁。
用户要求创建或更新Pull Request
需要整理分支提交历史并发布代码
npx skills add areal-project/AReaL --skill create-pr -g -y
针对AReaL分布式训练（FSDP2/TP等）的调试指南，解决卡死、结果错误、OOM及通信异常。通过最小化复现、环境变量配置、堆栈分析及代码检查提供逐步排查方案。
分布式训练出现卡死或死锁
多节点计算结果不一致或数值错误
分布式环境下内存溢出(OOM)
NCCL通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -g -y
用于执行只读的代码审查工作流，通过分析变更风险、调用专家子代理并生成结构化报告，辅助识别PR中的缺陷与隐患。
用户请求对当前分支或特定PR进行代码审查
需要分析PR变更风险及潜在故障模式
npx skills add areal-project/AReaL --skill review-pr -g -y
将docs/en下的英文Markdown文档翻译至docs/zh目录。支持全量翻译与增量更新，保留技术术语、代码块及Markdown结构，自动处理路径校验与目录创建。
用户要求翻译英文文档为中文
指定docs/en下的文件需同步生成中文版本
npx skills add areal-project/AReaL --skill translate-doc-zh -g -y
用于升级AReaL项目依赖，验证API兼容性，更新pyproject文件、锁文件及Dockerfile，解决冲突并确保结构完整。
需要升级特定Python包版本
维护多后端推理环境的依赖一致性
npx skills add areal-project/AReaL --skill upgrade-deps -g -y
指导如何在Archon训练引擎中添加对新HuggingFace模型架构的支持，包括分析模型配置、选择参考实现及代码适配。
询问如何向Archon添加新模型
希望支持新的模型家族（如Llama、Mistral）
提及添加新的ModelSpec或模型类型
npx skills add areal-project/AReaL --skill add-archon-model -g -y
指导在AReaL框架中添加新数据集加载器。涵盖创建包含SFT和RL训练处理逻辑的Python文件，并在__init__.py中注册新数据集名称，实现数据集成与标准化加载。
用户询问如何添加数据集
用户希望集成新数据集
用户提到创建数据集加载器
npx skills add areal-project/AReaL --skill add-dataset -g -y
指导在AReaL框架中创建和注册自定义奖励函数，涵盖文件编写、模块注册、异步处理及测试用例添加。
用户询问如何添加奖励函数
需要实现自定义奖励逻辑
涉及奖励计算相关需求
npx skills add areal-project/AReaL --skill add-reward -g -y
指导在AReaL项目中添加单元测试，涵盖测试类型识别、文件结构创建、编写规范及CI策略配置，旨在提升代码覆盖率。
用户询问如何添加测试
需要为新功能编写测试
希望提高测试覆盖率
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导如何在AReaL框架中创建和注册新的RolloutWorkflow实现，包括编写异步推理逻辑、更新模块导出及配置训练脚本。
用户询问如何添加工作流
用户想要创建新的RolloutWorkflow
用户提到实现自定义 rollout
npx skills add areal-project/AReaL --skill add-workflow -g -y
提供AReaL仓库的提交信息规范，包括Conventional Commits格式、类型选择及基于文件路径的作用域推断规则，指导Agent生成符合规范的Git提交。
执行git commit操作时
创建Pull Request时
npx skills add areal-project/AReaL --skill commit-conventions -g -y
指导调试AReaL分布式训练问题，涵盖死锁、结果错误、OOM及通信错误。提供最小复现策略、环境配置、堆栈分析及具体排查步骤。
训练挂起或死锁
跨秩结果不一致或数值错误
分布式环境下的OOM错误
NCCL通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -g -y
指导如何在 Archon 训练引擎中为新 HuggingFace 模型架构添加支持。涵盖分析目标模型配置、选择参考实现及适配代码的步骤，适用于扩展新模型家族的支持。
询问如何向 Archon 添加模型
希望支持新的模型家族（如 Llama, Mistral）
提及为 Archon 添加新的 ModelSpec
npx skills add areal-project/AReaL --skill add-archon-model -g -y
指导如何在AReaL框架中创建新的数据集加载器，包括编写处理逻辑及注册模块。适用于需要集成新数据集或开发自定义数据加载功能的场景。
用户询问如何添加数据集
用户希望集成新数据集
用户提到创建数据集加载器
npx skills add areal-project/AReaL --skill add-dataset -g -y
指导如何在AReaL框架中创建、注册并测试自定义奖励函数，包括处理异步阻塞操作及编写单元测试。
用户询问如何添加奖励函数
用户想要实现自定义奖励逻辑
用户提及奖励计算相关需求
npx skills add areal-project/AReaL --skill add-reward -g -y
指导在AReaL项目中编写单元测试，涵盖测试类型识别、文件结构创建、Arrange-Act-Assert模式及Pytest标记使用，旨在提升新功能测试覆盖率。
用户询问如何添加测试
需要增加测试覆盖率
为新功能编写测试
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导如何在AReaL框架中创建和注册新的RolloutWorkflow实现。涵盖编写工作流类、在__init__.py中注册以及更新训练脚本入口，适用于需要自定义 rollout 流程的开发场景。
用户询问如何添加工作流
用户想要创建新的 RolloutWorkflow
用户提及实现自定义 rollout
npx skills add areal-project/AReaL --skill add-workflow -g -y
提供AReaL仓库的Conventional Commits提交规范，支持根据文件路径自动推断scope。用于指导Agent在git commit或创建PR时生成符合规范的提交信息，确保代码历史清晰统一。
执行git commit操作
通过create-pr命令创建PR
任何产生git提交的agent工作流
npx skills add areal-project/AReaL --skill commit-conventions -g -y
针对AReaL分布式训练（FSDP2/TP等）的调试指南，涵盖死锁、结果错误、OOM及通信异常。提供最小复现策略、环境配置、堆栈分析及具体排查步骤。
训练挂起或死锁
跨rank结果不一致或数值错误
分布式设置下的OOM错误
NCCL通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -g -y
