refactor(setup): split Makefile into mise tasks and shell scripts

Reorganize the Makefile as a thin dispatcher to mise tasks, with the
setup logic split across mise/tasks/ and scripts/.

- Centralize colored output helpers in scripts/common.sh
- Keep in scripts/ only what bootstrap requires before mise is available
  (homebrew, mise) or what is reused across multiple tasks
  (link-dotfiles, install-zinit, refresh-zsh-completion)
- Inline single-use thin wrappers directly into mise tasks
- Add a help target that lists tasks grouped by section

Author: mhiro2

.github/workflows/ci.yaml

@@ -17,8 +17,11 @@ defaults:
   run:
     shell: bash -euo pipefail {0}
 
+permissions:
+  contents: read
+
 jobs:
-  build:
+  test:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
@@ -28,8 +31,11 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - name: Install
+      - name: Install mise
+        run: |
+          curl -fsSL https://mise.run | sh
+          echo "${HOME}/.local/bin" >> "${GITHUB_PATH}"
+      - name: Check Makefile entrypoints
         run: |
-          make init
-          make brew
-          make zinit
+          make help
+          make -n install

Makefile

@@ -1,180 +1,50 @@
-XDG_CONFIG_FILES := bat cmux ghostty git mise nvim tmux
-EXCLUDE_FILES    := .DS_Store .git .github .gitignore .gitmodules .claude .tmux
-CLAUDE_FILES     := .claude/settings.json .claude/statusline.py
-DOT_FILES        := $(filter-out $(EXCLUDE_FILES), $(wildcard .??*))
-DOT_FILES_ALL    := $(DOT_FILES) $(XDG_CONFIG_FILES)
+.DEFAULT_GOAL := help
+
+MISE_TASK := ./scripts/run-mise-task.sh
+
+.PHONY: help
+help: ## タスク一覧を表示する
+	@awk 'BEGIN { FS = ":.*##" } \
+		/^## .* ##$$/ { \
+			title = $$0; \
+			gsub(/^## /, "", title); \
+			gsub(/ ##$$/, "", title); \
+			printf "\n\033[1m%s\033[0m\n", title; \
+			next; \
+		} \
+		/^[a-zA-Z0-9][a-zA-Z0-9_-]+:.*##/ { \
+			desc = $$2; \
+			gsub(/^[ \t]+/, "", desc); \
+			printf "  \033[36m%-24s\033[0m %s\n", $$1, desc; \
+		}' $(MAKEFILE_LIST)
+
+## セットアップ ##
 
