vincentkoc/dotskills

我们正在从“作为文本的 prompt”向**作为 runtime module 的 skill** 转变。每个 skill 就像一个用于 AI 工作的轻量级容器化应用：具有稳定的接口、固定的 workflow 以及打包的资源，可以跨项目进行安装、版本控制、测试和重用。 ## 本 repo 的运作方式 这是我用于 Codex、Cursor、OpenClaw 和 agent 优先工具的个人 **.skills** 仓库。`.skills` 是将 dotfiles 的理念应用于 AI 执行：这个仓库存储的不是一次性的 prompt，而是打包了以下内容的可重用 skill 单元： - prompt 逻辑（`SKILL.md` / `AGENT.md` / `AGENTS.md`） - 参考资料和知识资产 - 用于确定性执行的脚本 - 可重复的验证 + 发布 workflow - 通过 submodules 支持外部 skill - 由 git 管理的个人 registry 和 github action hooks ## 公开 skill | Skill | 功能 | 安装 | |---|---|---| | `crawlkit` | 维护并发布共享的 crawl 应用 Go 库。 | `npx skills add vincentkoc/dotskills --skill crawlkit -y` | | `graincrawl` | 维护并发布 local-first 的 Granola 归档 CLI。 | `npx skills add vincentkoc/dotskills --skill graincrawl -y` | | `ghcrawl-cluster-operator` | 从 CLI 操作 ghcrawl 本地同步、clustering 和 cluster 检查。 | `npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y` | | `openclaw-github-dedupe` | 跨仓库对 GitHub issue/PR cluster 进行分类，在选定标准修复和安全关闭的同时保留贡献者荣誉。 | `npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y` | | `operations-worktree` | 从全新的远程默认分支而不是陈旧的本地分支创建安全的 git worktree。 | `npx skills add vincentkoc/dotskills --skill operations-worktree -y` | | `semantic-slicing` | 为专注的 repo 审查构建本地 feature、threat、issue 和支持映射。 | `npx skills add vincentkoc/dotskills --skill semantic-slicing -y` | | `technical-deslop` | 快速交付干净的 diff：移除 AI 噪音并保持行为不变。 | `npx skills add vincentkoc/dotskills --skill technical-deslop -y` | | `technical-documentation` | 制作可供开发使用的文档：针对 brownfield 和 evergreen 内容进行清晰、结构化的构建/审查。 | `npx skills add vincentkoc/dotskills --skill technical-documentation -y` | | `technical-integrations` | 设计能够成功落地的集成：与供应商无关的 API/RFC/SDK 计划，并带有上线安全保障。 | `npx skills add vincentkoc/dotskills --skill technical-integrations -y` | | `technical-skill-finder` | 将真实的 agent 痛点转化为新的 skill：挖掘日志、评估收益、起草后续步骤。 | `npx skills add vincentkoc/dotskills --skill technical-skill-finder -y` | 内部/私有的 workflow skill 可以存在于此 repo 中，并在元数据中标记为 `internal: true`，同时排除在公开的 marketplace/release artifacts 之外。 ## 安装 安装单个 skill： ``` npx skills add vincentkoc/dotskills --skill ghcrawl-cluster-operator -y npx skills add vincentkoc/dotskills --skill technical-deslop -y npx skills add vincentkoc/dotskills --skill technical-documentation -y npx skills add vincentkoc/dotskills --skill technical-integrations -y npx skills add vincentkoc/dotskills --skill technical-skill-finder -y npx skills add vincentkoc/dotskills --skill openclaw-github-dedupe -y npx skills add vincentkoc/dotskills --skill operations-worktree -y npx skills add vincentkoc/dotskills --skill crawlkit -y npx skills add vincentkoc/dotskills --skill graincrawl -y npx skills add vincentkoc/dotskills --skill semantic-slicing -y ``` 列出可用的公开 skill： ``` npx skills add vincentkoc/dotskills --list ``` 默认的同步目标由 vercel skills 自动管理。 ## Codex slash commands 此 repo 还可以镜像 `vendor/` 中的 Codex slash-command prompt，并将它们同步到 `~/.codex/prompts`。 - `make sync` 现在会为 `codex` profile 同步 skill 和 slash commands。 - 目前包含的 vendored command：来自 `steipete/agent-scripts` 的 `/sectriage`。 ## 仓库结构 ``` skills/ # First-party skills / SKILL.md|AGENT.md|AGENTS.md references/ scripts/ private-skills/ # Private/local-only skills (not published) / SKILL.md|AGENT.md|AGENTS.md references/ scripts/ vendor/ # Third-party mirrored/imported skills .assets/ # Shared visual assets (banner/icon) bin/agent-skills # List/validate/sync/import scripts/ # Validation + publishing automation catalog.yaml # Skill metadata catalog .claude-plugin/marketplace.json releases/skills.json ``` ## 验证 `make validate` 现在会运行： 1. 仓库策略检查（`Purpose/When to use/Workflow/Inputs/Outputs`，入口文件检查） 2. 针对本地 `SKILL.md` skill 的 AgentSkills 规范检查（`name`/`description` 约束，frontmatter 有效性，相对资源引用，单层引用深度） 3. 公开 skill 的 OpenAI 元数据检查（`agents/openai.yaml`，必须的接口字段，来自 `AGENTS.md` 的默认图标/品牌，以及图标路径的存在性） 如果已安装，也会使用外部引用验证器： ``` skills-ref validate ./skills/ ``` ## 为什么是 .skills Dotfiles 用于配置机器。 `.skills` 用于配置 AI 执行质量。 此 repo 旨在实现可组合、可审计且实用：skill 应该是可测试的 artifact，而不是一次性的 prompt 片段。 ## 贡献 请阅读 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)。

标签：AI智能体, SOC Prime, 代码辅助, 工作流自动化, 开发工具, 软件复用