---
title: "install-doctor"
url: "https://claudemods.dev/zh-cn/builds/install-doctor-c6a5e9"
source: "https://github.com/ray-manaloto/dotfiles/tree/main/.claude/skills/install-doctor"
source_type: "github"
repo: "https://github.com/ray-manaloto/dotfiles/tree/main/.claude/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.348Z"
updated: "2026-11-18T05:22:49Z"
locale: "zh-cn"
content_locale: "zh-cn"
---

# 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
```
