{
  "markdown": "# Zhan Rongrui 的个人代理技能合集\n\n面向个人项目的代理技能合集，用于在 Cursor、Copilot 等工具中复用工作流程。\n\n## 技能分层（共 10 个）\n\n`skills/<name>/` 保持平铺，兼容现有 skill manager 的发现与安装；下面的分层用于选 skill，不改变目录或安装 ID。\n\n### 通用入口\n\n先决定任务是否需要一个总入口。只有项目级推进或委派编排需要这一层。\n\n| 技能 | 主要结果 | 不负责 |\n| --- | --- | --- |\n| `pilot` | 基于项目现场澄清目标、做软件设计取舍、组织有边界的委派 brief 并推进下一步 | 单一技术选型、单点实现、领域工具细节 |\n\n### 横切工程能力\n\n这些 skill 可附着在许多项目上，但各自只拥有一种结果。\n\n| 技能 | 主要结果 | 典型边界 |\n| --- | --- | --- |\n| `tech-preferences` | 技术栈/工具取舍与 Python 工具链落地 | 项目级模块、接口和状态边界仍由 `pilot` 统筹 |\n| `vet` | diff 级 AI slop 清理、证据化 architecture findings，或全仓质量审计与公开发布就绪预检 | 不替代正确性调试、纯安全渗透测试或未来方案设计 |\n| `git-workstreams` | checkout/worktree、依赖 PR 拓扑与持续交付权限边界 | 规范化仓库或创建 PR 时可默认使用 owning worktree；其他场景显式 opt-in |\n\n### 领域专用能力\n\n任务目标已经明确落在某个领域时，可直接使用对应 skill，不必先经过 `pilot`。\n\n| 技能 | 主要结果 |\n| --- | --- |\n| `get-api-docs` | 从当前第三方 SDK/API 文档取得可靠用法；OpenAI 文档走官方专用来源 |\n| `zellij` | 组织、恢复、观察或分享持久终端工作区 |\n| `ssh-fleet` | 管理私有 SSH 设备事实源、host key 信任和生成配置 |\n| `skill-creator` | 创建、修改和验证可跨 Agent 宿主使用的 skill |\n| `writing-style` | 起草、改写和审阅六个骨头的技术博客；其他文体仅在明确要求个人文风时应用 |\n| `typed-structures` | 编写或审阅 Spore Notation 的宇宙、范畴、计算结构与 Self；结合具体数据结构和 law，并用 Ohm 识别句法 |\n\n### 选择规则\n\n1. 请求横跨目标、现场证据、设计和下一步，或主要结果是组织子代理 brief 与依赖时，以 `pilot` 为主；遇到明确专项再加载更窄的 skill。\n2. 主要交付只是技术选择、审计、Git workstream 或领域产物时，直接使用对应 skill。\n3. `pilot` 负责明确委派 brief 与依赖；实际调度由宿主编排层完成，不加载单独的 role skill。\n4. 混合请求分三层所有权：`pilot` 管项目结论与顺序，领域 skill 管产物与领域权限，`git-workstreams` 管 Git 拓扑与交付；每层只有一个所有者，权限互不推导。现有架构的证据化 findings 归 `vet`，比较未来方案和推进顺序归 `pilot`。\n5. `gh stack` 请求统一由 `git-workstreams` 拥有结果并直接读取本机 help；外部 `gh-stack` skill 的静态命令、安装、配置、重试和权限规则不作为依赖或权威。\n6. Git 交付以用户显式终点为先；未指定时，规范化仓库默认 Draft PR，非规范化仓库默认仅本地。审查、设计和咨询不触发实现或 Git 交付。\n\n原 `unix-software-design` 已简化并内置进 `pilot`，原 `git-worktrees` 已更名为 `git-workstreams`，原 `roles` 已退役，原 `quality-audit` 已合入 `vet`（新增 diff 级轨道），原 `spark` 已更名为 `pilot`（避免与 Spark 产品仓库混淆）。`SPARK.md` 已由 zendev 的 `EVOLUTION.md` 取代，对应的 `evolution` skill 在 zendev 维护。\n\n> `svg-design` 已从本仓库移除；安装脚本不会自动卸载已有副本，升级时请检查并移除来自本仓库的旧安装。通用 SVG 能力的外部替代需按任务单独选择，不随本次移除自动安装。\n\n> 升级提示：安装流程不会自动删除用户级旧 skill。重新安装后若本机仍残留 `git-worktrees`、`roles`、`quality-audit` 或 `spark`，请先用当前 skill manager 检查来源，再移除旧条目，避免过期 description 继续触发。\n\n> `gh stack` CLI 与同名 skill 是两件事。保留 CLI 即可；若已安装外部 `gh-stack` skill，建议用当前 skill manager 检查并移除该 skill，避免它与 `git-workstreams` 重复触发。仓库不会自动删除用户级 skill。\n\n## 安装\n\n### 一键安装\n\n安装脚本按需准备 [Vite+](https://viteplus.dev/guide/vpx)、`gh-llm` 扩展和 `chub`，统一通过 `vpx skills add` 安装并登记来源。已有工具不会例行升级；日常更新 skills 使用下方的更新命令。\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/zrr1999/skills/main/install.sh | bash\n```\n\n默认集合包括本仓库 10 个 skills，以及以下外仓能力：\n\n| 来源 | 默认安装 |\n| --- | --- |\n| `vercel-labs/skills` | `find-skills` |\n| `emilkowalski/skills` | `write-swift` |\n| `pbakaus/impeccable` | `impeccable` |\n| `cloudflare/skills` | `cloudflare`、`wrangler` |\n| `shigurelab/gh-llm` | `github-conversation` |\n| `spore-lang/spore` | `spore-language` |\n| `kucherenko/jscpd` | `dry-refactoring` |\n\n其他能力按用途选择；每次安装都会包含默认集合：\n\n| 参数 | 额外安装 |\n| --- | --- |\n| `web` | `animate`、`apple-design`、`review-animations`、`prototype`、`pick-ui-library`、`ask-sonner`、`animation-vocabulary`、`find-animation-opportunities`、`improve-animations`（`emilkowalski/skills`） |\n| `expo` | `animate-expo`（`emilkowalski/skills`） |\n| `cloudflare` | `workers-best-practices`、`durable-objects`（`cloudflare/skills`） |\n| `mail` | `agently-mail`（`agent.qq.com` 的 well-known skill） |\n| `video` | `procedural-fish-render`、`ruler-progress-render`（`vibe-motion/skills`） |\n| `all` | 上述全部可选组 |\n\n```bash\nbash install.sh web cloudflare\n```\n\n脚本不再安装 Anthropic 同名 `skill-creator`、失效的 `svg-assembly-animator`、重复的 `gh-stack` 和 `emil-design-eng`。`skill-creator` 只使用本仓库通用版；宿主 `.system` 和插件提供的 skills 仍由宿主管理。\n\n`hatch-pet` 是本地 Codex 专用 skill，尚无登记的远端来源，保留其本地副本与备份，不纳入通用安装或自动更新。补充可信远端来源后再通过管理器登记，不从未知来源安装同名替代品。\n\n### 本地管理\n\n已有安装统一使用 `vpx skills` 管理。更新会修改已登记来源的 skills，不会自动补装脚本新增的条目：\n\n```bash\nvpx skills list -g\nvpx skills update -g\n```\n\n手工复制的 skill 需要先用 `add` 登记来源；不直接编辑管理器的 lock 文件。仅安装或重新登记本仓库时：\n\n```bash\nvpx skills add zrr1999/skills -g -y --agent cline --skill '*'\n```\n\n`--agent cline` 默认只写入共享的 `~/.agents/skills`，可用 `SKILLS_AGENT` 覆盖。不要使用管理器的 `--all`，它会向所有 agent 目录分发；本脚本的 `all` 参数仅选择可选组。管理器更新可能保留或恢复已检测到的 agent 链接，不保证只改一个目录。\n\n清理旧 skill 前确认来源并备份，再使用 `vpx skills remove <name> -g`；不删除同名 CLI。安装脚本不会自动卸载已有 skills。具体参数以当前 `vpx skills --help` 为准。\n\n## 本地开发\n\n评测用例位于 `evals/<skill-name>/evals.json`，与 skill 目录分开，避免安装副本带上答案。结构与完整性由 `check-evals` prek hook 校验。\n\n```bash\nbash scripts/check-evals.sh\nbash scripts/test-install.sh\nprek run --all-files\n```\n\n本地试用可用 `vpx skills add ./skills -g --agent cline --skill pilot`，本地路径安装不支持远端自动更新。要跟踪尚未合并的远端分支，可用 `REPO_SOURCE='zrr1999/skills#branch-name' bash install.sh`；更新会保留该 ref。分支合并后重新从默认来源安装，恢复跟踪 main。\n",
  "bytes": 4698,
  "sha": "3632130949c355bee9a21343757f3b5efa84776209da9eec494054c744c1d0c9",
  "repo_slug": "zrr1999/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zrr1999_skills_unix_software_design_3e0e1867/readme"
}