Star0
0
代码
代码
Issues
Pull Requests
Actions
项目讨论
Wiki
分析
Star0
0
cann-robotcann-robot[feat]新增仓内AI贡献流程skill（.agents/skills/hcomm-contribute）
e6baa296创建于 9 天前历史提交
文件最后提交记录最后更新时间
skills
[feat]新增仓内AI贡献流程skill（.agents/skills/hcomm-contribute） Co-authored-by: yanzhenghang<625612333@qq.com> # message auto-generated for no-merge-commit merge: !4945 merge feat/agents-contribute-skill into master [feat]新增仓内AI贡献流程skill（.agents/skills/hcomm-contribute） Created-by: yanzhenghang Commit-by: yanzhenghang Merged-by: cann-robot Description: ## 描述 为贡献者（AI Agent 或人工）提供仓内标准的贡献流程工作流。关联需求见 Issue #807。 新增 .agents/skills/hcomm-contribute/（贡献流程 skill，与已合入的 hcomm-review 检视 skill 配对）： | 文件 | 内容 | |------|------| | SKILL.md | 贡献流程八步（代码获取与更新→依赖环境确认→本地构建与测试→Issue 查重创建→PR 创建提交并自动触发 CI→CI 监控→CI 失败修复→检视意见处置）+ 清理；每个子流程可独立运行；首次配置引导与执行纪律 | | references/README.md | 参考文档索引（按场景加载） | | references/gitcode-api.md | GitCode API 端点、认证、PR/Issue 创建语义、CI 标签流转与 saw_running 终态判定、错误码与已验证行为规律 | | references/ci-triage.md | CI 失败诊断：常见失败模式表、codecheck G.* 规则与修复模式清单、已知非阻塞判定 | | scripts/contribute.py | 贡献辅助脚本（Python 3.7+ 纯标准库）：环境校验 / 仓库同步（clone、fetch、脏工作区自动 worktree 隔离）/ Issue 查重与创建（标题关键词匹配，已有复用）/ PR 提交（git 身份校验 + push fork + 创建或复用 PR + 自动评论 /compile + GET 回查）/ CI 状态轮询（saw_running 状态机防旧标签误判）/ CI 失败日志获取（OBS 直链免登录）/ 未处理检视意见列表 / worktree 与临时文件清理 | | scripts/test_contribute.py | 单元测试（55 用例，mock git 仓 + mock API，无网络依赖） | | .agents/README.md | 仓内两个 AI skill（contribute/review）的简介与使用指引 | 另：根 AGENTS.md 末尾新增一行——贡献链路操作使用本 skill，本地构建与测试命令以 AGENTS.md 第 4 节与 build.md 为准。 **设计原则**：SKILL.md 只固化通用工作流；构建命令、依赖版本、编码规范不复制进 skill，从仓内 AGENTS.md 与 docs/zh/build/build.md 动态获取（规范演进自动跟随，无双源漂移）。与 hcomm-review skill 分工互补：review 管检视，contribute 管贡献链路；检视意见修复后的线程回复复用 review skill 的 --dispose。 ## 变更类型 - [x] ✨ 新特性 ## 关联的Issue #807 ## 测试 已完成的测试用例和场景： 1. 单元测试 54 用例双平台全绿：Windows（Python 3.14）与 WSL Ubuntu（Python 3.10），运行方式 python3 -m unittest test_contribute，无网络依赖（mock git 仓 + mock API，覆盖仓库同步三态、Issue 查重命中/未命中、PR 创建/422 复用、CI 状态机含 stale 标签防误判、检视意见列表、翻页防护、环境校验） 2. 真实只读验证：--check-env（token/remote/身份全通过）、--ci-status（真实 PR 标签与 GitCode 页面一致）、--list-review-comments（真实 PR 14 条未处理检视意见正确识别，含文件路径与行号） 3. **本 PR 自身作为 dogfooding 实测**：Issue #807 由本 skill --issue-ensure 创建（自动查重无重复 + 自动加【需求】前缀）；重复运行验证查重复用生效；本 PR 由本 skill --submit-pr 提交（push fork + PR 创建 + 自动 /compile 触发 + GET 回查全链路） 4. 检视意见修复轮（skill 深度自检 10/11 条实证意见全部修复：sync 二次运行/本地提交保护/v5 单条接口补路径/fork 绑定 token 账号/stale 退出/issue 自动关联/force-with-lease 设防等），测试增至 54 用例 5. 按需配置改进：纯 clone 用户（不提交 PR）免 token（check-env 降 WARN）；AGENTS.md 索引移入贡献流程章节；ci-triage 扩充 C++ 场景失败模式 6. 环境坑指引轮：Step 2/3 补充实测环境坑（UT 的 aicpu 前置须 --pkg --full 并安装 CANN、rootinfo 残留排查、WSL source 姿势、CANN 符号落后判别），ci-triage 新增「环境坑」节；本地构建/UT/ST 在 x86 环境实测 100% 通过（60/60、12/12），全部失败模式均有 master 基线对照排除 6. 一轮 CI codecheck 失败（8 条告警：G.ERR.09 父子异常同捕 / G.CLS.06 方法排列 ×4 / G.FMT.03 空行 ×3）已全部修复，修复模式同步沉淀进 references/ci-triage.md；修复后单测双平台回归全绿 5. CI ci-pipeline-passed 补充的UT用例： scripts/test_contribute.py（54 用例：URL 归一化 / remote 探测 / 布局探测 / sync-repo 三态 / Issue 关键词与查重 / submit-pr 全链路与 422 复用与拒绝条件 / CI 状态机 7 态 / 流水线链接解析 / OBS 日志下载与 404 容忍 / 检视意见列表与过滤 / cleanup / token 优先级 / 翻页防护 5 例） ## 文档更新 本 PR 即文档与工具新增；另修改根 AGENTS.md 新增一行贡献流程 skill 索引。 ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md） - [x] 🏷️ 标题中使用了合适的类型标签（[feat]） - [x] 📄 代码修改内容已简要描述 - [x] 🛠️ 纯新增 .agents/ 下文档与 python 脚本 + AGENTS.md 一行索引，不触碰 src/include/pkg_inc，无 C++ 代码变更 See merge request: cann/hcomm!4945
9 天前
README.md
[feat]新增仓内AI贡献流程skill（.agents/skills/hcomm-contribute） Co-authored-by: yanzhenghang<625612333@qq.com> # message auto-generated for no-merge-commit merge: !4945 merge feat/agents-contribute-skill into master [feat]新增仓内AI贡献流程skill（.agents/skills/hcomm-contribute） Created-by: yanzhenghang Commit-by: yanzhenghang Merged-by: cann-robot Description: ## 描述 为贡献者（AI Agent 或人工）提供仓内标准的贡献流程工作流。关联需求见 Issue #807。 新增 .agents/skills/hcomm-contribute/（贡献流程 skill，与已合入的 hcomm-review 检视 skill 配对）： | 文件 | 内容 | |------|------| | SKILL.md | 贡献流程八步（代码获取与更新→依赖环境确认→本地构建与测试→Issue 查重创建→PR 创建提交并自动触发 CI→CI 监控→CI 失败修复→检视意见处置）+ 清理；每个子流程可独立运行；首次配置引导与执行纪律 | | references/README.md | 参考文档索引（按场景加载） | | references/gitcode-api.md | GitCode API 端点、认证、PR/Issue 创建语义、CI 标签流转与 saw_running 终态判定、错误码与已验证行为规律 | | references/ci-triage.md | CI 失败诊断：常见失败模式表、codecheck G.* 规则与修复模式清单、已知非阻塞判定 | | scripts/contribute.py | 贡献辅助脚本（Python 3.7+ 纯标准库）：环境校验 / 仓库同步（clone、fetch、脏工作区自动 worktree 隔离）/ Issue 查重与创建（标题关键词匹配，已有复用）/ PR 提交（git 身份校验 + push fork + 创建或复用 PR + 自动评论 /compile + GET 回查）/ CI 状态轮询（saw_running 状态机防旧标签误判）/ CI 失败日志获取（OBS 直链免登录）/ 未处理检视意见列表 / worktree 与临时文件清理 | | scripts/test_contribute.py | 单元测试（55 用例，mock git 仓 + mock API，无网络依赖） | | .agents/README.md | 仓内两个 AI skill（contribute/review）的简介与使用指引 | 另：根 AGENTS.md 末尾新增一行——贡献链路操作使用本 skill，本地构建与测试命令以 AGENTS.md 第 4 节与 build.md 为准。 **设计原则**：SKILL.md 只固化通用工作流；构建命令、依赖版本、编码规范不复制进 skill，从仓内 AGENTS.md 与 docs/zh/build/build.md 动态获取（规范演进自动跟随，无双源漂移）。与 hcomm-review skill 分工互补：review 管检视，contribute 管贡献链路；检视意见修复后的线程回复复用 review skill 的 --dispose。 ## 变更类型 - [x] ✨ 新特性 ## 关联的Issue #807 ## 测试 已完成的测试用例和场景： 1. 单元测试 54 用例双平台全绿：Windows（Python 3.14）与 WSL Ubuntu（Python 3.10），运行方式 python3 -m unittest test_contribute，无网络依赖（mock git 仓 + mock API，覆盖仓库同步三态、Issue 查重命中/未命中、PR 创建/422 复用、CI 状态机含 stale 标签防误判、检视意见列表、翻页防护、环境校验） 2. 真实只读验证：--check-env（token/remote/身份全通过）、--ci-status（真实 PR 标签与 GitCode 页面一致）、--list-review-comments（真实 PR 14 条未处理检视意见正确识别，含文件路径与行号） 3. **本 PR 自身作为 dogfooding 实测**：Issue #807 由本 skill --issue-ensure 创建（自动查重无重复 + 自动加【需求】前缀）；重复运行验证查重复用生效；本 PR 由本 skill --submit-pr 提交（push fork + PR 创建 + 自动 /compile 触发 + GET 回查全链路） 4. 检视意见修复轮（skill 深度自检 10/11 条实证意见全部修复：sync 二次运行/本地提交保护/v5 单条接口补路径/fork 绑定 token 账号/stale 退出/issue 自动关联/force-with-lease 设防等），测试增至 54 用例 5. 按需配置改进：纯 clone 用户（不提交 PR）免 token（check-env 降 WARN）；AGENTS.md 索引移入贡献流程章节；ci-triage 扩充 C++ 场景失败模式 6. 环境坑指引轮：Step 2/3 补充实测环境坑（UT 的 aicpu 前置须 --pkg --full 并安装 CANN、rootinfo 残留排查、WSL source 姿势、CANN 符号落后判别），ci-triage 新增「环境坑」节；本地构建/UT/ST 在 x86 环境实测 100% 通过（60/60、12/12），全部失败模式均有 master 基线对照排除 6. 一轮 CI codecheck 失败（8 条告警：G.ERR.09 父子异常同捕 / G.CLS.06 方法排列 ×4 / G.FMT.03 空行 ×3）已全部修复，修复模式同步沉淀进 references/ci-triage.md；修复后单测双平台回归全绿 5. CI ci-pipeline-passed 补充的UT用例： scripts/test_contribute.py（54 用例：URL 归一化 / remote 探测 / 布局探测 / sync-repo 三态 / Issue 关键词与查重 / submit-pr 全链路与 422 复用与拒绝条件 / CI 状态机 7 态 / 流水线链接解析 / OBS 日志下载与 404 容忍 / 检视意见列表与过滤 / cleanup / token 优先级 / 翻页防护 5 例） ## 文档更新 本 PR 即文档与工具新增；另修改根 AGENTS.md 新增一行贡献流程 skill 索引。 ## 合入检查 - [x] 🧐 已经详细阅读了贡献指南（CONTRIBUTING.md） - [x] 🏷️ 标题中使用了合适的类型标签（[feat]） - [x] 📄 代码修改内容已简要描述 - [x] 🛠️ 纯新增 .agents/ 下文档与 python 脚本 + AGENTS.md 一行索引，不触碰 src/include/pkg_inc，无 C++ 代码变更 See merge request: cann/hcomm!4945
9 天前
README

