Agent Skills
› areal-project/AReaL
areal-project/AReaL
GitHub指导在 Archon 训练引擎中添加新 HuggingFace 模型架构的完整流程，涵盖从分析目标模型配置、选择参考实现到代码集成的步骤。
Install All Skills
npx skills add areal-project/AReaL --all -g -y
Skills in Collection (25)
指导在 Archon 训练引擎中添加新 HuggingFace 模型架构的完整流程，涵盖从分析目标模型配置、选择参考实现到代码集成的步骤。
用户询问如何向 Archon 添加模型
需要支持新的模型家族（如 Llama, Mistral）
提及添加新的 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项目添加单元测试，涵盖测试类型、文件结构、编写规范及CI策略，适用于新增功能测试或提升覆盖率场景。
用户询问如何添加测试
需要增加测试覆盖率
为新功能编写测试
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导用户如何在AReaL框架中创建和注册新的RolloutWorkflow实现，涵盖文件创建、代码编写及入口脚本更新步骤。
询问如何添加工作流
想要创建新的RolloutWorkflow
提及实现自定义发布流程
npx skills add areal-project/AReaL --skill add-workflow -g -y
定义AReaL仓库的Commit消息规范，包括Conventional Commits格式、类型选择及基于文件路径的作用域推断规则。强制在Git提交时加载，确保提交信息标准化和一致性。
执行git commit命令
创建Pull Request
子代理生成代码提交
npx skills add areal-project/AReaL --skill commit-conventions -g -y
自动执行代码分支变基、提交压缩及规范生成，并创建或更新 GitHub Pull Request。支持草稿模式及基础分支指定，包含冲突检测与安全限制，确保 PR 创建流程标准化且安全。
用户要求创建或更新 PR
需要整理提交历史并推送至远程仓库
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
需要风险评估的合并请求审核
npx skills add areal-project/AReaL --skill review-pr -g -y
用于将 docs/en/ 下的英文 Markdown 文档翻译为对应的中文文档。支持增量更新与全量翻译，保留技术术语、代码块及结构，自动处理路径校验与目录创建。
用户请求翻译英文文档至中文
需要更新现有中文文档内容
npx skills add areal-project/AReaL --skill translate-doc-zh -g -y
用于升级AReaL项目依赖包，支持双manifest模型及多后端兼容。流程包括验证清单、更新pyproject、解析冲突、锁定依赖、更新Dockerfile并审计API兼容性，确保版本变更后的结构完整与运行稳定。
需要升级特定Python包版本
执行依赖更新和兼容性审计
npx skills add areal-project/AReaL --skill upgrade-deps -g -y
指导如何在 Archon 训练引擎中集成新的 HuggingFace 模型架构。涵盖分析模型配置、选择参考实现及适配代码生成的步骤，支持 Llama 等主流模型家族。
用户询问如何向 Archon 添加新模型
需要支持新的模型家族（如 Llama, Mistral）
提及添加新的 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项目添加单元测试，涵盖测试类型识别、文件结构创建、编写规范及CI策略配置，旨在提升代码覆盖率与质量。
询问如何添加测试
希望增加测试覆盖率
为新功能编写测试
了解AReaL测试模式
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仓库的Git提交规范，包含Conventional Commits格式、类型选择及基于文件路径的作用域推断规则。
执行git commit
创建PR时生成提交
npx skills add areal-project/AReaL --skill commit-conventions -g -y
提供AReaL分布式训练（FSDP2/TP等）的调试指南，针对卡死、结果错误、OOM及通信故障。涵盖最小化复现、环境配置、堆栈分析及具体修复步骤。
分布式训练出现卡死或死锁
多卡运行结果不一致或数值错误
分布式场景下发生内存溢出(OOM)
NCCL通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -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 项目中添加单元测试，涵盖测试类型识别、文件结构创建、编写规范及 Pytest 标记与 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 仓库的 Commit Message 规范，包含 Conventional Commits 格式、类型选择及基于文件路径的 Scope 自动推断规则。
执行 git commit
创建 PR 时生成提交信息
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
