Community编程与开发github.com

peterruiter/claude-build-framework

检查配置文件所需的所有工具是否已安装且版本足够新(包括 git、GitHub CLI、Node.js、npm,以及配置文件自身的工具,例如 .NET SDK、PowerShell 7、Azure CLI、Power Platform CLI、LocalDB、k6),并针对缺失项给出各操作系统的精确安装命令。在 new-project 和 quality-gate 开始时自动运行。当用户说“检查我的工具”、“我需要安装什么”、“我的机器准备好了吗”,或者命令因“无法识别”/“找不到命令”而失败时使用。

claude-build-framework 是什么?

此技能(peterruiter/claude-build-framework)是一个 AI 工具链验证与修复助手,专为 Claude Code、Cursor 或 Codex 等 AI 代理设计。它的核心功能是自动检测开发配置文件所需的所有必备工具是否已安装且版本符合最低要求。该技能会检查多个工具(如 git、GitHub CLI、Node.js、npm、.NET SDK、PowerShell 7、Azure CLI、Power Platform CLI、LocalDB、k6 等),并针对缺失或过旧的工具,根据用户的操作系统(Windows、macOS、Linux)提供精确的安装命令或文档链接。它通过在 `new-project` 和 `quality-gate` 阶段自动运行,或在用户手动请求时(例如说“检查我的工具”或命令因“找不到命令”而失败)触发。工作流程包括:根据项目配置文件或用户参数选择相应的配置文件,执行一个 Node.js 脚本来逐个检查工具,并以简洁表格形式报告结果。该技能不会自动安装系统级工具,而是提供命令供用户自行安装,然后要求用户在新终端中重新检查。这有助于确保开发环境的完整性和一致性,减少因缺少工具导致的部署或构建失败。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/peterruiter/claude-build-framework/tree/HEAD/skills/check-tools

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

检查工具

  1. 选择配置文件:使用参数指定的配置文件,否则使用项目 CLAUDE.md 中命名的配置文件,否则询问用户 (列出 ${CLAUDE_PLUGIN_ROOT}/profiles/ 目录下的文件夹)。可以同时检查多个配置文件, 例如 dataverse-solution power-platform-pcf dataverse-plugins。
  2. 运行 node "${CLAUDE_PLUGIN_ROOT}/scripts/check-prereqs.mjs" <profile ...>。
    • 退出码 0:所有必需工具都已安装(可选工具可能仍会列出)。
    • 退出码 1:某个必需工具缺失或版本低于最低要求。
    • Node.js 缺失(命令本身运行失败):给出对应操作系统的 Node.js 安装命令并停止。
  3. 以简短的表格形式报告:工具名称、找到的版本、所需版本、状态。然后,仅针对缺失或版本过旧的工具,显示当前操作系统的安装命令和文档链接。
  4. 除非所有者要求,否则不要自行安装系统级工具;他们安装后,要求他们打开新的终端(PATH)并再次运行检查。

每个配置文件的工具列表位于 ${CLAUDE_PLUGIN_ROOT}/profiles/<profile>/prerequisites.json; 框架自身的工具列表位于 ${CLAUDE_PLUGIN_ROOT}/prerequisites.json。要添加一个工具,请添加一个包含 id、name、command、args、pattern(版本位于组 1 中)、可选的 min、required、why、install(针对 windows/macos/linux)和 docs 的条目;自测会检查每个条目。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

peterruiter/claude-build-framework

Full accessibility pass to WCAG 2.2 AA - axe-core through Playwright over every main page in light and dark at 1440/390 (and 320 for reflow), probes for skip link, one h1, lang, visible and unobscured focus, 24px targets and sideways scrolling, a keyboard script for dialogs/drawers/tabs, manual checks (text spacing, zoom, dragging alternatives, accessible authentication), contract tests for shared components and theme contrast, fixes, known limitations with reasons and an accessibility statement page. Use when the user asks for an "accessibility pass", "WCAG", "a11y audit", "screen reader", or before the first public release.

peterruiter/claude-build-framework

Write one complete agent brief from the framework's template for a single piece of work (feature, fix, polish, translation, accessibility or security item), with context, scope, reserved migration slot, scratch database, ports, file ownership, the standing rules (all configured languages, WCAG 2.2 AA, light and dark, privacy, data residency, What's new, no AI attribution), the gate and the report format. Use when the user or the plan-wave skill needs a brief, or says "write a brief", "brief an agent", "delegate this".

peterruiter/claude-build-framework

Build a sync from a SaaS product to customers' Dynamics 365 / Dataverse environments and Customer Insights - Journeys (multi-tenant app with admin consent and an application user, Web API upserts, contact matching, leads, timeline notes, custom triggers, marketing lists, deep links), tested against a stand-in and a marked sandbox. Use when the owner asks for a Dynamics 365, Dataverse, Power Platform or Customer Insights - Journeys integration.

peterruiter/claude-build-framework

Apply, switch or regenerate a project's design system (the one source of colours, fonts, logos, chart, email, document and video styles for every output), check its contrast in light and dark, and add a new design system to the framework from a Claude Design System artifact. Uses scripts/design-system.mjs to generate tokens.css, tokens.ts, a Fluent UI theme, a model-driven app theme, email and chart palettes, the video-tour brand block and an Office theme mapping. Use when the user says "design system", "apply the brand", "use our house style", "switch theme", "rebrand", "regenerate the tokens", "check contrast", or "add a design system".

相关技能