Everything Claude Code Project Guidelines Example Skill 是一套基于真实生产项目（如 Zenith）提炼的项目级 Skill 模板，专为 Claude Code、Codex、Cursor 等 AI 编程助手打造。它详细定义了项目架构、目录结构、核心代码模式、测试要求、部署流程和关键规则，帮助开发者为每个项目快速建立专属的 AI 协作规范。通过该 Skill，团队可系统性提升代码一致性、自动化水平与交付质量，是自定义项目级 Skill 的理想起点。

Everything Claude Code Project Guidelines Example Skill：真实生产项目 Skill 模板，自定义项目级 Skill 起点

在 AI 编程助手（如 Claude Code、Cursor、Codex）日益融入团队开发流程的今天，如何让 AI 理解并遵循你项目的独特规范，成为提升协作效率的关键。Project Guidelines Example Skill（项目级规范示例 Skill）正是为此设计——它基于真实生产项目（如 Zenith），为每个项目量身定制一份“AI 能读懂的开发手册”，让 AI 代理和开发者都能按同一套标准高效协作。

本指南将详细介绍如何用好 Project Guidelines Example Skill，包括它解决的问题、典型触发场景、完整使用流程、输出示例，以及与常见 Agent/Skill 的协作关系。无论你是初次接触 Everything Claude Code，还是希望深度定制 AI 助手，这份 Skill 都是构建高效、可维护项目的坚实起点。

1. 解决什么问题？不用它时的痛点

在没有项目级 Skill 的情况下，AI 编程助手只能依赖通用规则或零散的上下文，容易出现以下问题：

• 架构理解偏差：AI 不了解你的项目技术栈、服务拆分，生成的代码不符合实际架构。
• 目录混乱：AI 可能把代码放错目录、命名不一致，影响可维护性。
• 代码风格不统一：缺少项目专属的 API 设计、错误处理、前后端交互等模式，导致风格分裂。
• 测试与部署遗漏：AI 不清楚你的测试覆盖率要求、部署流程，容易跳过关键环节。
• 关键规则被忽略：如禁止 console.log、强制 TDD、输入校验等，AI 不会主动遵守。

Project Guidelines Example Skill 通过结构化描述，把这些“团队默契”变成 AI 可读、可执行的标准，显著提升协作效率和产出质量。

2. 触发条件：什么时候激活？

• 新成员或 AI 代理参与项目开发时：自动加载该 Skill，让 AI 理解项目全貌。
• AI 生成/修改代码、文档、测试用例时：Skill 提供目录、模式、规则指引，确保输出合规。
• CI/CD、自动化 Hook 触发时：Skill 校验关键规则（如覆盖率、输入校验、无敏感信息等）。
• 定制化需求：当你需要为特定项目扩展、调整通用 Skill 时，以此为模板快速起步。

3. Step by Step：如何用好 Project Guidelines Example Skill

步骤 1：以模板为蓝本，创建你的项目级 Skill

复制 project-guidelines-example Skill，重命名为你的项目专属 Skill（如 project-guidelines-zenith），并根据实际情况补充/调整以下内容：

• 架构总览：明确前后端、数据库、AI 服务、部署平台等技术栈。
• 目录结构：标注各层级目录及其职责，便于 AI 精准定位代码。
• 核心代码模式：如 API 响应格式、前端 API 调用、AI 调用接口、React Hooks 等。
• 测试要求：覆盖率、测试目录、用例结构、常用命令。
• 部署流程：构建、环境变量、部署命令、前置检查清单。
• 关键规则：如禁止 emoji、强制 TDD、输入校验、文件大小限制等。

步骤 2：集成 Skill 到 Claude Code 或其他 AI 助手

• 将 Skill 文件放入 .claude/skills/ 目录下，或通过 Selective Install 按需加载。
• 配合 Agent Harness、Rules、Hooks 等机制，实现自动激活与校验（详见 Claude Code 快速上手指南）。

步骤 3：AI 生成代码/文档时自动引用

• 当 AI 需要生成 API、组件、测试、部署脚本等内容时，Skill 自动提供结构、模式和规则参考。
• 例如，AI 生成 FastAPI 路由时，会自动采用统一的 ApiResponse 响应模式；生成 React 组件时，遵循目录与命名约定。

步骤 4：CI/CD、自动化校验环节应用 Skill

• 在 PreToolUse/PostToolUse/Stop 等 Hook 阶段，Skill 可校验输出是否符合关键规则（如无 console.log、覆盖率达标、环境变量齐全等），参考 Everything Claude Code Hooks 实战。

步骤 5：持续迭代与团队共建

• 随项目演进，及时补充新模式、新规则，让 Skill 始终反映当前最佳实践。
• 可结合 Continuous Learning Skill 自动提取会话中的高频模式，反哺到项目级 Skill。

4. 输出示例：AI 生成的预期结果

假设你让 Claude Code 生成一个新的 FastAPI 路由，AI 会参考 Skill 输出如下代码：

from fastapi import APIRouter
from models import ApiResponse, User

router = APIRouter()

@router.get("/users/{user_id}", response_model=ApiResponse[User])
async def get_user(user_id: int):
    user = await get_user_from_db(user_id)
    if user:
        return ApiResponse.ok(user)
    return ApiResponse.fail("User not found")

再如，生成 React 组件测试用例时，AI 会自动采用团队约定的结构：

import { render, screen } from '@testing-library/react'
import { WorkspacePanel } from './WorkspacePanel'

describe('WorkspacePanel', () => {
  it('renders workspace correctly', () => {
    render(<WorkspacePanel />)
    expect(screen.getByRole('main')).toBeInTheDocument()
  })
})

5. 常见配套 Agent 与 Skill 协作关系

• 与 Coding Standards Skill 配合：统一代码风格与最佳实践，见 coding-standards.md。
• 与 Backend/Frontend Patterns Skill 联动：补充更细致的 API、数据库、React/Next.js 模式。
• 与 TDD Workflow Skill 结合：强制测试先行与覆盖率要求，见 tdd-workflow.md。
• 与自动化 Hooks、Rules 配合：实现输出校验与违规阻断，详见 Everything Claude Code Rules 体系详解。

6. 常见问题与注意事项

Q: 这个 Skill 适合所有项目吗？ A: 它是模板，需根据每个项目实际情况调整内容，才能发挥最大价值。

Q: 如何保证 Skill 始终反映最新项目规范？ A: 建议每次架构/流程/规则变更时同步更新 Skill，并鼓励团队成员共同维护。

Q: Skill 会不会限制创新或灵活性？ A: Skill 旨在统一基础规范，细节可留有扩展空间，实际应用中可灵活调整。

---

通过 Project Guidelines Example Skill，开发团队和 AI 编程助手能在同一起跑线上协作，极大提升项目交付效率与质量。如果你希望进一步自动化、细化规则，建议结合 Everything Claude Code 完全指南 和 高级技巧 深入探索。