skills-cli

Skills CLI

工作流

1. 使用 bunx skills list 检查项目范围的当前状态，使用 bunx skills list -g 检查全局范围的当前状态。
   • 在此仓库中，以 skill-registry.json 作为权威分类，以 sjskills plan 查看已提交的项目意图，并以 sjskills plan --global 查看精确的固定基线状态。
2. 使用 bunx skills find <query> 或 bunx skills add <source> --list 发现可用选项。
   • 选择命令、来源、范围或 Agent 目标（包括初始化技能）时，请阅读 references/cli.md，了解 CLI 接受的输入和安装位置事实。
3. 安装时明确指定范围、技能选择和 Agent 目标。
   • 安装或重新安装已发布的技能，或将共享安装移至特定 Agent 路径之前，请阅读 recipes/install-and-migrate.md，并使用匹配的操作指南。
   • 在此仓库中，无论是处理已提交的项目意图还是固定全局基线，都优先使用 sjskills，而非手写命令。其私有适配器会使用明确指定的 Codex 和 Claude Code 目标进行部署；sjskills 负责经过验证的放置、状态、隔离和恢复。
   • 仅凭字节相同并不足以获得协调器的管理资格。只有当前内容与可信状态相符时，才会进行受管理的更新和移除。
4. 使用匹配范围的命令验证常规安装。对于此仓库的受管理状态，使用 sjskills plan 验证项目的精确放置位置，或使用 sjskills plan --global 验证固定全局基线；共享根目录的发现结果可能会报告附带的 Agent 可见性。
5. 使用创建安装时相同的范围和 Agent 目标来维护或移除安装。
   • 筛选并列出安装、移除技能、运行通用更新、恢复锁文件或同步软件包提供的技能之前，请阅读 recipes/manage-installs.md。
   • 对于此仓库已发布的技能，请先发布本地更改，再从远程来源重新安装。

防护措施

• 默认使用符号链接模式；仅在用户提出要求，或为所选仓库技能进行限定范围的全局安装时，才使用 --copy。
• 只有用户明确要求安装某个来源中的所有技能时，才使用 --skill '*'。在当前 skills CLI 中，--all 会展开为 --skill '*' --agent '*' -y，这可能会意外地重新创建共享的 ~/.agents/skills 安装。
• 绝不要为此仓库的固定全局基线虚构 Pi 目标；Pi 会发现所选的共享根目录副本。
• 协调前，先发布更改过的仓库技能。本地编辑或尚未合并的分支不会出现在固定到 main 的注册表来源中。
• 未经单独审核的发布计划和明确授权，不要对真实用户主目录运行 sjskills apply --global 或全局恢复。全局应用还需要通过 --approved-plan 提供经审核的 JSON 计划，并通过 --approved-plan-sha256 提供其已批准的摘要；这些标志用于绑定证据，但不授予授权。
• 将已安装的技能视为可执行指令；避免使用不可信来源。
• 使用 chezmoi 管理点文件时，避免对运行中的技能目录执行 chezmoi add。