---
title: "install-doctor"
url: "https://claudemods.dev/zh-tw/builds/install-doctor-6e1b3d"
source: "https://github.com/ray-manaloto/dotfiles/tree/main/.agents/skills/install-doctor"
source_type: "github"
repo: "https://github.com/ray-manaloto/dotfiles/tree/main/.agents/skills/install-doctor"
author: "ray-manaloto"
author_handle: "ray-manaloto"
stars: 0
category: "開發與除錯"
categories: ["debug"]
tags: ["Claude Code", "mod"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add ray-manaloto/dotfiles\nclaude plugin install install-doctor"
added: "2026-10-03T11:30:47.345Z"
updated: "2026-11-18T05:22:49Z"
locale: "zh-tw"
content_locale: "zh-tw"
---

# install-doctor

在對話開始時檢查外掛安裝狀態，指出設定問題。

## Description

本作品由社群作者維護。功能、版本需求與設定方式，請查看下方原始 README。本站提供權限掃描結果；安裝前請檢查原始碼與外部相依套件。

## Install

```
claude plugin marketplace add ray-manaloto/dotfiles
claude plugin install install-doctor
```

## Original README

# Reproducible Dotfiles (AMD64)

A highly resilient, declarative dotfiles setup using **Chezmoi**, **Mise**, and **Python**, optimized for Linux-based devcontainers.

## Quick Start

### Local Development

```bash
mise install                                       # Install all tools
mise run lint                                      # Run lint checks (read-only ≡ CI; `mise run fmt` auto-fixes)
uv run --project python pytest tests/ -x -q      # Run all 190 tests
```

### Docker Build

```bash
docker buildx bake dev-load                        # Build devcontainer locally
```

### Bootstrap (Container)

```bash
curl -fsSL https://raw.githubusercontent.com/sortakool/dotfiles/main/install.sh | bash
```

## Architecture

1.  **Stage 0**: `install.sh` bootstraps `mise`.
2.  **Stage 1**: `mise` installs `git`, `chezmoi`, and `uv`.
3.  **Stage 2**: `chezmoi init` clones the repo and applies templated configs.
4.  **Stage 3**: Python lifecycle hooks (`uv run`) handle complex orchestration and tool installations.

## Features

-   **Strictly AMD64**: Forced x86_64 architecture for container consistency.
-   **Declarative Config**: Pydantic `DotfilesConfig` centralizes 16 env vars; `hk.pkl` for git hooks with shared `hk-common.pkl` checks.
-   **Zero-Bash**: Logic is encapsulated in a typed, linted Python library (`dotfiles_setup`).
-   **Zero Lint Suppressions**: No `noqa`, `type: ignore`, or `pylint: disable` — enforced by `no_lint_skip` hk step.
-   **Environment Auditor**: Built-in health checks for identity, toolchains, and SSH connectivity.
-   **CI/CD**: GitHub Actions — lint → contract-preflight → a `changes` path-gate → base-prep → p2996-prep → build → smoke-test (smoke + Dive); `promote` retags on main; benchmark + Trivy run async in `image-analysis.yml`. Docs-only changes skip the build chain.

## Tool Management

All tools are declared in `mise.toml` and installed via `mise install`.
Python dependencies are managed via `uv` with `python/pyproject.toml`.

## Local Testing

```bash
uv run --project python pytest tests/ -x -q      # All tests
uv run --project python dotfiles-setup verify run # Contract verification
mise run pin-actions                                # Verify GHA SHA-pinning
mise run lint-docs                                  # Validate agent documentation
```
