Environment Triage

作者 parcadeid07ff4b06b62無授權條款3.9K 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫8 個月前更新

Environment Triage

僅含說明Software Development
AI 產生的概覽

當 uv 或 pip 安裝行為異常時，診斷 Python 解譯器不一致的問題。

功能
此技能提供一套排查流程，用於 uv sync 或 pip install 行為不如預期的情況。它引導代理檢查 uv 實際使用的解譯器、.python-version 中固定的版本，以及某個套件是否已在 uv 環境中安裝並可匯入。它也提供常見修正方式：更新固定的 Python 版本、重建虛擬環境，並以全部 extras 重新同步。
適用情境
當 uv sync 或 pip install 出現異常結果、選用相依套件似乎被略過，或安裝看似成功但匯入失敗時使用。它適用於以 uv 管理、且目前解譯器可能與系統 Python 不同的 Python 專案。
執行需求
不隨附指令碼，僅為說明性指示。它假定專案使用 uv 並帶有 .python-version 檔案，且具備可執行 uv 指令的 shell 存取權限。

Environment Triage

When uv sync or pip install behaves unexpectedly, check the actual interpreter.

Pattern

System Python is not authoritative if uv/venv selects a different interpreter.

DO

bash
# What uv ACTUALLY usesuv run python --version
# What's pinned (this controls uv)cat .python-version
# Confirm package is installeduv pip show <package>
# Confirm import works in uv contextuv run python -c "import <package>; print(<package>.__version__)"

Common Fix

If optional deps require Python 3.12+ but .python-version is 3.11:

bash
echo "3.13" > .python-versionrm -rf .venv && uv venv && uv sync --all-extras

DON'T

  • Trust python3 --version when using uv
  • Assume install succeeded without verifying import
  • Debug further before checking interpreter version

Source Sessions

  • 2243c067: symbolica-agentica skipped due to python_version >= 3.12 marker, but uv was using 3.11
  • 4784f390: agentica import failures traced to wrong interpreter

來源與署名

來源：parcadei/continuous-claude-v3位於.claude/skills/environment-triage提交d07ff4b

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 parcadei/continuous-claude-v3 的技能

Tldr Stats

parcadei

顯示工作階段 token 用量、API 費用、TLDR 壓縮節省金額與 hook 活動的儀表板。

Data & Analytics3.9K8 個月前更新

Wiring

parcadei

指導驗證已建置的基礎設施元件是否真的被呼叫，而非成為死程式碼。

Software Development3.9K8 個月前更新

Workflow Router

parcadei

將使用者的目標路由到對應的專家代理與資源層級，用於研究、規劃、建置或修復任務。

AI & Agents3.9K8 個月前更新

Validate Agent

parcadei

依據當前最佳實務驗證技術方案中的技術選型，並產出驗證交接文件。

Software Development3.9K8 個月前更新

Tour

parcadei

當使用者詢問能力時，提供友善的入門導覽，概述代理能做什麼。

AI & Agents3.9K8 個月前更新

Tldr Overview

parcadei

使用 TLDR 工具鏈產生節省 token 的專案概覽，涵蓋檔案樹、程式結構、呼叫圖與複雜度。

Software Development3.9K8 個月前更新

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Web Design Guidelines

vercel-labs

精選

依據從遠端來源取得的 Web Interface Guidelines 審查 UI 程式碼，並以 file:line 形式回報問題。

Software Development32K5 週前更新

Vercel React Native Skills

vercel-labs

精選

React Native 與 Expo 最佳實務規則，涵蓋清單效能、動畫、導覽、UI 模式、狀態與 monorepo 設定。

Software Development32K5 週前更新

Vercel React Best Practices

vercel-labs

精選

Vercel 的 React 與 Next.js 效能指南，以 70 條規則的形式用於撰寫、審查與重構程式碼。

Software Development32K5 週前更新