mirrors/misskey
1
0
Fork 1
mirror of https://github.com/misskey-dev/misskey.git synced 2026-07-26 05:35:22 +02:00
Code Releases Activity
Files
develop
misskey/.claude/skills
History
かっこかり d0de75d33f deps: update dependencies (#17751) 
* deps: update dependencies

* update changelog-checker lockfile

* deps: update typescript to v7

* fix: replace tsgo -> tsc

* fix: replace tsgo -> tsc

* deps: update other major dependencies, downgrade typescript for frontend-stack
2026-07-20 18:11:58 +09:00
..
context-budget
docs: AI コーディングエージェント共通設定を追加 (#17396)
2026-05-12 17:56:06 +09:00
creating-issues-and-prs
docs(agents): エージェント向けのドキュメントを拡充 (#17582)
2026-06-18 20:23:15 +09:00
shipping-misskey-change
chore(llm/docs): .claude配下の再構成 (#17514)
2026-06-03 09:03:10 +09:00
working-on-backend
deps: update dependencies (#17751)
2026-07-20 18:11:58 +09:00
working-on-frontend
fix(frontend/test): follow-up of #17682 of 2 (#17685)
2026-07-08 22:37:19 +09:00
README.md
chore(llm/docs): .claude配下の再構成 (#17514)
2026-06-03 09:03:10 +09:00

README.md

.claude/skills/ — プロジェクト固有のカスタムスキル

Misskey 固有の繰り返しタスクを Claude にスムーズに実行させるための カスタムスキル を .claude/skills/<name>/SKILL.md 形式で配置する。

frontmatter (name + description) は、Claude が 自動でスキルを呼び出すか判断する 唯一の手がかりになる。description には用途を具体的かつ網羅的に書き、pushy なトリガー語 (例: "Use whenever ...", "Must be consulted before any ...") で発見されやすくする。

実装済スキルの一覧は本ファイルでは管理しない (腐敗するため)。各サブディレクトリの SKILL.md の frontmatter が自己説明として機能する。

構成方針

Anthropic 公式の Agent Skills ベストプラクティス に従い、以下の構造を採用する:

  • SKILL.md 本体は 500 行以下 (理想は 30-80 行の索引)
  • 詳細は references/tasks/ (手順) と references/knowledge/ (規約・背景知識) に分離 (progressive disclosure)
  • リンクは原則 references への 1 段リンク に留める (例外: 他 skill / agent への導線は可)
  • ファイルシステム上の references は読まれるまでゼロコンテキストコスト

ECC (everything-claude-code) 由来の MIT スキルが含まれる場合は、ファイル冒頭の SPDX ヘッダー + .claude/THIRD_PARTY_LICENSES.md §1 に出典を記載する。

新規スキルを追加する場合

  • .claude/skills/<name>/SKILL.md に YAML frontmatter (name + description) と本文 Markdown を書く
  • description は 三人称の "Use when ..." 形式 で、主要キーワード網羅。pushy なトリガー語 ("Must be consulted before ...") を入れる
  • disable-model-invocation: true は付けない (auto-invoke させたいため)
  • 主要参照ファイルへのリンクは、各 markdown ファイルからの相対パスで貼る (../../../../packages/backend/... のような形)。絶対パスは contributor のホームディレクトリ依存になるので使わない
  • 詳細を分ける場合は references/tasks/ (手順) / references/knowledge/ (知識) の二分に従う
  • スキル作成は /skill-creator (公式の skill-creator スキル) のガイドを経由するのが推奨

関連

  • 各スキルの description で自動索引される設計のため、実装済スキルの手書き索引 (一覧表) は本ファイルにも AGENTS.md にも持たない方針 (手書き索引は腐敗するため、frontmatter の description を唯一の索引とする)
  • スキルそのものの健全性検査は /harness-audit で採点できる
View Git Blame Copy Permalink