jwb-cli-contract SKILL.md skillA
jwb-cli-contract from chenxiang6663635/job-workbench is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add chenxiang6663635/job-workbench/jwb-cli-contract@v26.11.0Pins v26.11.0 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- chenxiang6663635/job-workbench
- Path
skills/jwb-cli-contract/SKILL.md- Versions recorded
- 6
- Latest version
- v26.11.0, committed Nov 1, 2026
- First version recorded
- Sep 14, 2026
- Size
- 3,471 bytes
- Repository stars
- 16
- License
- MIT
Use when 设计、新增或审查 jobws 命令行命令时，需要遵守本工作台既有的 CLI 契约（退出码三态、两段式写入、stdout/stderr 纪律、默认行为兼容）。English triggers：CLI design, command contract, clig.dev, exit codes, two-phase write, breaking change.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# jobws CLI 契约（新增命令时照此办） 外部参考：clig.dev 的原则。本文件是**本仓库已落地的口径**——与代码及其测试冲突时， 以代码为准，并回来更新本文件。 ## 退出码（三态，不可挪用） | 码 | 含义 | |---|---| | 0 | 成功（只读命令即使结果为空也返回 0） | | 1 | 业务失败（校验不过、令牌不可用、冲突……） | | 2 | 用法或配置错误（参数不对、工作区不可用、旧入口迁移提示） | ## 写入必须是两段式（硬闸门） - 写类命令默认直接执行，但必须提供 `--preview`：只校验、只给差异表与一次性令牌； - 落盘统一走 `jobws apply <令牌>`——**不**在原命令里加 `--yes` 之类跳过确认的口； - 令牌：一次性（apply 先取走再执行）、默认 10 分钟、绑定工作区与载荷指纹； - 预览阶段不碰工作区一个字节（测试按文件字节断言）； - 新增写入口时：在协议层注册表登记「操作名 → 落盘函数」，并同步 CLI / MCP / 网页端三面——只改一面等于三面口径漂移。 ## stdout / stderr 纪律 - stdout 只放结果（表格、令牌、记录 id）；诊断与进度走 stderr； - **stdio MCP 场景下 stdout 是协议通道**——任何调试 print 都可能破坏会话； - 机器可读的关键行（如令牌）保持固定格式，人可读提示与它分行。 ## 默认行为与兼容 - 新增能力用**新增分支**承载（如 `--preview`）；旧路径默认行为不变——这是本仓库 对「非破坏性」的默认防线；改名级别的大迁移单独开版本讲清迁移步骤； - 参数名、子命令、退出码一经发布即契约；要改按破坏性流程走（Release 给迁移步骤）。 ## 帮助与发现 - `jobws --help` 列全部命令；`jobws <cmd> --help` 显示子命令与参数——新增命令后 两处都要对（入口里 `add_help=False` 的转发模式已固化）； - 旧脚本被直接运行时必须给迁移提示（exit 2），不静默退出、也不留旧别名。 ## 常用约定 - `--workspace` 在多个命令里是**顶层选项**：写在子命令之后会被判 unrecognized； - 参数沿用既有风格（长选项、连字符分隔）；一次任务只做一件事； - 错误信息写「怎么办」而不只写「哪里错」，涉及的命令要可直接复制执行。 ## 常见错误 | 错误 | 后果 | 正确做法 | |---|---|---| | 写命令没有预览入口 | 用户对自己的数据失去确认权 | 加 `--preview`，走令牌 | …
Read the whole file at its exact version.
How to install
mdr add chenxiang6663635/job-workbench/jwb-cli-contract@sha256:f1036df661080663The line at the top of this page pins the label v26.11.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_b4ytcqimei6pdgho)
1 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 6 versions of this file, between Sep 14, 2026 and Nov 1, 2026, about one every 10 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v26.11.0 latest | 2026-11-01 | c62388d | 3,471 B | A | view · diff |
| v26.10.0 | 2026-10-06 | 0f9cfd8 | 3,471 B | A | view · diff |
| v26.9.0 | 2026-09-25 | 0f7cde1 | 3,470 B | A | view · diff |
| v26.9.15 | 2026-09-23 | f4ef6f2 | 3,471 B | A | view · diff |
| git:20260915.c01fcc9 | 2026-09-15 | c01fcc9 | 3,429 B | A | view · diff |
| git:20260914.894f343 | 2026-09-14 | 894f343 | 3,428 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (3471 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
chenxiang6663635/job-workbench · 16 stars · license MIT · pushed 2026-11-04 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_b4ytcqimei6pdgho GET https://markdownregistry.com/api/v1/resolve?ref=chenxiang6663635/job-workbench/jwb-cli-contract GET https://markdownregistry.com/api/v1/blob/f1036df6610806634b4d211626a893f8e521845d7f3792c3d847a1b2c113d011
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from chenxiang6663635/job-workbench
Every file in chenxiang6663635/job-workbench