Agent Skills
› areal-project/AReaL
areal-project/AReaL
GitHub指导如何在 Archon 训练引擎中添加对 HuggingFace 新模型架构的支持。涵盖分析目标模型配置与源码、选择参考实现（如 Qwen2/3）以及生成适配代码的步骤，适用于需要扩展模型兼容性的场景。
安装全部 Skills
npx skills add areal-project/AReaL --all -g -y
集合内 Skills (25)
指导如何在 Archon 训练引擎中添加对 HuggingFace 新模型架构的支持。涵盖分析目标模型配置与源码、选择参考实现（如 Qwen2/3）以及生成适配代码的步骤，适用于需要扩展模型兼容性的场景。
用户询问如何向 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项目添加单元测试，涵盖测试类型识别、文件命名规范、Arrange-Act-Assert编写模式及Pytest标记与CI策略。
用户询问如何添加测试
用户希望提高测试覆盖率
用户需要为新功能编写测试
用户想了解AReaL的测试模式
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导用户为AReaL系统创建新的RolloutWorkflow实现。涵盖前置条件理解、编写Python工作流文件、在__init__.py中注册类以及更新训练脚本以使用新工作流的完整步骤。
用户询问如何添加工作流
用户想要创建新的RolloutWorkflow
用户提及实现自定义发布流程
npx skills add areal-project/AReaL --skill add-workflow -g -y
为AReaL仓库提供Conventional Commits提交规范，自动根据文件路径推断作用域，支持PR创建及子代理工作流，确保提交信息格式统一。
执行git commit操作时
创建Pull Request时
子代理生成提交记录时
npx skills add areal-project/AReaL --skill commit-conventions -g -y
用于为当前分支创建或更新 GitHub PR。流程包括验证环境、检查现有PR、Rebase到最新基础分支、合并本地提交并生成规范Commit信息，最后推送并创建/更新PR，同时处理冲突和强制推送确认。
用户请求为当前分支创建或更新 Pull Request
需要规范化提交信息并自动构建PR描述
npx skills add areal-project/AReaL --skill create-pr -g -y
用于调试AReaL分布式训练（FSDP2/TP/CP/EP）中的挂起、结果错误、OOM及通信问题。提供最小化复现策略，涵盖死锁排查、梯度验证、内存检查及环境配置指南。
训练挂起或死锁
多卡结果不一致或数值错误
分布式OOM报错
NCCL通信或设备网格异常
npx skills add areal-project/AReaL --skill debug-distributed -g -y
用于只读审查PR的工作流，包含风险分析、针对性检查清单及Codex专家子代理咨询。通过解析PR上下文、变更分析、制定审查计划并执行多阶段专家协作，最终输出按严重性排序的发现报告，确保代码安全与质量。
用户请求审查当前分支的Pull Request
用户指定特定PR号进行代码审查
npx skills add areal-project/AReaL --skill review-pr -g -y
将 docs/en/ 下的英文 Markdown 文档翻译至 docs/zh/。支持全量翻译与增量更新，保留技术术语、代码块及 Markdown 结构，自动创建目标目录并处理路径校验错误。
用户请求翻译英文文档
需要生成或更新 docs/zh/ 下的中文文档
npx skills add areal-project/AReaL --skill translate-doc-zh -g -y
用于升级AReaL项目的运行时依赖。支持指定包版本，处理双pyproject文件（SGLang/vLLM）的冲突与锁定，更新Dockerfile，并针对核心包进行API兼容性审计，确保结构完整性和向后兼容。
用户请求升级特定Python依赖包
需要解决多后端推理框架（SGLang/vLLM）的版本冲突
npx skills add areal-project/AReaL --skill upgrade-deps -g -y
指导如何在 Archon 训练引擎中添加对新 HuggingFace 模型架构的支持。涵盖前置条件检查、通过配置文件和源码分析目标模型的注意力、FFN、MoE 等架构细节，并选择参考实现进行适配。
用户询问如何向 Archon 添加新模型
用户希望在 ArchonEngine 中支持新的模型系列（如 Llama, Mistral）
用户提到为 Archon 添加新的 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框架中创建和注册新的奖励函数。涵盖编写奖励逻辑、在__init__.py中注册、处理异步阻塞操作及添加单元测试，适用于需要自定义奖励计算场景。
用户询问如何添加奖励函数
用户希望实现自定义奖励
用户提到奖励计算
npx skills add areal-project/AReaL --skill add-reward -g -y
指导为AReaL项目添加单元测试，涵盖测试类型、文件结构命名、Arrange-Act-Assert编写模式及Pytest标记策略。
询问如何添加测试
希望增加测试覆盖率
为新功能编写测试
了解AReaL测试模式
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规范，包含类型选择、基于文件路径的作用域推断及提交格式要求。强制在Git提交时加载，确保消息符合标准并解释变更原因。
执行git commit命令
创建PR时的提交
Agent工具调用带有skills: ["commit-conventions"]的提交
任何产生提交的Agent工作流
npx skills add areal-project/AReaL --skill commit-conventions -g -y
用于调试AReaL分布式训练（FSDP2/TP/CP/EP）问题的指南。涵盖死锁、结果错误、OOM及通信故障，提供最小复现策略、环境配置、py-spy分析及DTensor检查方法。
训练挂起或死锁
跨Rank结果不一致或数值错误
分布式设置下的OOM错误
NCCL通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -g -y
指导在 Archon 引擎中添加新 HuggingFace 模型架构的支持。适用于用户询问如何添加模型、支持新模型家族或创建 ModelSpec 时，提供从分析架构到选择参考实现的详细步骤。
用户询问如何将模型添加到 Archon
用户希望在 ArchonEngine 中支持新的模型家族
用户提到为 Archon 添加新的 ModelSpec 或模型类型
npx skills add areal-project/AReaL --skill add-archon-model -g -y
指导在AReaL框架中添加新数据集加载器。当用户询问如何添加、集成新数据集或创建加载器时触发。提供分步指南：1.创建包含SFT和RL训练处理逻辑的Python文件；2.在__init__.py中注册数据集名称及导入相关函数。
用户询问如何添加数据集
用户希望集成新数据集
用户提到创建数据集加载器
npx skills add areal-project/AReaL --skill add-dataset -g -y
指导在AReaL框架中创建和注册自定义奖励函数。涵盖编写计算逻辑、注册到__init__.py、处理异步阻塞操作及添加单元测试的完整步骤。
用户询问如何添加奖励函数
用户希望实现自定义奖励逻辑
用户提及奖励计算相关需求
npx skills add areal-project/AReaL --skill add-reward -g -y
指导在AReaL项目中添加单元测试，涵盖测试类型区分、文件命名规范、Arrange-Act-Assert编写模式及Pytest标记与CI策略。
询问如何添加测试
希望增加测试覆盖率
为新功能编写测试
了解AReaL测试模式
npx skills add areal-project/AReaL --skill add-unit-tests -g -y
指导如何在AReaL中创建新的RolloutWorkflow。涵盖编写自定义工作流类、注册到__init__.py以及更新训练脚本以使用新工作流的完整步骤。
用户询问如何添加工作流
用户希望创建新的RolloutWorkflow
用户提到实现自定义轮播
npx skills add areal-project/AReaL --skill add-workflow -g -y
为AReaL仓库提供Conventional Commits规范及基于文件路径的作用域推断规则，确保Git提交格式统一。
执行git commit命令时
创建Pull Request时
通过task代理进行提交时
npx skills add areal-project/AReaL --skill commit-conventions -g -y
用于调试 AReaL 分布式训练问题，涵盖 FSDP2/TP/CP/EP。处理训练挂起、结果错误、OOM 及通信异常。提供最小复现策略、环境配置、堆栈分析及具体修复步骤。
训练挂起或死锁
跨 Rank 结果不一致或数值错误
分布式设置下的 OOM 错误
NCCL 通信错误或设备网格问题
npx skills add areal-project/AReaL --skill debug-distributed -g -y