-XDG_CONFIG_HOME ?= $(HOME)/.config
-
-BREW_CMD := $(shell command -v brew 2> /dev/null)
-MISE_CMD := $(shell command -v mise 2> /dev/null)
-ZINIT_DIR := $(HOME)/.local/share/zinit
-ZINIT_INSTALLED := $(shell test -d "$(ZINIT_DIR)/zinit.git" && echo installed)
-ZINIT_SCRIPT := $(ZINIT_DIR)/zinit.git/zinit.zsh
-TPM_DIR := $(XDG_CONFIG_HOME)/tmux/plugins/tpm
-TPM_INSTALLED := $(shell test -d "$(TPM_DIR)/.git" && echo installed)
-
-ZSH_COMPLETIONS_DIR := $(XDG_CACHE_HOME)/zsh/completions
-ZSH_COMPDUMP := $(XDG_CACHE_HOME)/zsh/.zcompdump
-
-COLOR_INFO := \033[1;34m
-COLOR_SUCCESS := \033[1;32m
-COLOR_SKIP := \033[1;33m
-COLOR_RESET := \033[0m
+.PHONY: install
+install: bootstrap ## すべての dotfiles セットアップタスクを実行する
+	@$(MISE_TASK) dotfiles:install
 
-.PHONY: all
-all: init brew zinit tpm mise prek refresh-completion treesitter fonts
+.PHONY: bootstrap
+bootstrap: brew mise ## make install に必要な最小ツールを用意する
 
 .PHONY: brew
-brew:
-ifeq ($(shell uname), Darwin)
-ifeq ($(BREW_CMD),)
-	@printf "$(COLOR_INFO)==> Homebrew をインストールします$(COLOR_RESET)\n"
-ifeq ($(shell uname -m), arm64)
-	NONINTERACTIVE=1 arch -arm64e /bin/bash -c "$$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-endif
-	NONINTERACTIVE=1 arch -x86_64 /bin/bash -c "$$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
-	@printf "$(COLOR_SUCCESS)✔ Homebrew のインストールが完了しました$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_SKIP)✔ Homebrew は既にインストール済みのためスキップします$(COLOR_RESET)\n"
-endif
-else
-	@printf "$(COLOR_SKIP)✔ macOS 以外のため Homebrew インストールをスキップします$(COLOR_RESET)\n"
-endif
+brew: ## Homebrew をインストールする
+	@./scripts/install-homebrew.sh
 
-.PHONY: clean
-clean:
-	@printf "$(COLOR_INFO)==> シンボリックリンクを削除します$(COLOR_RESET)\n"
-	@-$(foreach f, $(DOT_FILES), unlink $(HOME)/$(f);)
-	@-$(foreach f, $(XDG_CONFIG_FILES), unlink $(XDG_CONFIG_HOME)/$(f);)
-	@printf "$(COLOR_SUCCESS)✔ clean が完了しました$(COLOR_RESET)\n"
+.PHONY: mise
+mise: ## mise をインストールする
+	@./scripts/install-mise.sh
 
-.PHONY: install
-install:
-	@printf "$(COLOR_INFO)==> すべてのセットアップタスクを実行します$(COLOR_RESET)\n"
-	$(MAKE) all
-	@printf "$(COLOR_SUCCESS)✔ install が完了しました$(COLOR_RESET)\n"
+## dotfiles ##
 
 .PHONY: init
-init:
-	@printf "$(COLOR_INFO)==> シンボリックリンクを初期化します$(COLOR_RESET)\n"
-	mkdir -p $(XDG_CONFIG_HOME)
-	@-$(foreach f, $(DOT_FILES), ln -sf "$(PWD)/$(f)" "$(HOME)";)
-	@-$(foreach f, $(XDG_CONFIG_FILES), ln -sf "$(PWD)/$(f)" "$(XDG_CONFIG_HOME)";)
-	mkdir -p $(HOME)/.claude
-	@-$(foreach f, $(CLAUDE_FILES), ln -sf "$(PWD)/$(f)" "$(HOME)/$(f)";)
-	@printf "$(COLOR_SUCCESS)✔ init が完了しました$(COLOR_RESET)\n"
+init: ## dotfiles のシンボリックリンクを作成する
+	@$(MISE_TASK) dotfiles:init
 
-.PHONY: list
-list:
-	@printf "$(COLOR_INFO)==> 管理対象ファイルを一覧表示します$(COLOR_RESET)\n"
-	@$(foreach f, $(DOT_FILES_ALL), ls -dF $(f);)
-	@printf "$(COLOR_SUCCESS)✔ list が完了しました$(COLOR_RESET)\n"
+.PHONY: clean
+clean: ## dotfiles のシンボリックリンクを削除する
+	@$(MISE_TASK) dotfiles:clean
 
 .PHONY: upgrade
-upgrade:
-	@printf "$(COLOR_INFO)==> 各種ツールのアップグレードを実行します$(COLOR_RESET)\n"
-ifeq ($(shell uname), Darwin)
-ifeq ($(BREW_CMD),)
-	@printf "$(COLOR_SKIP)✔ Homebrew は未インストールのためスキップします$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_INFO)   -> Homebrew を更新します$(COLOR_RESET)\n"
-	@brew update
-	@HOMEBREW_NO_AUTO_UPDATE=1 brew upgrade
-	@printf "$(COLOR_SUCCESS)✔ Homebrew のアップグレードが完了しました$(COLOR_RESET)\n"
-endif
-else
-	@printf "$(COLOR_SKIP)✔ macOS 以外のため Homebrew アップグレードをスキップします$(COLOR_RESET)\n"
-endif
-ifeq ($(ZINIT_INSTALLED),)
-	@printf "$(COLOR_SKIP)✔ zinit は未インストールのためスキップします$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_INFO)   -> zinit を更新します$(COLOR_RESET)\n"
-	@zsh -ic "source \"$(ZINIT_SCRIPT)\"; typeset -i exit_code=0; zinit self-update || exit_code=$$?; zinit update --parallel || exit_code=$$?; wait || exit_code=$$?; exit $$exit_code"
-	@printf "$(COLOR_SUCCESS)✔ zinit のアップグレードが完了しました$(COLOR_RESET)\n"
-endif
-	@printf "$(COLOR_SUCCESS)✔ upgrade が完了しました$(COLOR_RESET)\n"
-
-.PHONY: mise
-mise:
-ifeq ($(MISE_CMD),)
-	@printf "$(COLOR_INFO)==> mise をインストールします$(COLOR_RESET)\n"
-ifeq ($(shell uname), Darwin)
-	HOMEBREW_NO_AUTO_UPDATE=1 brew install mise
-else
-	curl -s https://mise.run | sh
-endif
-	@printf "$(COLOR_SUCCESS)✔ mise のインストールが完了しました$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_SKIP)✔ mise は既にインストール済みのためスキップします$(COLOR_RESET)\n"
-endif
-	mise install
-
-.PHONY: prek
-prek:
-	@printf "$(COLOR_INFO)==> prek フックをインストールします$(COLOR_RESET)\n"
-	@prek install --overwrite --install-hooks
-	@printf "$(COLOR_SUCCESS)✔ prek フックのインストールが完了しました$(COLOR_RESET)\n"
-
-.PHONY: completions
-completions:
-	@printf "$(COLOR_INFO)==> zsh 補完スクリプトを再生成します$(COLOR_RESET)\n"
-	@rm -rf "$(ZSH_COMPLETIONS_DIR)"
-	@mkdir -p "$(ZSH_COMPLETIONS_DIR)"
-	@zsh -ic '\
-	  setopt clobber; \
-	  ZSH_LOCAL_COMPLETIONS="$(ZSH_COMPLETIONS_DIR)"; \
-	  [[ -x "$$(command -v docker)" ]] && docker completion zsh >! "$$ZSH_LOCAL_COMPLETIONS/_docker"; \
-	  [[ -x "$$(command -v kubectl)" ]] && kubectl completion zsh >! "$$ZSH_LOCAL_COMPLETIONS/_kubectl"; \
-	  [[ -n "$$(command -v mise)" ]] && mise completion zsh >! "$$ZSH_LOCAL_COMPLETIONS/_mise"; \
-	  [[ -x "$$(command -v uv)" ]] && uv generate-shell-completion zsh >! "$$ZSH_LOCAL_COMPLETIONS/_uv"; \
-	'
-	@printf "$(COLOR_SUCCESS)✔ completions の再生成が完了しました$(COLOR_RESET)\n"
-
-.PHONY: compdump
-compdump:
-	@printf "$(COLOR_INFO)==> zsh 補完ダンプを更新します$(COLOR_RESET)\n"
-	@rm -f "$(ZSH_COMPDUMP)" "$(ZSH_COMPDUMP).zwc"
-	@zsh -ic 'autoload -Uz compinit; compinit -u -C -d "$(ZSH_COMPDUMP)"; [ -f "$(ZSH_COMPDUMP)" ] && zcompile "$(ZSH_COMPDUMP)"'
-	@printf "$(COLOR_SUCCESS)✔ compdump の更新が完了しました$(COLOR_RESET)\n"
-
-.PHONY: refresh-completion
-refresh-completion: completions compdump
-	@printf "$(COLOR_SUCCESS)✔ zsh 補完の再生成とダンプ更新が完了しました$(COLOR_RESET)\n"
-
-.PHONY: zinit
-zinit:
-ifeq ($(ZINIT_INSTALLED),)
-	@printf "$(COLOR_INFO)==> zinit をインストールします$(COLOR_RESET)\n"
-	NO_INPUT=1 NO_ANNEXES=1 NO_EDIT=1 NO_TUTORIAL=1 bash -c "$$(curl --fail --show-error --silent --location https://raw.githubusercontent.com/zdharma-continuum/zinit/HEAD/scripts/install.sh)"
-	@printf "$(COLOR_SUCCESS)✔ zinit のインストールが完了しました$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_SKIP)✔ zinit は既にインストール済みのためスキップします$(COLOR_RESET)\n"
-endif
-
-.PHONY: tpm
-tpm: init
-ifeq ($(TPM_INSTALLED),)
-	@printf "$(COLOR_INFO)==> TPM をインストールします$(COLOR_RESET)\n"
-	@mkdir -p "$(XDG_CONFIG_HOME)/tmux/plugins"
-	git clone https://github.com/tmux-plugins/tpm "$(TPM_DIR)"
-	@printf "$(COLOR_SUCCESS)✔ TPM のインストールが完了しました$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_SKIP)✔ TPM は既にインストール済みのためスキップします$(COLOR_RESET)\n"
-endif
-
-.PHONY: treesitter
-treesitter:
-	@printf "$(COLOR_INFO)==> Tree-sitter parser をローカル生成します$(COLOR_RESET)\n"
-	@./nvim/scripts/build-treesitter-parsers.sh
-	@printf "$(COLOR_SUCCESS)✔ Tree-sitter parser の生成が完了しました$(COLOR_RESET)\n"
-
-.PHONY: fonts
-fonts:
-ifeq ($(shell uname), Darwin)
-	@printf "$(COLOR_INFO)==> Moralerspace Neon フォントをインストールします$(COLOR_RESET)\n"
-	@./scripts/install-fonts.sh
-	@printf "$(COLOR_SUCCESS)✔ フォントのインストールが完了しました$(COLOR_RESET)\n"
-else
-	@printf "$(COLOR_SKIP)✔ macOS 以外のためフォントインストールをスキップします$(COLOR_RESET)\n"
-endif
+upgrade: ## 管理対象ツールを更新する
+	@$(MISE_TASK) dotfiles:upgrade

README.md

@@ -11,3 +11,5 @@ git clone https://github.com/mhiro2/dotfiles
 cd dotfiles
 make install
 ```
+
+`make install` bootstraps Homebrew/mise when needed, then delegates to mise tasks.

mise/tasks/bootstrap/homebrew

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="Homebrew をインストールする"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+./scripts/install-homebrew.sh

mise/tasks/bootstrap/mise

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="mise をインストールする"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+./scripts/install-mise.sh

mise/tasks/bootstrap/tpm

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+#MISE description="tmux plugin manager をインストールする"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+# shellcheck source=scripts/common.sh
+source "${REPO_ROOT}/scripts/common.sh"
+
+readonly xdg_config_home="${XDG_CONFIG_HOME:-${HOME}/.config}"
+readonly tpm_dir="${xdg_config_home}/tmux/plugins/tpm"
+
+if [[ -d "${tpm_dir}/.git" ]]; then
+  skip "TPM は既にインストール済みのためスキップします"
+  exit 0
+fi
+
+info "TPM をインストールします"
+mkdir -p "${xdg_config_home}/tmux/plugins"
+git clone https://github.com/tmux-plugins/tpm "${tpm_dir}"
+success "TPM のインストールが完了しました"

mise/tasks/dotfiles/clean

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="dotfiles のシンボリックリンクを削除する"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+./scripts/link-dotfiles.sh clean

mise/tasks/dotfiles/init

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+#MISE description="dotfiles のシンボリックリンクを作成する"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+./scripts/link-dotfiles.sh init

mise/tasks/dotfiles/install

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+#MISE description="すべての dotfiles セットアップタスクを実行する"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+mise run dotfiles:init
+mise run bootstrap:homebrew
+mise run bootstrap:tpm
+mise run zsh:zinit
+
+mise install
+
+mise run zsh:refresh-completion
+mise run nvim:treesitter
+mise run fonts:install
+
+prek install --overwrite --install-hooks

mise/tasks/dotfiles/upgrade

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+#MISE description="mise tools と zinit を更新する"
+set -euo pipefail
+
+TASK_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+readonly TASK_DIR
+REPO_ROOT="$(git -C "${TASK_DIR}" rev-parse --show-toplevel)"
+readonly REPO_ROOT
+cd "${REPO_ROOT}"
+
+# shellcheck source=scripts/common.sh
+source "${REPO_ROOT}/scripts/common.sh"
+
+info "各種ツールのアップグレードを実行します"
+
+mise self-update
+mise up
+
+"${REPO_ROOT}/scripts/install-zinit.sh" update
+success "upgrade が完了しました"