Back to Details

skill-selection

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

skill-selection

skill-selection

方針

方针

philtzjp/skills のスキルは、各メンバーのホームに 
npx skills
で導入します。作業対象リポジトリにはコピーしません。
ホームに入れたスキルは、そのメンバーのすべてのリポジトリの作業に効きます。導入も削除も、ユーザーの許可を得てから行ってください。
philtzjp/skills 的 skill 使用 
npx skills
安装到每位成员的 home 目录。不要将其复制到工作目标仓库。
安装在 home 目录中的 skill 会对该成员所有仓库的工作生效。安装和删除之前，都必须获得用户许可。

既定のスキル

默认 skill

全員が入れるスキルは次の 3 つです。
  • github
  • japanese
  • turborepo
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s github -s japanese -s turborepo -y
実体は 
~/.agents/skills/<スキル名>/
に置かれ、
~/.claude/skills/<スキル名>
からシンボリックリンクが張られます。Codex と Cursor は前者を、Claude Code は後者を読みます。
所有成员都应安装以下 3 个 skill：
  • github
  • japanese
  • turborepo
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s github -s japanese -s turborepo -y
这些 skill 实际位于 
~/.agents/skills/<スキル名>/
，并从 
~/.claude/skills/<スキル名>
创建指向它们的符号链接。Codex 和 Cursor 读取前者，Claude Code 读取后者。

作業に応じて追加するスキル

根据工作需要添加 skill

実際にその作業をするときに追加します。「いつか使うかもしれない」段階では入れないでください。読み込まれるスキルが増えるほど、関係のない規約が作業に混ざります。
スキル追加する場面
honoHTTP API を設計・実装する
dbデータベースの選定、スキーマ、接続、マイグレーション、データ移行を扱う
e2etestE2E テストを作成・実行する
analyticsアクセス解析や同意管理を実装する
errorpageエラー応答やエラーページを設計する
cursor-hook-authoringCursor Cloud Agent の Git hook 連鎖を扱う
knowledge-elicitation対話でユーザーの暗黙知を引き出す
m4l-projectMax for Live デバイスを扱う
一覧は増えることがあります。最新の一覧は次で確認してください。
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills --list
追加するときは、スキル名だけを指定します。
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s <スキル名> -y
refresh-skills、skill-selection、skill-escalation は導入しません。スキルの追加、削除、更新、移行は 
npx skills
を直接使って行います。手順は https://raw.githubusercontent.com/philtzjp/startingpoint/main/START.md にあります。
在实际执行某项工作时添加对应 skill。不要在“以后可能会用到”的阶段就安装。加载的 skill 越多，混入工作内容的无关规范就越多。
skill添加场景
hono设计、实现 HTTP API
db处理数据库选型、schema、连接、migration 和 data migration
e2etest创建、运行 E2E 测试
analytics实现访问分析或同意管理
errorpage设计错误响应或错误页面
cursor-hook-authoring处理 Cursor Cloud Agent 的 Git hook 链
knowledge-elicitation通过对话挖掘用户的隐性知识
m4l-project处理 Max for Live 设备
此列表可能会增加。可通过以下命令查看最新列表：
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills --list
添加时，只指定 skill 名称。
sh
DISABLE_TELEMETRY=1 npx skills add philtzjp/skills -g -a claude-code -a codex -a cursor -s <スキル名> -y
不要安装 refresh-skills、skill-selection 和 skill-escalation。添加、删除、更新和迁移 skill 时，直接使用 
npx skills
。相关步骤见 https://raw.githubusercontent.com/philtzjp/startingpoint/main/START.md。

入れないスキル

不安装的 skill

次は統合済みの旧スキルで、中身は統合先への案内だけです。導入しないでください。
旧スキル代わりに入れるスキル
commit-and-git、issue-branch-pr-flowgithub
japanese-writingjapanese
typescript-monorepoturborepo
api-designhono
data-migrationdb
e2e-testinge2etest
google-analyticsanalytics
以下是已经合并的旧 skill，其内容仅用于指向合并后的替代 skill。不要安装。
旧 skill应安装的替代 skill
commit-and-git、issue-branch-pr-flowgithub
japanese-writingjapanese
typescript-monorepoturborepo
api-designhono
data-migrationdb
e2e-testinge2etest
google-analyticsanalytics

外す

移除

使わなくなったスキルは、ユーザーの許可を得てから外します。
sh
DISABLE_TELEMETRY=1 npx skills remove -g -y <スキル名>
既定の 3 つは外さないでください。
不再使用的 skill 必须在获得用户许可后移除。
sh
DISABLE_TELEMETRY=1 npx skills remove -g -y <スキル名>
不要移除默认的 3 个 skill。

リポジトリ固有のスキルを置くか

是否设置仓库专属 skill

そのリポジトリでしか意味を持たない規約は、ホームではなくリポジトリに置いてかまいません。
  • まず、AGENTS.md に数行書けば足りないかを考える。足りるなら AGENTS.md に書く。
  • スキルにするなら、
    .agents/skills/<スキル名>/SKILL.md
    に正本を置き、
    .claude/skills/<スキル名>
    から相対シンボリックリンクを張り、AGENTS.md のスキル表に行を足す。突き合わせの手順は refresh-skills に書いてある。
  • philtzjp/skills と同じ名前にしない。
  • 他のリポジトリでも役立つと分かったら、skill-escalation に従って philtzjp/skills への追加を提案する。
AGENTS.md には、導入していないスキルを前提にした規約を書かないでください。
仅在特定仓库中才有意义的规范，可以放在仓库中，而不是 home 目录中。
  • 首先考虑在 AGENTS.md 中写几行是否足够。如果足够，就写入 AGENTS.md。
  • 如果需要创建 skill，应将正本放在 
    .agents/skills/<スキル名>/SKILL.md
    ，从 
    .claude/skills/<スキル名>
    创建相对符号链接，并在 AGENTS.md 的 skill 表中增加一行。核对步骤见 refresh-skills。
  • 不要使用与 philtzjp/skills 相同的名称。
  • 如果确认该 skill 在其他仓库中也有用，则按照 skill-escalation 的规定，提议将其添加到 philtzjp/skills。
不要在 AGENTS.md 中编写以尚未安装的 skill 为前提的规范。