setup-falcondev-oss-skills

设置 falcondev-oss/skills

设置这台机器，让它默认选用合适的技能。整个过程分为四件事——每一步都要向用户说明，并在操作前征得同意：

1. 安装根级 ponytail 技能——适用于任何编码工作的最省事方案准则。（ponytail 仓库还提供 ponytail-audit、-review、-help 等技能；设置时只安装根级 ponytail。）
2. 安装 Matt Pocock 技能——只安装仓库中 “Mattpocock Skills” 部分，不安装 “Other” 部分。
3. 安装此仓库中的所有技能（falcondev-oss/skills）——包括 standing-orders、conventional-commits 等。
4. 将 standing-orders 接入每种 Agent 框架的根配置，使每次对话默认在编码时启用 ponytail，并在使用 git 前启用 conventional-commits。

这是由提示词驱动的流程，不是脚本：先检测，再展示计划，征得同意，然后执行。每个步骤都可幂等执行——重新运行不会更改已完成的内容。

1. 检测

• 下列技能中，哪些已经安装？（使用 pnpm dlx skills@latest ls -g，或使用包管理器中的等效命令。）
• 用户使用了哪些 Agent 框架？检查以下配置目录是否存在：~/.claude（Claude Code）、~/.codex（Codex）、~/.gemini（Gemini CLI）、~/.cursor（Cursor）、~/.config/opencode（opencode）。将 standing-orders 行写入所有存在的目录。

2. 展示计划

告知用户将要执行的操作，然后征求确认。如果这些技能已安装，则跳过安装。

• install.sh 会全局安装根级 ponytail 技能、Matt Pocock “Mattpocock Skills” 部分中的 22 个技能（不含 “Other” 部分），以及此仓库中的所有技能。它会通过 --skill 指定确切的技能名称，从而跳过交互式分类选择器。它通过用户的包管理器（pnpm/yarn/bun/npm）运行 skills CLI，因此不会在系统上全局安装任何内容。
• 第 4 步会将 standing-orders 行添加到每个检测到的 Agent 框架根配置中。

3. 安装

运行此技能的 install.sh，并针对第 1 步检测到的每种 Agent 框架各传入一个 -a：

bash install.sh -a claude-code -a codex  # one -a per detected harness
PM=pnpm bash install.sh -a claude-code   # force a package manager (default: auto-detect)

额外参数会传递给每次 skills add。省略 -a 会将技能安装到所有受支持的 Agent 中——也可以这样做，但无法全局安装的 Agent（例如 PromptScript）会被跳过，并显示无害的警告。安装完上述三个组后，即表示完成。

4. 将 standing-orders 接入每种 Agent 框架

对于第 1 步检测到的每种 Agent 框架，请确保其根配置中包含以下独立一行：

In every conversation, follow the `standing-orders` skill.

各 Agent 框架对应的根配置：

Agent 框架	根配置
Claude Code	~/.claude/CLAUDE.md
Gemini CLI	~/.gemini/GEMINI.md
Codex、Cursor、opencode、其他 Agent	Agent 配置目录中的 AGENTS.md（例如 ~/.codex/AGENTS.md）

如果文件不存在，则创建文件；如果该行已存在，则保持不变；保留文件中的所有其他指令，不作改动。

5. 完成

告知用户现已安装的技能，以及现已写入该行的 Agent 框架配置。从此之后，每次对话中的任何编码工作都会启用 ponytail，每次使用 git 命名操作前都会启用 conventional-commits。