{"id":"b4742e62-3a53-4db3-ae94-f79d4c8734aa","entityType":"agent","slug":"clawhub-weiguang1017-jenkins-ci-skill","name":"Jenkins Skills","canonicalUrl":"https://www.xpersona.co/agent/clawhub-weiguang1017-jenkins-ci-skill","canonicalPath":"/agent/clawhub-weiguang1017-jenkins-ci-skill","generatedAt":"2026-10-09T23:05:22.417Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":null},"description":"Jenkins job and build operations","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.5K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jenkins-ci-skill","sourceUrl":"https://clawhub.ai/weiguang1017/jenkins-ci-skill","homepage":"https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/weiguang1017/jenkins-ci-skill","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":68,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Jenkins Skills technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":null},"stars":null,"forks":null,"downloads":2536,"packageName":null,"latestVersion":"0.1.1","tractionLabel":"2.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T13:46:06.919Z","lastCrawledAt":"2026-10-09T13:46:06.919Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T13:46:06.919Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.1","createdAt":"2026-10-08T08:11:10.405Z","changelog":"- 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.","fileCount":9,"zipByteSize":11729},{"version":"0.1.0","createdAt":"2026-08-05T05:23:26.056Z","changelog":"Initial release of Jenkins Skills CLI for command-line Jenkins CI management. - Enables listing jobs, inspecting jobs, triggering builds (with or without parameters), checking build status, streaming console logs, and enabling/disabling jobs via CLI. - Reads Jenkins server connection info from environment variables or a config file. - Verifies server compatibility (requires Jenkins 2.60+); provides clear messages for unsupported versions. - Handles CSRF security, folder-nested jobs, and prints all outputs as JSON by default (except console logs). - Requires Python 3.8+ and the `requests` library.","fileCount":11,"zipByteSize":11452}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s178r18ph3sn297gb4d96zefvx88583r:jenkins-ci-skill","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T23:05:22.417Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-weiguang1017-jenkins-ci-skill/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":null},"readme":"Skill: Jenkins Skills\n\nOwner: weiguang1017\n\nSummary: Jenkins job and build operations\n\nTags: latest:0.1.1\n\nVersion history:\n\nv0.1.1 | 2026-10-08T08:11:10.405Z | auto\n\n- Major documentation update: SKILL.md fully rewritten in Chinese with improved structure and expanded usage details.\n- Usage, setup, compatibility, and support sections revised for clarity and accessibility to Chinese-speaking users.\n- All documentation about setup and troubleshooting moved to a new references/USAGE.md file.\n- Removed outdated files: agents, scripts, skill-card.md, 使用手册.md.\n\nv0.1.0 | 2026-08-05T05:23:26.056Z | auto\n\nInitial release of Jenkins Skills CLI for command-line Jenkins CI management.\n\n- Enables listing jobs, inspecting jobs, triggering builds (with or without parameters), checking build status, streaming console logs, and enabling/disabling jobs via CLI.\n- Reads Jenkins server connection info from environment variables or a config file.\n- Verifies server compatibility (requires Jenkins 2.60+); provides clear messages for unsupported versions.\n- Handles CSRF security, folder-nested jobs, and prints all outputs as JSON by default (except console logs).\n- Requires Python 3.8+ and the `requests` library.\n\nArchive index:\n\nArchive v0.1.1: 9 files, 11729 bytes\n\nFiles: agents/openai.yaml (229b), LICENSE (1083b), README.md (4525b), references/USAGE.md (3691b), requirements.txt (18b), scripts/jenkins_cli.py (8445b), skill-card.md (1957b), SKILL.md (3399b), _meta.json (135b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: jenkins-skills\ndescription: 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 任务、触发构建、查构建状态、看控制台日志、禁用/启用任务。\n---\n\n# Jenkins 技能（命令行实操）\n\n通过 Jenkins Remote API 操作 Jenkins，入口是单一自包含的 Python CLI：`scripts/jenkins_cli.py`。\n脚本自动处理 CSRF crumb 与文件夹嵌套的任务路径。License: MIT。\n\n## 何时使用\n\n用户提出以下需求时调用本技能：\n\n- 列出任务，或查看某个任务最近一次构建\n- 触发构建（\"跑一下部署任务\"，带参数或不带参数）\n- 查构建状态（\"上次构建过了吗\"）\n- 读控制台输出（\"把失败那次的日志给我\"）\n- 禁用或启用任务\n\n## 环境配置（首次）\n\n连接信息从环境变量读取，或放在配置文件 `~/.devops-skills/jenkins.json`。\n**禁止把 token 直接写在命令行参数里。**\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"   # User → Configure → API Token\n```\n\n## 运行方式\n\n脚本依赖 `requests`。本机受管 Python 环境已安装（requests 2.34.2），**推荐直接用绝对路径调用**，\n避免默认的 `python3` 缺少依赖而失败：\n\n```bash\nPY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/\n```\n\n任务名可以带文件夹层级，例如 `team/app/main`（脚本会自行拼出路径）。\n\n```bash\n$PY scripts/jenkins_cli.py list-jobs\n$PY scripts/jenkins_cli.py job-info team/app\n$PY scripts/jenkins_cli.py build team/app\n$PY scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n$PY scripts/jenkins_cli.py build-status team/app              # 最近一次构建\n$PY scripts/jenkins_cli.py build-status team/app --number 42\n$PY scripts/jenkins_cli.py console team/app --tail 100\n$PY scripts/jenkins_cli.py disable team/app\n$PY scripts/jenkins_cli.py enable team/app\n```\n\n除 `console` 输出原始日志外，其余命令都输出 JSON 到 stdout，失败时非零退出码。\n\n## 兼容性\n\n- Jenkins 2.60+\n\n执行命令前会读取 `/api/json` 的 `X-Jenkins` 响应头做版本校验，低于 2.60 会输出明确的兼容性提示并退出。\n确需绕过时可设 `JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n## 注意事项\n\n- 开启 CSRF 防护时，POST 类操作会自动先取 crumb。\n- `build` 返回的是队列 URL，构建号要等它出队才有——之后用 `build-status` 轮询。\n- 必须用 **API Token**，不要用账号密码。\n- `build` / `disable` 属于 🟡 级变更（尤其 `disable` 会停掉别人的构建），执行前跟用户确认任务名与参数。\n\n## 详细文档\n\n完整的配置方式、字段说明与排错见 `references/USAGE.md`。\n\n## 联系与支持\n\nJenkins 任务、流水线、权限、Agent 或更广泛的 DevOps 与研发效能问题需要人工支持时联系：\n📧 77890866@qq.com　|　🌐 https://www.restartx.top\n\nFile v0.1.1:README.md\n\n# Jenkins CI Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jenkins jobs and builds through the Jenkins Remote API. The Python CLI\nlists jobs, reads job and build status, triggers regular or parameterized builds,\nreads console output, and enables or disables a job. It handles CSRF crumbs and\nfolder-nested job paths.\n\n### Compatibility\n\n- Jenkins 2.60+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/api/json` and checks the `X-Jenkins`\nresponse header. Jenkins below 2.60 fails with a clear compatibility error.\n\n### Quick Start\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\nUse `~/.devops-skills/jenkins.json` for local configuration if preferred. Keep\nthe file out of version control and protect it with permissions `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| List jobs | `python scripts/jenkins_cli.py list-jobs` |\n| Read job details | `python scripts/jenkins_cli.py job-info team/app` |\n| Trigger a build | `python scripts/jenkins_cli.py build team/app` |\n| Trigger with parameters | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| Read build status | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| Read console output | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` |\n| Disable or enable a job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` |\n\n### Permissions and Safety\n\nRead operations need Job/Read on the target job. Triggering builds needs Job/Build;\nenabling or disabling a job needs Job/Configure. This skill does not need\nOverall/Administer, credential management, plugin management, or node management.\nTrigger builds and change job state only in approved, non-production jobs.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nRestartX provides technical support and implementation services for Jenkins,\nCI/CD, build stability, DevOps platform, and engineering-efficiency needs.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jenkins Remote API 管理 Job 和构建。Python CLI 支持列出 Job、查看 Job 与构建状态、\n触发普通或参数化构建、读取控制台日志、启用或禁用 Job，并自动处理 CSRF crumb 和文件夹嵌套\nJob 路径。\n\n### 兼容性\n\n- Jenkins 2.60+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前读取 `/api/json` 并检查 `X-Jenkins` 响应头。Jenkins 低于 2.60 时会给出\n明确的不兼容错误并停止执行。\n\n### 快速开始\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\n也可使用本地配置文件 `~/.devops-skills/jenkins.json`。文件不能提交到版本库，权限建议设为 `600`。\n\n### 常用命令\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出 Job | `python scripts/jenkins_cli.py list-jobs` |\n| 查看 Job 信息 | `python scripts/jenkins_cli.py job-info team/app` |\n| 触发构建 | `python scripts/jenkins_cli.py build team/app` |\n| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| 查看控制台日志 | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` |\n| 禁用或启用 Job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` |\n\n### 权限与安全\n\n只读操作需要目标 Job 的 Job/Read 权限；触发构建需要 Job/Build，启停 Job 需要 Job/Configure。\n本 Skill 不需要 Overall/Administer、凭据管理、插件管理或节点管理权限。构建触发和 Job 状态变更\n应只在已审批的非生产 Job 上执行。\n\n### 文档与支持\n\n- Agent 指令：[SKILL.md](./SKILL.md)\n- 完整中文手册：[使用手册.md](./使用手册.md)\n- 支持地址：https://service.restartx.top/\n\n如遇 Jenkins、CI/CD、构建稳定性、DevOps 平台或研发效能问题，可通过上述地址联系 RestartX\n获取技术支持与实施服务。\n\nFile v0.1.1:_meta.json\n\n{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jenkins-ci-skill\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1791447070405\n}\n\nFile v0.1.1:references/USAGE.md\n\n# Jenkins Skills 配置与使用手册\n\n通过一个 Python CLI 操作 Jenkins，覆盖任务列表、触发构建、查看状态与日志、启停任务，自动处理 CSRF crumb 和文件夹嵌套任务。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- `pip install requests`\n- Jenkins 2.60 及以上\n\n脚本会在执行命令前访问 `/api/json` 并读取 `X-Jenkins` 响应头判断版本；若 Jenkins\n低于 2.60，会给出明确的不兼容提示。确需跳过检查时，可设置\n`JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取 API Token\n\n1. 登录 Jenkins → 右上角用户名 → **Configure（设置）**。\n2. 找到 **API Token** → **Add new Token** → 生成并复制（只显示一次）。\n3. 自动化请使用 **API Token**，不要用账号登录密码。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"你的用户名\"\nexport JENKINS_TOKEN=\"你的API Token\"\n```\n\n### 方式 B：配置文件 `~/.devops-skills/jenkins.json`\n\n```json\n{\n  \"url\": \"https://jenkins.example.com\",\n  \"user\": \"你的用户名\",\n  \"token\": \"你的API Token\"\n}\n```\n\n> `chmod 600 ~/.devops-skills/jenkins.json`，切勿提交到仓库。\n\n---\n\n## 四、命令速查\n\n> 任务名 `name` 支持文件夹嵌套，如 `team/app/main`（脚本自动拼 `/job/.../job/...`）。\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出任务 | `python scripts/jenkins_cli.py list-jobs` |\n| 查看任务信息 | `python scripts/jenkins_cli.py job-info team/app` |\n| 触发构建 | `python scripts/jenkins_cli.py build team/app` |\n| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| 查看构建日志 | `python scripts/jenkins_cli.py console team/app --tail 100` |\n| 禁用任务 | `python scripts/jenkins_cli.py disable team/app` |\n| 启用任务 | `python scripts/jenkins_cli.py enable team/app` |\n\n---\n\n## 五、使用示例\n\n**1. 触发带参数构建并轮询结果**\n\n```bash\npython scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n# 进入队列后稍等，再查最近一次构建状态\npython scripts/jenkins_cli.py build-status team/app\n```\n\n**2. 排查失败构建**\n\n```bash\npython scripts/jenkins_cli.py build-status team/app --number 42\npython scripts/jenkins_cli.py console team/app --number 42 --tail 200\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `... are required` | 未配置连接信息 |\n| `HTTP 401` | 用户名或 Token 错误（注意用 Token 不是密码） |\n| `HTTP 403 No valid crumb` | CSRF 校验失败；脚本已自动取 crumb，若仍报错检查反向代理是否透传了 header |\n| `HTTP 404` | 任务名/路径错误；嵌套任务用 `folder/job` 形式 |\n| `unsupported Jenkins version ...` | Jenkins 版本低于 2.60，请升级 Jenkins 或使用旧版 skill |\n| build 后拿不到构建号 | 构建在队列中，返回的是 queue_url，稍后用 `build-status` 查询 |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n把 `jenkins-skills` 目录放入 skills 目录后，用自然语言触发：\n\n- “跑一下 team/app 这个任务，分支用 main”\n- “最近一次构建过了没”\n- “把失败那次的日志最后 200 行给我看看”\n\n---\n\n## 八、技术支持与咨询\n\n如果在 Jenkins 流水线、权限、Agent、构建稳定性、DevOps 平台或研发效能建设中遇到问题，\n欢迎联系 RestartX 获取支持与方案咨询：https://service.restartx.top/\n\nFile v0.1.1:skill-card.md\n\n## Description:\n\nHelps agents inspect Jenkins jobs and builds, read console logs, trigger builds, and enable or disable jobs through the Jenkins Remote API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and CI operators use this skill to inspect Jenkins jobs, check build results and logs, and, with approval, trigger builds or change job availability.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: An agent with Jenkins credentials can trigger builds or enable or disable jobs without an enforced confirmation step.\n\nMitigation: Require explicit user confirmation of the job and parameters before any change; limit changes to approved, non-production jobs.\n\nRisk: Jenkins credentials grant the agent access beyond routine job inspection if the token has write permissions.\n\nMitigation: Use a least-privilege Jenkins token and prefer read-only credentials for inspection.\n\n## Reference(s):\n\n- [Jenkins Skills usage guide](references/USAGE.md)\n- [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill)\n- [Server-resolved source repository](https://github.com/weiguang1017/jenkins-ci-skill)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with command examples, JSON job and build results, and plain-text log excerpts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Build triggers may return a queue URL before a build number is available.]\n\n## Skill Version(s):\n\n0.1.1 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v0.1.1:agents/openai.yaml\n\ninterface:\n  display_name: \"Jenkins CI\"\n  short_description: \"Jenkins job and build operations\"\n  default_prompt: \"Use $jenkins-skills to inspect this Jenkins job and its latest build.\"\n\npolicy:\n  allow_implicit_invocation: true\n\nFile v0.1.1:LICENSE\n\nMIT License\n\nCopyright (c) 2026 devops-skills contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nFile v0.1.1:requirements.txt\n\nrequests>=2.25,<3\n\nArchive v0.1.0: 11 files, 11452 bytes\n\nFiles: agents (0b), agents/openai.yaml (229b), LICENSE (1083b), README.md (4525b), requirements.txt (18b), scripts (0b), scripts/jenkins_cli.py (8445b), skill-card.md (2332b), SKILL.md (2706b), 使用手册.md (3691b), _meta.json (135b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: jenkins-skills\ndescription: 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 this whenever the user wants to run a Jenkins job, check whether a build passed, read build logs, or pause/resume a job.\nlicense: MIT\n---\n\n# Jenkins Skills\n\nOperate a Jenkins server through its remote API with one self-contained Python\nCLI (`scripts/jenkins_cli.py`). Handles CSRF crumbs and folder-nested jobs.\n\n## When to use\n\nTrigger this skill when the user asks to:\n- list jobs or inspect a job's last build\n- trigger a build (\"run the deploy job\", with or without parameters)\n- check build status (\"did the last build pass\")\n- read console output (\"show the log of the failed build\")\n- enable or disable a job\n\n## Setup (once)\n\nReads connection info from environment variables OR `~/.devops-skills/jenkins.json`.\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"   # User → Configure → API Token\n```\n\nRequires Python 3.8+ and `requests`. Full guide: `使用手册.md`.\n\n## Compatibility\n\nSupported targets:\n- Jenkins 2.60+\n\nThe CLI checks the Jenkins `X-Jenkins` response header from `/api/json` before\nrunning commands. If the detected Jenkins version is below 2.60, it exits with a\nclear compatibility message. Set `JENKINS_SKIP_VERSION_CHECK=1` or\n`DEVOPS_SKILLS_SKIP_VERSION_CHECK=1` only when you deliberately need to bypass\nthis guard.\n\n## Usage\n\nJob names may include folders, e.g. `team/app/main` (the CLI builds the path).\n\n```bash\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py job-info team/app\npython scripts/jenkins_cli.py build team/app\npython scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\npython scripts/jenkins_cli.py build-status team/app            # last build\npython scripts/jenkins_cli.py build-status team/app --number 42\npython scripts/jenkins_cli.py console team/app --tail 100\npython scripts/jenkins_cli.py disable team/app\npython scripts/jenkins_cli.py enable team/app\n```\n\nEvery command prints JSON to stdout (except `console`, which prints raw log)\nand exits non-zero on failure.\n\n## Notes\n\n- POST actions automatically fetch a CSRF crumb when protection is enabled.\n- `build` returns a queue URL; the build number appears once it leaves the queue\n  — poll `build-status` afterwards.\n- Use the API **token**, not your account password.\n\n## Support\n\nIf Jenkins jobs, pipelines, permissions, agents, or broader DevOps and\nengineering efficiency topics need expert help, contact RestartX:\nhttps://service.restartx.top/\n\nFile v0.1.0:README.md\n\n# Jenkins CI Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jenkins jobs and builds through the Jenkins Remote API. The Python CLI\nlists jobs, reads job and build status, triggers regular or parameterized builds,\nreads console output, and enables or disables a job. It handles CSRF crumbs and\nfolder-nested job paths.\n\n### Compatibility\n\n- Jenkins 2.60+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/api/json` and checks the `X-Jenkins`\nresponse header. Jenkins below 2.60 fails with a clear compatibility error.\n\n### Quick Start\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\nUse `~/.devops-skills/jenkins.json` for local configuration if preferred. Keep\nthe file out of version control and protect it with permissions `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| List jobs | `python scripts/jenkins_cli.py list-jobs` |\n| Read job details | `python scripts/jenkins_cli.py job-info team/app` |\n| Trigger a build | `python scripts/jenkins_cli.py build team/app` |\n| Trigger with parameters | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| Read build status | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| Read console output | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` |\n| Disable or enable a job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` |\n\n### Permissions and Safety\n\nRead operations need Job/Read on the target job. Triggering builds needs Job/Build;\nenabling or disabling a job needs Job/Configure. This skill does not need\nOverall/Administer, credential management, plugin management, or node management.\nTrigger builds and change job state only in approved, non-production jobs.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nRestartX provides technical support and implementation services for Jenkins,\nCI/CD, build stability, DevOps platform, and engineering-efficiency needs.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jenkins Remote API 管理 Job 和构建。Python CLI 支持列出 Job、查看 Job 与构建状态、\n触发普通或参数化构建、读取控制台日志、启用或禁用 Job，并自动处理 CSRF crumb 和文件夹嵌套\nJob 路径。\n\n### 兼容性\n\n- Jenkins 2.60+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前读取 `/api/json` 并检查 `X-Jenkins` 响应头。Jenkins 低于 2.60 时会给出\n明确的不兼容错误并停止执行。\n\n### 快速开始\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\n也可使用本地配置文件 `~/.devops-skills/jenkins.json`。文件不能提交到版本库，权限建议设为 `600`。\n\n### 常用命令\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出 Job | `python scripts/jenkins_cli.py list-jobs` |\n| 查看 Job 信息 | `python scripts/jenkins_cli.py job-info team/app` |\n| 触发构建 | `python scripts/jenkins_cli.py build team/app` |\n| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| 查看控制台日志 | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` |\n| 禁用或启用 Job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` |\n\n### 权限与安全\n\n只读操作需要目标 Job 的 Job/Read 权限；触发构建需要 Job/Build，启停 Job 需要 Job/Configure。\n本 Skill 不需要 Overall/Administer、凭据管理、插件管理或节点管理权限。构建触发和 Job 状态变更\n应只在已审批的非生产 Job 上执行。\n\n### 文档与支持\n\n- Agent 指令：[SKILL.md](./SKILL.md)\n- 完整中文手册：[使用手册.md](./使用手册.md)\n- 支持地址：https://service.restartx.top/\n\n如遇 Jenkins、CI/CD、构建稳定性、DevOps 平台或研发效能问题，可通过上述地址联系 RestartX\n获取技术支持与实施服务。\n\nFile v0.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jenkins-ci-skill\",\n  \"version\": \"0.1.0\",\n  \"publishedAt\": 1785907406056\n}\n\nFile v0.1.0:skill-card.md\n\n## Description:\n\nManage Jenkins CI from the command line to list jobs, inspect jobs, trigger builds with or without parameters, check build status, stream console logs, and enable or disable jobs.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and DevOps engineers use this skill to operate Jenkins jobs and builds through a command-line workflow, including job inspection, build triggering, build status checks, console log review, and job enable or disable actions.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill can trigger builds and enable or disable Jenkins jobs, which may affect CI or deployment workflows.\n\nMitigation: Use a least-privileged Jenkins API token and require explicit user approval before running build, enable, or disable commands.\n\nRisk: The skill handles Jenkins tokens and server connection settings.\n\nMitigation: Use HTTPS Jenkins URLs, protect local configuration files, and avoid partial environment overrides.\n\nRisk: Security review flagged insufficient transport, credential-origin, or confirmation safeguards for accounts with elevated Jenkins access.\n\nMitigation: Review before installing when the Jenkins account has build, configure, deployment, or production access.\n\n## Reference(s):\n\n- [Agent Instructions](SKILL.md)\n- [README](README.md)\n- [Chinese User Manual](使用手册.md)\n- [Server-Resolved Source Repository](https://github.com/weiguang1017/jenkins-ci-skill)\n- [ClawHub Skill Page](https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell commands and JSON CLI output examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [The Jenkins CLI prints JSON for most commands and raw text for console logs.]\n\n## Skill Version(s):\n\n0.1.0 (source: release metadata)\n\n## Ethical Considerations:\n\nUsers 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.\n\nFile v0.1.0:使用手册.md\n\n# Jenkins Skills 配置与使用手册\n\n通过一个 Python CLI 操作 Jenkins，覆盖任务列表、触发构建、查看状态与日志、启停任务，自动处理 CSRF crumb 和文件夹嵌套任务。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- `pip install requests`\n- Jenkins 2.60 及以上\n\n脚本会在执行命令前访问 `/api/json` 并读取 `X-Jenkins` 响应头判断版本；若 Jenkins\n低于 2.60，会给出明确的不兼容提示。确需跳过检查时，可设置\n`JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取 API Token\n\n1. 登录 Jenkins → 右上角用户名 → **Configure（设置）**。\n2. 找到 **API Token** → **Add new Token** → 生成并复制（只显示一次）。\n3. 自动化请使用 **API Token**，不要用账号登录密码。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"你的用户名\"\nexport JENKINS_TOKEN=\"你的API Token\"\n```\n\n### 方式 B：配置文件 `~/.devops-skills/jenkins.json`\n\n```json\n{\n  \"url\": \"https://jenkins.example.com\",\n  \"user\": \"你的用户名\",\n  \"token\": \"你的API Token\"\n}\n```\n\n> `chmod 600 ~/.devops-skills/jenkins.json`，切勿提交到仓库。\n\n---\n\n## 四、命令速查\n\n> 任务名 `name` 支持文件夹嵌套，如 `team/app/main`（脚本自动拼 `/job/.../job/...`）。\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出任务 | `python scripts/jenkins_cli.py list-jobs` |\n| 查看任务信息 | `python scripts/jenkins_cli.py job-info team/app` |\n| 触发构建 | `python scripts/jenkins_cli.py build team/app` |\n| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| 查看构建日志 | `python scripts/jenkins_cli.py console team/app --tail 100` |\n| 禁用任务 | `python scripts/jenkins_cli.py disable team/app` |\n| 启用任务 | `python scripts/jenkins_cli.py enable team/app` |\n\n---\n\n## 五、使用示例\n\n**1. 触发带参数构建并轮询结果**\n\n```bash\npython scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n# 进入队列后稍等，再查最近一次构建状态\npython scripts/jenkins_cli.py build-status team/app\n```\n\n**2. 排查失败构建**\n\n```bash\npython scripts/jenkins_cli.py build-status team/app --number 42\npython scripts/jenkins_cli.py console team/app --number 42 --tail 200\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `... are required` | 未配置连接信息 |\n| `HTTP 401` | 用户名或 Token 错误（注意用 Token 不是密码） |\n| `HTTP 403 No valid crumb` | CSRF 校验失败；脚本已自动取 crumb，若仍报错检查反向代理是否透传了 header |\n| `HTTP 404` | 任务名/路径错误；嵌套任务用 `folder/job` 形式 |\n| `unsupported Jenkins version ...` | Jenkins 版本低于 2.60，请升级 Jenkins 或使用旧版 skill |\n| build 后拿不到构建号 | 构建在队列中，返回的是 queue_url，稍后用 `build-status` 查询 |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n把 `jenkins-skills` 目录放入 skills 目录后，用自然语言触发：\n\n- “跑一下 team/app 这个任务，分支用 main”\n- “最近一次构建过了没”\n- “把失败那次的日志最后 200 行给我看看”\n\n---\n\n## 八、技术支持与咨询\n\n如果在 Jenkins 流水线、权限、Agent、构建稳定性、DevOps 平台或研发效能建设中遇到问题，\n欢迎联系 RestartX 获取支持与方案咨询：https://service.restartx.top/\n\nFile v0.1.0:agents/openai.yaml\n\ninterface:\n  display_name: \"Jenkins CI\"\n  short_description: \"Jenkins job and build operations\"\n  default_prompt: \"Use $jenkins-skills to inspect this Jenkins job and its latest build.\"\n\npolicy:\n  allow_implicit_invocation: true\n\nFile v0.1.0:LICENSE\n\nMIT License\n\nCopyright (c) 2026 devops-skills contributors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n\nFile v0.1.0:requirements.txt\n\nrequests>=2.25,<3","readmeExcerpt":"Skill: Jenkins Skills Owner: weiguang1017 Summary: Jenkins job and build operations Tags: latest:0.1.1 Version history: v0.1.1 | 2026-10-08T08:11:10.405Z | auto - 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 abou","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"   # User → Configure → API Token"},{"language":"bash","snippet":"PY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/"},{"language":"bash","snippet":"$PY scripts/jenkins_cli.py list-jobs\n$PY scripts/jenkins_cli.py job-info team/app\n$PY scripts/jenkins_cli.py build team/app\n$PY scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n$PY scripts/jenkins_cli.py build-status team/app              # 最近一次构建\n$PY scripts/jenkins_cli.py build-status team/app --number 42\n$PY scripts/jenkins_cli.py console team/app --tail 100\n$PY scripts/jenkins_cli.py disable team/app\n$PY scripts/jenkins_cli.py enable team/app"},{"language":"bash","snippet":"pip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42"},{"language":"bash","snippet":"pip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42"},{"language":"bash","snippet":"export JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"你的用户名\"\nexport JENKINS_TOKEN=\"你的API Token\""}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: jenkins-skills\ndescription: 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 任务、触发构建、查构建状态、看控制台日志、禁用/启用任务。\n---\n\n# Jenkins 技能（命令行实操）\n\n通过 Jenkins Remote API 操作 Jenkins，入口是单一自包含的 Python CLI：`scripts/jenkins_cli.py`。\n脚本自动处理 CSRF crumb 与文件夹嵌套的任务路径。License: MIT。\n\n## 何时使用\n\n用户提出以下需求时调用本技能：\n\n- 列出任务，或查看某个任务最近一次构建\n- 触发构建（\"跑一下部署任务\"，带参数或不带参数）\n- 查构建状态（\"上次构建过了吗\"）\n- 读控制台输出（\"把失败那次的日志给我\"）\n- 禁用或启用任务\n\n## 环境配置（首次）\n\n连接信息从环境变量读取，或放在配置文件 `~/.devops-skills/jenkins.json`。\n**禁止把 token 直接写在命令行参数里。**\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"   # User → Configure → API Token\n```\n\n## 运行方式\n\n脚本依赖 `requests`。本机受管 Python 环境已安装（requests 2.34.2），**推荐直接用绝对路径调用**，\n避免默认的 `python3` 缺少依赖而失败：\n\n```bash\nPY=~/.workbuddy/binaries/python/envs/default/bin/python\n# 若报 Missing dependency，用同一个解释器装：\n# $PY -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/\n```\n\n任务名可以带文件夹层级，例如 `team/app/main`（脚本会自行拼出路径）。\n\n```bash\n$PY scripts/jenkins_cli.py list-jobs\n$PY scripts/jenkins_cli.py job-info team/app\n$PY scripts/jenkins_cli.py build team/app\n$PY scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n$PY scripts/jenkins_cli.py build-status team/app              # 最近一次构建\n$PY scripts/jenkins_cli.py build-status team/app --number 42\n$PY scripts/jenkins_cli.py console team/app --tail 100\n$PY scripts/jenkins_cli.py disable team/app\n$PY scripts/jenkins_cli.py enable team/app\n```\n\n除 `console` 输出原始日志外，其余命令都输出 JSON 到 stdout，失败时非零退出码。\n\n## 兼容性\n\n- Jenkins 2.60+\n\n执行命令前会读取 `/api/json` 的 `X-Jenkins` 响应头做版本校验，低于 2.60 会输出明确的兼容性提示并退出。\n确需绕过时可设 `JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n## 注意事项\n\n- 开启 CSRF 防护时，POST 类操作会自动先取 crumb。\n- `build` 返回的是队列 URL，构建号要等它出队才有——之后用 `build-status` 轮询。\n- 必须用 **API Token**，不要用账号密码。\n- `build` / `disable` 属于 🟡 级变更（尤其 `disable` 会停掉别人的构建），执行前跟用户确认任务名与参数。\n\n## 详细文档\n\n完整的配置方式、字段说明与排错见 `references/USAGE.md`。\n\n## 联系与支持\n\nJenkins 任务、流水线、权限、Agent 或更广泛的 DevOps 与研发效能问题需要人工支持时联系：\n📧 77890866@qq.com　|　🌐 https://www.restartx.top"},{"path":"README.md","content":"# Jenkins CI Skill\n\n[English](#english) | [中文](#chinese)\n\n<a id=\"english\"></a>\n## English\n\nManage Jenkins jobs and builds through the Jenkins Remote API. The Python CLI\nlists jobs, reads job and build status, triggers regular or parameterized builds,\nreads console output, and enables or disables a job. It handles CSRF crumbs and\nfolder-nested job paths.\n\n### Compatibility\n\n- Jenkins 2.60+\n- Python 3.8+ and `requests`\n\nBefore normal execution, the CLI reads `/api/json` and checks the `X-Jenkins`\nresponse header. Jenkins below 2.60 fails with a clear compatibility error.\n\n### Quick Start\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\nUse `~/.devops-skills/jenkins.json` for local configuration if preferred. Keep\nthe file out of version control and protect it with permissions `600`.\n\n### Common Commands\n\n| Task | Command |\n| --- | --- |\n| List jobs | `python scripts/jenkins_cli.py list-jobs` |\n| Read job details | `python scripts/jenkins_cli.py job-info team/app` |\n| Trigger a build | `python scripts/jenkins_cli.py build team/app` |\n| Trigger with parameters | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| Read build status | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| Read console output | `python scripts/jenkins_cli.py console team/app --number 42 --tail 100` |\n| Disable or enable a job | `python scripts/jenkins_cli.py disable team/app` / `enable team/app` |\n\n### Permissions and Safety\n\nRead operations need Job/Read on the target job. Triggering builds needs Job/Build;\nenabling or disabling a job needs Job/Configure. This skill does not need\nOverall/Administer, credential management, plugin management, or node management.\nTrigger builds and change job state only in approved, non-production jobs.\n\n### Documentation and Support\n\n- Agent instructions: [SKILL.md](./SKILL.md)\n- Detailed Chinese manual: [使用手册.md](./使用手册.md)\n- Support: https://service.restartx.top/\n\nRestartX provides technical support and implementation services for Jenkins,\nCI/CD, build stability, DevOps platform, and engineering-efficiency needs.\n\n<a id=\"chinese\"></a>\n## 中文\n\n通过 Jenkins Remote API 管理 Job 和构建。Python CLI 支持列出 Job、查看 Job 与构建状态、\n触发普通或参数化构建、读取控制台日志、启用或禁用 Job，并自动处理 CSRF crumb 和文件夹嵌套\nJob 路径。\n\n### 兼容性\n\n- Jenkins 2.60+\n- Python 3.8+ 与 `requests`\n\n脚本会在正常执行前读取 `/api/json` 并检查 `X-Jenkins` 响应头。Jenkins 低于 2.60 时会给出\n明确的不兼容错误并停止执行。\n\n### 快速开始\n\n```bash\npip install requests\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"your-user\"\nexport JENKINS_TOKEN=\"<api-token>\"\n\npython scripts/jenkins_cli.py list-jobs\npython scripts/jenkins_cli.py build-status team/example --number 42\n```\n\n也可使用本地配置文件 `~/.devops-skills/jenkins.json`。文件不能提交到版本库，权限建议设为 `600`。\n\n### 常用命令\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出 Job | `"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7abv05p1jqkcnmnmkdpdex9581nt3f\",\n  \"slug\": \"jenkins-ci-skill\",\n  \"version\": \"0.1.1\",\n  \"publishedAt\": 1791447070405\n}"},{"path":"references/USAGE.md","content":"# Jenkins Skills 配置与使用手册\n\n通过一个 Python CLI 操作 Jenkins，覆盖任务列表、触发构建、查看状态与日志、启停任务，自动处理 CSRF crumb 和文件夹嵌套任务。\n\n---\n\n## 一、环境要求\n\n- Python 3.8 及以上\n- `pip install requests`\n- Jenkins 2.60 及以上\n\n脚本会在执行命令前访问 `/api/json` 并读取 `X-Jenkins` 响应头判断版本；若 Jenkins\n低于 2.60，会给出明确的不兼容提示。确需跳过检查时，可设置\n`JENKINS_SKIP_VERSION_CHECK=1` 或 `DEVOPS_SKILLS_SKIP_VERSION_CHECK=1`。\n\n---\n\n## 二、获取 API Token\n\n1. 登录 Jenkins → 右上角用户名 → **Configure（设置）**。\n2. 找到 **API Token** → **Add new Token** → 生成并复制（只显示一次）。\n3. 自动化请使用 **API Token**，不要用账号登录密码。\n\n---\n\n## 三、配置连接信息（二选一）\n\n### 方式 A：环境变量\n\n```bash\nexport JENKINS_URL=\"https://jenkins.example.com\"\nexport JENKINS_USER=\"你的用户名\"\nexport JENKINS_TOKEN=\"你的API Token\"\n```\n\n### 方式 B：配置文件 `~/.devops-skills/jenkins.json`\n\n```json\n{\n  \"url\": \"https://jenkins.example.com\",\n  \"user\": \"你的用户名\",\n  \"token\": \"你的API Token\"\n}\n```\n\n> `chmod 600 ~/.devops-skills/jenkins.json`，切勿提交到仓库。\n\n---\n\n## 四、命令速查\n\n> 任务名 `name` 支持文件夹嵌套，如 `team/app/main`（脚本自动拼 `/job/.../job/...`）。\n\n| 功能 | 命令 |\n| --- | --- |\n| 列出任务 | `python scripts/jenkins_cli.py list-jobs` |\n| 查看任务信息 | `python scripts/jenkins_cli.py job-info team/app` |\n| 触发构建 | `python scripts/jenkins_cli.py build team/app` |\n| 带参数构建 | `python scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod` |\n| 查看构建状态 | `python scripts/jenkins_cli.py build-status team/app --number 42` |\n| 查看构建日志 | `python scripts/jenkins_cli.py console team/app --tail 100` |\n| 禁用任务 | `python scripts/jenkins_cli.py disable team/app` |\n| 启用任务 | `python scripts/jenkins_cli.py enable team/app` |\n\n---\n\n## 五、使用示例\n\n**1. 触发带参数构建并轮询结果**\n\n```bash\npython scripts/jenkins_cli.py build team/app --param BRANCH=main --param ENV=prod\n# 进入队列后稍等，再查最近一次构建状态\npython scripts/jenkins_cli.py build-status team/app\n```\n\n**2. 排查失败构建**\n\n```bash\npython scripts/jenkins_cli.py build-status team/app --number 42\npython scripts/jenkins_cli.py console team/app --number 42 --tail 200\n```\n\n---\n\n## 六、常见问题\n\n| 现象 | 原因与解决 |\n| --- | --- |\n| `... are required` | 未配置连接信息 |\n| `HTTP 401` | 用户名或 Token 错误（注意用 Token 不是密码） |\n| `HTTP 403 No valid crumb` | CSRF 校验失败；脚本已自动取 crumb，若仍报错检查反向代理是否透传了 header |\n| `HTTP 404` | 任务名/路径错误；嵌套任务用 `folder/job` 形式 |\n| `unsupported Jenkins version ...` | Jenkins 版本低于 2.60，请升级 Jenkins 或使用旧版 skill |\n| build 后拿不到构建号 | 构建在队列中，返回的是 queue_url，稍后用 `build-status` 查询 |\n\n---\n\n## 七、在 Claude / Claude Code 中使用\n\n把 `jenkins-skills` 目录放入 skills 目录后，用自然语言触发：\n\n- “跑一下 team/app 这个任务，分支用 main”\n- “最近一次构建过了没”\n- “把失败那次的日志最后 200 行给我看看”\n\n---\n\n## 八、技术支持与咨询\n\n如果在 Jenkins 流水线、权限、Agent、构建稳定性、DevOps 平台或研发效能建设中遇到问题，\n欢迎联系 RestartX 获取支持与方案咨询：https://service.restartx.top/"},{"path":"skill-card.md","content":"## Description:\n\nHelps agents inspect Jenkins jobs and builds, read console logs, trigger builds, and enable or disable jobs through the Jenkins Remote API.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[weiguang1017](https://clawhub.ai/user/weiguang1017)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nDevelopers and CI operators use this skill to inspect Jenkins jobs, check build results and logs, and, with approval, trigger builds or change job availability.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: An agent with Jenkins credentials can trigger builds or enable or disable jobs without an enforced confirmation step.\n\nMitigation: Require explicit user confirmation of the job and parameters before any change; limit changes to approved, non-production jobs.\n\nRisk: Jenkins credentials grant the agent access beyond routine job inspection if the token has write permissions.\n\nMitigation: Use a least-privilege Jenkins token and prefer read-only credentials for inspection.\n\n## Reference(s):\n\n- [Jenkins Skills usage guide](references/USAGE.md)\n- [ClawHub skill release](https://clawhub.ai/weiguang1017/skills/jenkins-ci-skill)\n- [Server-resolved source repository](https://github.com/weiguang1017/jenkins-ci-skill)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Markdown with command examples, JSON job and build results, and plain-text log excerpts]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Build triggers may return a queue URL before a build number is available.]\n\n## Skill Version(s):\n\n0.1.1 (source: ClawHub release metadata)\n\n## Ethical Considerations:\n\nUsers 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."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":1361,"uniquenessScore":41,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T13:46:06.919Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T23:05:22.417Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"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!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"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","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}