本文へ移動
cccskills
無料GitHub で公開

neovim-treesitter-runtime

dotfiles の Neovim Treesitter parser runtime を Home Manager と templates のどちらに置くべきか判断し、必要な Nix とドキュメントを更新するためのスキル

rito528/dotfiles
インストール方法を見る

含まれるファイル（1）

  • SKILL.md2.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

neovim-treesitter-runtime

このリポジトリで Treesitter parser runtime の配置先を決めるときに使う。

判断ルール

  • modules/neovim/default.nix に置く:
    • dotfiles 自身でも頻繁に使う
    • 設定ファイルやドキュメントのように複数プロジェクトで横断的に編集する
    • 常時グローバル配備でも責務がぶれにくい
  • templates/*/flake.nix に置く:
    • その template の主要実装言語である
    • 他の template では不要である
    • LSP / formatter / build tool もその shell に閉じている

基本は「共通 grammar は Home Manager、追加 grammar は template shell」。

実装手順

  1. 追加・変更したい grammar が共通か project 固有かを判定する
  2. 共通なら modules/neovim/default.nix の commonTreesitterRuntime を更新する
  3. project 固有なら対象 templates/*/flake.nix の treesitterRuntime を更新する
  4. modules/neovim/base.nix が NVIM_TREESITTER_RUNTIME_GLOBAL と NVIM_TREESITTER_RUNTIME_PROJECT を読む前提を壊していないか確認する
  5. 判断軸に影響する変更なら modules/neovim/AGENTS.md と必要に応じて docs-site/src/dev-environment-templates.md を更新する
  6. .nix を変更したら nixfmt を実行する

注意点

  • template 側に共通 grammar を重複定義しない
  • Home Manager 側に project 専用 grammar を増やしすぎない
  • Treesitter runtime の配布先を変えるときは、実装だけでなく判断軸の文書も同時に更新する

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

add-npm-package

無料日本語概要

modules/npm/packages/ に新しい npm/pnpm パッケージを追加するスキル

rito528/dotfiles22026年10月12日 更新

add-script

無料日本語概要

install/ 配下に新しいセットアップ用シェルスクリプトを追加するスキル

rito528/dotfiles22026年10月12日 更新

create-issue

無料日本語概要

GitHub issue を新規作成・下書きするとき、または既存 issue の本文を書き直すときに必ず使うスキル。「issue を作って」「issue 化して」「これを issue にまとめて」のような依頼で発火し、`gh issue create` を直接呼ぶ前に必ず参照する。人間が合意した内容だけを、意味を足さずに issue へ残すための基準を定める。

rito528/dotfiles22026年10月12日 更新

create-pr

無料日本語概要

GitHub に Pull Request を作成するスキル。ユーザーが「PRを作って」「プルリクエストを出して」「PR作成して」と言ったとき、またはコミット済みの変更をレビューに出したいときに使用する。

rito528/dotfiles22026年10月12日 更新

domain-design-safety-discipline

無料日本語概要

ドメインモデル、可視性、操作可能性、不変条件、層境界、API 設計に関わる実装時に使う。不正な状態や誤った呼び出し方を、型、関数の境界、ドメイン語彙で表し、正しい使い方が自然になる設計へ寄せるためのスキル。

rito528/dotfiles22026年10月12日 更新

ensure-branch

無料日本語概要

コミットやPR作成の前に、作業ブランチが適切かどうかを確認・切り替えるスキル。git-commit や create-pr からサブルーチンとして呼び出される。

rito528/dotfiles22026年10月12日 更新

rito528 のスキルをすべて見る

このスキルの問題を報告する