Jenkins Skills
Jenkins job and build operations
Rank
62
Safety
84
Downloads
2.5k
Updated
Oct 9, 2026
Version
0.1.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.5K downloadsadoption · observed Oct 9, 2026
- Latest release
- 0.1.1release · observed Oct 8, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jenkins-ci-skill- Install using `clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jenkins-ci-skill` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/weiguang1017/jenkins-ci-skill before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/snapshot"
Documentation
CLAWHUB
27,259 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: jenkins-skills description: Manage Jenkins CI from the command line — list jobs, inspect a job, trigger builds (with or without parameters), check build status, stream console logs, and enable/disable jobs. Use whenever the user wants to run a Jenkins job, check whether a build passed, read build logs, or pause/resume a job. 中文触发场景:列 Jenkins 任务、触发构建、查构建状态、看控制台日志、禁用/启用任务。 --- # Jenkins 技能(命令行实操) 通过 Jenkins Remote API 操作 Jenkins,入口是单一自包含的 Python CLI:`scripts/jenkins_cli.py`。 脚本自动处理 CSRF crumb 与文件夹嵌套的任务路径。License: MIT。 ## 何时使用 用户提出以下需求时调用本技能: - 列出任务,或查看某个任务最近一次构建 - 触发构建("跑一下部署任务",带参数或不带参数) - 查构建状态("上次构建过了吗") - 读控制台输出("把失败那次的日志给我") - 禁用或启用任务 ## 环境配置(首次) 连接信息从环境变量读取,或放在配置文件 `~/.devops-skills/jenkins.json`。 **禁止把 token 直接写在命令行参数里。** ```bash export JENKINS_URL="https://jenkins.example.com" export JENKINS_USER="your-user" export JENKINS_TOKEN="<api-token>" # User → Configure → API Token ``` ## 运行方式 脚本依赖 `requests`。本机受管 Python 环境已安装(requests 2.34.2),**推荐直接用绝对路径调用**, 避免默认的 `python3` 缺少依赖而失败: ```bash PY=~/.workbuddy/binaries/python/envs/default/bin/python # 若报 Missing dependency,用同一个解释器装: # $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/ ``` 任务名可以带文件夹层级,例如 `team/app/main`(脚本会自行拼出路径)。 ```bash $PY scripts/jenkins_cli.py list-jobs $PY scripts/jenkins_cli.py job-info team/app $PY scripts/jenkins_cli.py build team/app $PY scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod $PY scripts/jenkins_cli.py build-status team/app # 最近一次构建 $PY scripts/jenkins_cli.py build-status team/app --number 42 $PY scripts/jenkins_cli.py console team/app --tail 100 $PY scripts/jenkins_cli.py disable team/app $PY scripts/jenkins_cli.py enable team/app ``` 除 `console` 输出原始日志外,其余命令都输出 JSON 到 stdout,失败时非零退出码。 ## 兼容性 - Jenkins 2.60+ 执行命令前会读取 `/api/json` 的 `X-Jenkins` 响应头做版本校验,低于 2.60 会输出明确的兼容性提示并退出。 确需绕过时可设 `JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。 ## 注意事项 - 开启 CSRF 防护时,POST 类操作会自动先取 crumb。 - `build` 返回的是队列 URL,构建号要等它出队才有——之后用 `build-status` 轮询。 - 必须用 **API Token**,不要用账号密码。 - `build` / `disable` 属于 🟡 级变更(尤其 `disable` 会停掉别人的构建),执行前跟用户确认任务名与参数。 ## 详细文档 完整的配置方式、字段说明与排错见 `references/USAGE.md`。 ## 联系与支持 Jenkins 任务、流水线、权限、Agent 或更广泛的 DevOps 与研发效能问题需要人工支持时联系: 📧 [email protected] | 🌐 https://www.restartx.top
README.md
# Jenkins CI Skill [English](#english) | [中文](#chinese) <a id="english"></a> ## English Manage Jenkins jobs and builds through the Jenkins Remote API. The Python CLI lists jobs, reads job and build status, triggers regular or parameterized builds, reads console output, and enables or disables a job. It handles CSRF crumbs and folder-nested job paths. ### Compatibility - Jenkins 2.60+ - Python 3.8+ and `requests` Before normal execution, the CLI reads `/api/json` and checks the `X-Jenkins` response header. Jenkins below 2.60 fails with a clear compatibility error. ### Quick Start ```bash pip install requests export JENKINS_URL="https://jenkins.example.com" export JENKINS_USER="your-user" export JENKINS_TOKEN="<api-token>" python scripts/jenkins_cli.py list-jobs python scripts/jenkins_cli.py build-status team/example --number 42 ``` Use `~/.devops-skills/jenkins.json` for local configuration if preferred. Keep the file out of version control and protect it with permissions `600`. ### Common Commands | Task | Command | | --- | --- | | List jobs | `python scripts/jenkins_cli.py list-jobs` | | Read job details | `python scripts/jenkins_cli.py job-info team/app` | | Trigger a build | `python scripts/jenkins_cli.py build team/app` | | Trigger with parameters | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` | | Read build status | `python scripts/jenkins_cli.py build-status team/app --number 42` | | Read console output | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` | | Disable or enable a job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` | ### Permissions and Safety Read operations need Job/Read on the target job. Triggering builds needs Job/Build; enabling or disabling a job needs Job/Configure. This skill does not need Overall/Administer, credential management, plugin management, or node management. Trigger builds and change job state only in approved, non-production jobs. ### Documentation and Support - Agent instructions: [SKILL.md](./SKILL.md) - Detailed Chinese manual: [使用手册.md](./使用手册.md) - Support: https://service.restartx.top/ RestartX provides technical support and implementation services for Jenkins, CI/CD, build stability, DevOps platform, and engineering-efficiency needs. <a id="chinese"></a> ## 中文 通过 Jenkins Remote API 管理 Job 和构建。Python CLI 支持列出 Job、查看 Job 与构建状态、 触发普通或参数化构建、读取控制台日志、启用或禁用 Job,并自动处理 CSRF crumb 和文件夹嵌套 Job 路径。 ### 兼容性 - Jenkins 2.60+ - Python 3.8+ 与 `requests` 脚本会在正常执行前读取 `/api/json` 并检查 `X-Jenkins` 响应头。Jenkins 低于 2.60 时会给出 明确的不兼容错误并停止执行。 ### 快速开始 ```bash pip install requests export JENKINS_URL="https://jenkins.example.com" export JENKINS_USER="your-user" export JENKINS_TOKEN="<api-token>" python scripts/jenkins_cli.py list-jobs python scripts/jenkins_cli.py build-status team/example --number 42 ``` 也可使用本地配置文件 `~/.devops-skills/jenkins.json`。文件不能提交到版本库,权限建议设为 `600`。 ### 常用命令 | 功能 | 命令 | | --- | --- | | 列出 Job | `
_meta.json
{
"ownerId": "kn7abv05p1jqkcnmnmkdpdex9581nt3f",
"slug": "jenkins-ci-skill",
"version": "0.1.1",
"publishedAt": 1791447070405
}references/USAGE.md
# Jenkins Skills 配置与使用手册
通过一个 Python CLI 操作 Jenkins,覆盖任务列表、触发构建、查看状态与日志、启停任务,自动处理 CSRF crumb 和文件夹嵌套任务。
---
## 一、环境要求
- Python 3.8 及以上
- `pip install requests`
- Jenkins 2.60 及以上
脚本会在执行命令前访问 `/api/json` 并读取 `X-Jenkins` 响应头判断版本;若 Jenkins
低于 2.60,会给出明确的不兼容提示。确需跳过检查时,可设置
`JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。
---
## 二、获取 API Token
1. 登录 Jenkins → 右上角用户名 → **Configure(设置)**。
2. 找到 **API Token** → **Add new Token** → 生成并复制(只显示一次)。
3. 自动化请使用 **API Token**,不要用账号登录密码。
---
## 三、配置连接信息(二选一)
### 方式 A:环境变量
```bash
export JENKINS_URL="https://jenkins.example.com"
export JENKINS_USER="你的用户名"
export JENKINS_TOKEN="你的API Token"
```
### 方式 B:配置文件 `~/.devops-skills/jenkins.json`
```json
{
"url": "https://jenkins.example.com",
"user": "你的用户名",
"token": "你的API Token"
}
```
> `chmod 600 ~/.devops-skills/jenkins.json`,切勿提交到仓库。
---
## 四、命令速查
> 任务名 `name` 支持文件夹嵌套,如 `team/app/main`(脚本自动拼 `/job/.../job/...`)。
| 功能 | 命令 |
| --- | --- |
| 列出任务 | `python scripts/jenkins_cli.py list-jobs` |
| 查看任务信息 | `python scripts/jenkins_cli.py job-info team/app` |
| 触发构建 | `python scripts/jenkins_cli.py build team/app` |
| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |
| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |
| 查看构建日志 | `python scripts/jenkins_cli.py console team/app --tail 100` |
| 禁用任务 | `python scripts/jenkins_cli.py disable team/app` |
| 启用任务 | `python scripts/jenkins_cli.py enable team/app` |
---
## 五、使用示例
**1. 触发带参数构建并轮询结果**
```bash
python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod
# 进入队列后稍等,再查最近一次构建状态
python scripts/jenkins_cli.py build-status team/app
```
**2. 排查失败构建**
```bash
python scripts/jenkins_cli.py build-status team/app --number 42
python scripts/jenkins_cli.py console team/app --number 42 --tail 200
```
---
## 六、常见问题
| 现象 | 原因与解决 |
| --- | --- |
| `... are required` | 未配置连接信息 |
| `HTTP 401` | 用户名或 Token 错误(注意用 Token 不是密码) |
| `HTTP 403 No valid crumb` | CSRF 校验失败;脚本已自动取 crumb,若仍报错检查反向代理是否透传了 header |
| `HTTP 404` | 任务名/路径错误;嵌套任务用 `folder/job` 形式 |
| `unsupported Jenkins version ...` | Jenkins 版本低于 2.60,请升级 Jenkins 或使用旧版 skill |
| build 后拿不到构建号 | 构建在队列中,返回的是 queue_url,稍后用 `build-status` 查询 |
---
## 七、在 Claude / Claude Code 中使用
把 `jenkins-skills` 目录放入 skills 目录后,用自然语言触发:
- “跑一下 team/app 这个任务,分支用 main”
- “最近一次构建过了没”
- “把失败那次的日志最后 200 行给我看看”
---
## 八、技术支持与咨询
如果在 Jenkins 流水线、权限、Agent、构建稳定性、DevOps 平台或研发效能建设中遇到问题,
欢迎联系 RestartX 获取支持与方案咨询:https://service.restartx.top/skill-card.md
## Description: Helps agents inspect Jenkins jobs and builds, read console logs, trigger builds, and enable or disable jobs through the Jenkins Remote API. This skill is ready for commercial/non-commercial use. ## Publisher: [weiguang1017](https://clawhub.ai/user/weiguang1017) ### License/Terms of Use: MIT ## Use Case: Developers and CI operators use this skill to inspect Jenkins jobs, check build results and logs, and, with approval, trigger builds or change job availability. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: An agent with Jenkins credentials can trigger builds or enable or disable jobs without an enforced confirmation step. Mitigation: Require explicit user confirmation of the job and parameters before any change; limit changes to approved, non-production jobs. Risk: Jenkins credentials grant the agent access beyond routine job inspection if the token has write permissions. Mitigation: Use a least-privilege Jenkins token and prefer read-only credentials for inspection. ## Reference(s): - [Jenkins Skills usage guide](references/USAGE.md) - [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill) - [Server-resolved source repository](https://github.com/weiguang1017/jenkins-ci-skill) ## Skill Output: **Output Type(s):** [Text, Markdown, Shell commands, Guidance] **Output Format:** [Markdown with command examples, JSON job and build results, and plain-text log excerpts] **Output Parameters:** [1D] **Other Properties Related to Output:** [Build triggers may return a queue URL before a build number is available.] ## Skill Version(s): 0.1.1 (source: ClawHub release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T13:46:06.919Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T13:46:06.919Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.5K downloads",
"href": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T13:46:06.919Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.1",
"href": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-08T08:11:10.405Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.1",
"description": "- Major documentation update: SKILL.md fully rewritten in Chinese with improved structure and expanded usage details. - Usage, setup, compatibility, and support sections revised for clarity and accessibility to Chinese-speaking users. - All documentation about setup and troubleshooting moved to a new references/USAGE.md file. - Removed outdated files: agents, scripts, skill-card.md, 使用手册.md.",
"href": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceUrl": "https://clawhub.ai/weiguang1017/jenkins-ci-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-10-08T08:11:10.405Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