hcomm 仓内 AI Skill 简介

hcomm 仓内置两个 .agents/skills/ 下的 skill。opencode、codex、deepseek-harness 等 agent 工具直接把代码仓目录设为项目目录即可使用——对 AI 说一句话自动执行全流程。

贡献流程 skill（.agents/skills/hcomm-contribute/）

对 AI 说「贡献 issue #123 修复」「提交 PR」「CI 修复」「处理检视意见」「本地编译并跑 UT」等指令，自动执行全流程。支持人工与 AI 触发；Issue/PR 自动查重，不会重复立项或提交重复 PR。

主要功能：自动同步代码（脏工作区自动 worktree 隔离），按 AGENTS.md 本地构建与测试，Issue 查重与创建，fork 提交 PR 并自动评论 /compile 触发 CI，轮询 CI 状态（saw_running 防旧标签误判），CI 失败日志获取，未处理检视意见列表，现场清理。

效果：贡献一个 PR 只需一句话，免手工同步、查重、触发 CI、轮询；检视意见修复后配合 review skill 的处置能力回复关闭，形成检视闭环。

PR 检视 skill（.agents/skills/hcomm-review/）

对 AI 说「检视 PR123」自动执行全流程。CI 门禁触发和人工触发都支持，不会提交重复或相似的检视意见。

主要功能：自动拉取 PR 到隔离 worktree，按仓内规范多维检视，检视意见按行提交到 GitCode 正确代码行（自动行号验证、与已有评论去重），最后发汇总报告并清理现场。

效果：免手工比对行号与逐条发评论，检视一个 PR 只需一句话；检视意见修复后还能回复关闭提交的检视意见，形成检视闭环。

必要 harness（两个 skill 通用结构）

路径 说明
SKILL.md 通用工作流（contribute 八步 / review 五步），构建命令动态取自仓内 AGENTS.md，无双源漂移
scripts/ 机械步骤固化脚本（环境校验/同步/Issue/PR/CI/清理；行号验证/评论提交/去重）
references/ 按需加载的规范与 API 文档（gitcode-api.md、ci-triage.md；检视规范五类分档见 review skill）