+2 -2

.agents/skills/cxs/SKILL.md skill-packages/cxs/SKILL.md

reviewed

··· 24 24 25 25 ```bash 26 26 # Codex agent runtime 27 27 - npx skills add catoncat/cxs --skill cxs -g -a codex -y 27 27 + npx skills add catoncat/cxs --full-depth --skill cxs -g -a codex -y 28 28 29 29 # Claude Code / Anthropic agent runtime — 把 -a codex 换成对应 runtime,或省略 30 30 ``` ··· 73 73 - [`references/failure-cookbook.md`](references/failure-cookbook.md) — 错误症状速查 / state_db_unavailable 处理 / `--json` error shape 速查 74 74 - [`references/advanced-queries.md`](references/advanced-queries.md) — query 语义 / CJK 行为 / snippet 高亮 75 75 76 76 - # skill-sync: repo-shared cxs skill, PATH-or-CXS_BIN mode, 2026-04-27 76 76 + # skill-sync: distributable cxs skill package, PATH-or-CXS_BIN mode, 2026-04-28

.agents/skills/cxs/references/advanced-queries.md skill-packages/cxs/references/advanced-queries.md

reviewed

.agents/skills/cxs/references/cli-surface.md skill-packages/cxs/references/cli-surface.md

reviewed

.agents/skills/cxs/references/failure-cookbook.md skill-packages/cxs/references/failure-cookbook.md

reviewed

.agents/skills/cxs/references/json-schema.md skill-packages/cxs/references/json-schema.md

reviewed

.agents/skills/cxs/references/progressive-workflow.md skill-packages/cxs/references/progressive-workflow.md

reviewed

+6 -4

AGENTS.md

reviewed

··· 45 45 - `docs/` 里的文档要服务后续 agent 直接接手，而不是保留调研过程痕迹 46 46 - 任何涉及“当前已实现什么”的文档，都必须先对齐代码和测试 47 47 48 48 - ## 项目共享 Skill 48 48 + ## Skill Package 边界 49 49 50 50 - 仓库内维护项目共享 skill： 50 50 + 本仓库不维护项目级 `.agents/skills`。cxs 的 skill 是给用户安装后操作 CLI 的发行物，不是维护本仓库时给 Codex agent 自动加载的项目 workflow。 51 51 52 52 - - `.agents/skills/cxs` 52 52 + skill package 源码放在： 53 53 + 54 54 + - `skill-packages/cxs` 53 55 54 56 对外推荐安装方式： 55 57 56 58 ```bash 57 57 - npx skills add catoncat/cxs --skill cxs -g -a codex -y 59 59 + npx skills add catoncat/cxs --full-depth --skill cxs -g -a codex -y 58 60 ``` 59 61 60 62 注意这个 skill 不会自动安装 `cxs` CLI 本体。默认约定：

+5 -5

README.md

reviewed

··· 235 235 - 协作说明见 [CONTRIBUTING.md](CONTRIBUTING.md) 236 236 - 当前公开目标是“可接手、可验证、可继续演进”的源码仓库；发布流程以 npm 包为唯一分发面 237 237 238 238 - ## 配套 Skill 238 238 + ## 可安装 Skill Package 239 239 240 240 - 仓库内自带一个项目共享 skill： 240 240 + 仓库内保留一个发行用 skill package，刻意不放在 `.agents/skills` 下，避免 clone 本仓库后被当前项目的 agent runtime 当成本项目 workflow 自动加载： 241 241 242 242 - - `.agents/skills/cxs` 242 242 + - `skill-packages/cxs` 243 243 244 244 推荐用 `npx skills add` 安装，而不是手动复制： 245 245 246 246 ```bash 247 247 - npx skills add catoncat/cxs --skill cxs -g -a codex -y 247 247 + npx skills add catoncat/cxs --full-depth --skill cxs -g -a codex -y 248 248 ``` 249 249 250 250 如果只想先看仓库里有哪些 skill： 251 251 252 252 ```bash 253 253 - npx skills add catoncat/cxs --list 253 253 + npx skills add catoncat/cxs --full-depth --list 254 254 ``` 255 255 256 256 CLI install guide: