Project Compass Skill：双击即用的 CLAUDE.md + SKILL.md 对话生成器

Skill超级捕获手 技术创作者 2026-08-12 11 阅读

Project Compass（项目罗盘）是全球首个纯浏览器运行的对话式 CLAUDE.md 生成器。用户无需安装任何依赖，只需双击 HTML 文件、回答 4 个引导问题，AI 便会经历 7 个分析阶段（项目描述→架构分析→自动化规则→CLAUDE.md 生成→SKILL.md 提取→修补审查→文件导出），自动生成可直接用于 Claude Code 的 CLAUDE.md 和 SKILL.md 两个核心文件。整个过程 5–8 分钟，支持 Claude/GPT/DeepSeek/Qwen/GLM/Gemini/Moonshot 等 8+ 模型。因其零门槛的特性，该项目在 GitHub 上持续更新，并于 2026 年 6 月升级了 7 个 SKILL.md 以符合 Agent Skills 开放标准，迅速在 Claude Code 中文社区获得关注。

功能与原则

Project Compass 的核心功能是对话式生成 CLAUDE.md 和 SKILL.md 两个文件，帮助用户快速为 Claude Code 建立标准化的项目操作手册和可复用技能模块。其设计原则有三条：零依赖（纯 HTML + JS，浏览器即运行）、隐私优先（API Key 仅存本地 localStorage，不经任何中间服务器）、多模型支持（覆盖主流 LLM厂商，用户可自由选择）。

认可度

该项目最后更新于 2026 年 6 月 8 日，作者在该版本中将 7 个内置 SKILL.md 模板全面升级至 2025 年 12 月发布的 Agent Skills 开放标准，使生成的文件与 Claude Code、Codex、Pi 等平台完全兼容。在 Claude Code 中文社区（GitHub、CSDN、博客园等）多篇文章中均被列为”零门槛上手”推荐工具，口碑良好。

链接

GitHub：https://github.com/tybiefh-beep/project-compass

在线体验：https://tybiefh-beep.github.io/project-compass/

原作者

tybiefh-beep（GitHub 个人开发者），专注于 Claude Code 生态的工具链建设。除了 project-compass，还维护有 claude-skills 等相关仓库，持续活跃。

介绍

Claude Code 的使用效果高度依赖 CLAUDE.md 和 SKILL.md 两个文件的质量。手写 CLAUDE.md 需要深入理解项目的架构、编码规范和自动化规则，往往要花 45–60 分钟反复修改；传统模板工具又需要 npm 安装、命令行操作，门槛不低。

Project Compass 解决了这个痛点。它是一个单文件 HTML 应用，打开即用，通过 4 个引导问题（项目目标、技术栈、痛点、期望的 AI 自主程度）帮助用户理清思路，再由 AI 分 7 个阶段逐步分析和生成文件。用户无需懂 Agent Skills 规范，AI 会自动识别可复用的技能模块并生成符合标准的 SKILL.md。

生成的两个文件可直接放入项目根目录，Claude Code 下次启动时会自动读取，生成的代码将与项目规范完全一致，实现”一次配置、长期生效”。

特点

  • 零安装，双击即用：无需 npm、无需命令行，下载 HTML 文件双击即可在浏览器运行
  • 7 阶段智能生成：项目描述 → 架构分析 → 自动化规则 → CLAUDE.md → SKILL.md → 审查修补 → 文件导出，流程完整
  • 8+ 模型支持：Claude、GPT-4o、DeepSeek-chat、Qwen-max、GLM-4-plus、Gemini-2.5-pro、Moonshot-v1 及任何 OpenAI 兼容接口
  • 内置 7 个 SKILL.md 模板：涵盖前端、API、CLI、数据管道等常见项目类型，可直接复用或修改
  • 隐私安全：API Key 仅存浏览器 localStorage，所有请求直连厂商 API，无中间服务器
  • 完全开源：源代码公开，可自由审查、修改和二次分发

使用方法

方式一：在线体验（无需下载）

  1. 访问 https://tybiefh-beep.github.io/project-compass/
  2. 在左侧栏选择 AI 提供商，粘贴 API Key，点击”验证”
  3. 点击「+ 新建项目」，回答 4 个引导问题
  4. 等待 AI 完成 7 阶段生成（约 8–10 分钟）
  5. 下载 CLAUDE.md 和 SKILL.md，放入项目根目录

方式二：本地下载

  1. 下载 项目罗盘.html：https://github.com/tybiefh-beep/project-compass/raw/main/%E9%A1%B9%E7%9B%AE%E7%BD%97%E7%9B%98.html
  2. 双击文件，浏览器自动打开
  3. 后续步骤同上

安装 Skill（生成后）

将下载的 CLAUDE.md 和 SKILL.md 放入项目根目录即可，Claude Code 会自动识别并应用。

使用场景与人群

  • 刚接触 Claude Code 的开发者：不知道如何写 CLAUDE.md，直接用对话生成器快速上手
  • 有多项目维护需求的工程师：每个项目生成专属操作手册，避免 Claude Code 生成代码风格不一致
  • 希望将工作流固化为 Skill 的团队：自动提取可复用技能模块，实现”自动化规则”标准化
  • 关注隐私的开发者：不愿用第三方工具，希望 API Key 全程本地存储

输入与输出案例

输入示例

用户回答 Project Compass 的 4 个问题：

  • 项目类型：React Dashboard
  • 技术栈：React + TypeScript + Tailwind CSS + Jest
  • 最大痛点：Claude Code 生成的组件风格总与项目规范不一致，审查改动的比例高达 50%
  • 期望 AI 自主程度：测试和构建自动化，UI 代码需人工 review

输出示例

Project Compass 生成两个文件：

  • CLAUDE.md：包含项目结构说明（组件目录、状态管理方案）、编码规范（TypeScript 类型要求、Tailwind 原子化 CSS 使用规则）、自动化策略（何时自动运行 Jest、何时触发 pre-commit hook）、禁止行为（不要用 CSS-in-JS、不要改 .env 配置）
  • SKILL.md：提取了 test-driven-review（TDD 流程）、component-consistency-check（组件规范验证）两个可复用技能模块的定义和使用条件

放入项目根目录后，Claude Code 生成的代码与项目标准高度一致，审查改动从 50% 降至约 10%，节省 5+ 小时沟通和返工时间。

GitHub: https://github.com/tybiefh-beep/project-compass

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读