Skip to content
IN DEVELOPMENT集成Coding.netPython零依赖v0.2.0

Coding.net 集成

DevOps 平台自动化

零依赖 Python CLI 操作 Coding.net Open API。覆盖合并请求生命周期、CI 构建管理、制品库查询、跨项目枚举和远程文件审计——所有标准 Git 无法完成的平台操作。

Coding.net 集成
认证初始化
$./coding auth init --team my-team --token tok_xxx
OK Connected to my-team.coding.net (User: norix)
创建 MR
$./coding depot mr-create --depot-id 123 --title "feat: auth module" --src feature/auth
OK MR #42 created: feature/auth → dev
查看构建日志
$./coding ci log --project 456 --id 789
✓ Build #789 — 2m 31s — SUCCESS

核心能力

MR 生命周期

创建、合并、关闭合并请求。查看 MR diff、发表评论、列出评论。所有标准 Git 无法完成的 MR 操作。

CI 自动化

触发构建、查看构建日志、停止运行中的构建、查看构建阶段。与 Coding CI/CD 深度集成。

制品库管理

查看 Docker/npm/Maven 制品仓库。浏览包版本列表,获取下载 URL。

跨项目查询

枚举团队所有项目和仓库,按名称搜索项目,查看项目成员。无需逐个 clone。

远程文件审计

不 clone 整个仓库即可读取任意远程文件。轻量级远程代码审计和单文件修复。

分支策略

内置分支规范检测:Agent 自动识别 dev/develop/test/staging 分支,MR 始终指向最低级别集成分支。

命令参考

认证

auth — 凭证管理

命令说明示例
init非交互式初始化./coding auth init --team my-team --token tok_xxx
status检查连接状态./coding auth status
clean清除凭证./coding auth clean

代码仓库

depot — Git 仓库操作

命令说明示例
list列出仓库./coding depot list --project myproject
branches查看分支./coding depot branches --depot-id 123
file远程读文件./coding depot file --depot-id 123 --path README.md
mr-create创建 MR./coding depot mr-create --depot-id 123 --title "feat" --src feature/x
mr-merge合并 MR./coding depot mr-merge --depot-id 123 --merge-id 1
mr-diff查看 MR diff./coding depot mr-diff --depot-id 123 --merge-id 1

持续集成

ci — 构建管理

命令说明示例
jobs构建任务列表./coding ci jobs --project 456
trigger触发构建./coding ci trigger --project 456 --job 789 --ref main
log查看构建日志./coding ci log --project 456 --id 100
stop停止构建./coding ci stop --project 456 --id 100

制品库

artifact — 制品管理

命令说明示例
repos制品仓库列表./coding artifact repos --project 456 --type docker
packages包列表./coding artifact packages --project 456 --repo my-docker
versions版本列表./coding artifact versions --project 456 --repo r --pkg p
download-url下载地址./coding artifact download-url --project 456 --repo r --pkg p --version v1.0

使用场景

什么时候用本技能 vs 标准 Git

场景用什么
MR 创建/合并/关闭✅ 本技能(git 做不到)
CI 触发/查看日志/停止✅ 本技能(git 做不到)
制品库查版本/下载✅ 本技能(git 做不到)
远程读文件(不 clone)✅ 本技能(更高效)
跨项目查询✅ 本技能(git 做不到)
多文件代码开发❌ 标准 git
本地已 clone 的仓库❌ 直接读文件

Quick Start

对 Agent 说:

"帮我在 my-project 仓库创建一个 MR,从 feature/auth 合到 dev"

Agent 自动:

  1. 检查凭证 → 必要时引导初始化
  2. 检测分支模型 → 确认目标分支
  3. 创建 MR → 返回链接

分支安全策略

Agent 执行 MR 操作时必须遵守

检测分支 → 优先级: dev > develop > test > staging > main
MR 目标 → 始终指向最低级别的集成分支
禁止行为 → 直接向 master/main 建 MR(除非它是唯一分支)
分支类型命名规范示例
Featurefeature/<name>feature/add-auth
Bugfixfix/<name>fix/null-pointer
Probeprobe/<name>probe/api-test

API 协议

Coding.net 使用统一 POST 端点 + Action 路由

POST https://{team}.coding.net/open-api?Action={ActionName}
Authorization: Bearer {personal_access_token}
Content-Type: application/json
Body: { "DepotId": 123, ... }
  • 不是 REST:没有 URL 路径路由
  • 参数名大驼峰ProjectName, DepotId, MergeId
  • 响应信封{"Response": {...data}}{"Response": {"Error": {...}}}

模块架构

coding-integration/
├── coding              ← Bash CLI 入口
├── SKILL.md            ← Agent 指令文件
├── scripts/
│   ├── coding_api.py   ← 核心引擎 (HTTP + 统一 POST + Action 路由)
│   ├── auth.py         ← 凭据管理 (init / status / clean)
│   ├── depot.py        ← Git 仓库 (branches / file / MR 生命周期)
│   ├── ci.py           ← CI 构建 (trigger / log / stop / stages)
│   ├── artifact.py     ← 制品库 (repos / packages / versions / download)
│   └── project.py      ← 项目管理 (list / search / members)
├── evals/
│   └── evals.json      ← 测试用例
└── references/
    └── api_reference.md ← Coding.net Open API 参考

快速开始

Install
via skills.sh (推荐)
$npx skills add northseadl/norix-skills/coding-net-integration
或手动安装
$git clone https://github.com/northseadl/norix-skills.git
$ln -s norix-skills/coding-net-integration <SKILLS_DIR>/coding-net-integration
验证
$./coding auth status
OK Skill ready.

Built for AI Agents, by Norix