jx-skills
v0.1.0
Published
Internal skills manager CLI/TUI baseline.
Readme
jx-skills
jx-skills 是一个面向内部 GitLab 治理的 Node/TypeScript skills manager。它的 v1 目标是把 skill / pack 的作者、校验、发布、安装、更新、卸载和投影修复收敛到一条可审计、可回滚、可恢复的生命周期链路里。
What It Does
- 提供主命令
jx-skills - 提供中文优先的 TUI
- 提供
init、new、check和publish-prep --out这类作者命令 - 生成 scaffold 草稿、隔离 fixture self-test、publish-prep Markdown+JSON evidence
- 通过受保护 GitLab 流程发布不可变
.jxskill产物 - 支持 project / global 安装范围
- 维护 canonical state、operation journal、owned-file metadata 和可重建投影
What It Does Not Do
- 不承诺 public marketplace
- 不承诺 automatic arbitrary adapt
- 不要求 GitLab MR 自动化
- 不自动安装 runtime/toolchain
- 不支持 remote binary fetch
- 不允许 local direct shared catalog mutation
Local Verification
用户安装后使用短命令:
jx-skills
jx-skills init
jx-skills new my-skill
jx-skills check my-skill
jx-skills publish-prep my-skill --out .tmp/publish-prep/my-skill本仓库已经声明 package bin:安装或 link 后命令名就是 jx-skills。在源码仓库内还没安装/link 时,先构建再用 node dist/index.js ... 做同等验证。
在仓库内开发验证可以用这些命令:
npm run build
node dist/index.js --help
node dist/index.js new .tmp/markdown-basic
node dist/index.js check .tmp/markdown-basic
node dist/index.js publish-prep .tmp/markdown-basic --out .tmp/publish-prep/markdown-basic
npm run jx:node -- --help
npm run jx:node -- new .tmp/markdown-basic
npm run jx:node -- check fixtures/skills/markdown-basic
npm run jx:node -- publish-prep fixtures/skills/markdown-basic --out .tmp/publish-prep
npm test
npm run typecheck安装成二进制后,对应的用户命令是 jx-skills;仓库内开发验证使用 npm run jx:node -- ... 或 Bun 环境下的 npm run jx -- ...。
本地 publish-prep 是 evidence-only:它可以写可附加的 Markdown+JSON 证据,但不会调用 GitLab API、上传 package、写共享 catalog 或替代 protected CI。
Documentation Map
- Authoring Guide
- GitLab Publish
- Install, Update, Uninstall
- Recovery
- Dependency Policy
- GitLab v1 Configuration
- Agent Adapter Path Evidence
Projection Roots
- Codex 官方投影根是
.agents/skills - Claude Code 使用其各自支持的 project / personal skill 目录
.codex/skills只作为本仓库的参考语料,不是官方 Codex 发现根
License / Governance Note
This repository is an internal skills-manager implementation. Operational behavior, lifecycle rules, and publication constraints are governed by the feature specification and plan artifacts under .specify/features/001-discussions-gitlab-skills-manager/.
