如何为 AI 编写项目指南（Project Guidelines）模版
解决 AI 在复杂项目中由于缺乏上下文而导致的代码风格不统一、架构违规等问题：通过构建一套包含技术栈、文件结构和核心模式的指南，让 AI 快速进入角色并产出符合项目标准的生产级代码。
为什么需要这个技能
当你让 AI 参与一个中大型项目时，简单的 Prompt 往往不足以让它理解项目的整体设计。AI 可能会生成一个虽然能运行但却与你现有架构完全不符的代码块，例如在 Next.js 15 项目中使用过时的 Pages Router 语法，或者在 FastAPI 后端中遗漏了标准化的 API 响应封装。
通过编写一份结构化的 Project Guidelines，你可以将项目的“潜规则”显性化。这相当于为 AI 提供了一本项目手册，使其在生成代码前先检索架构定义、目录规范和测试要求，从而大幅降低人工 Review 的成本。
适用场景
- 新项目启动：为 AI 设定一套基准规范，确保从第一行代码开始就符合预期。
- 团队成员交接：将复杂项目的架构逻辑转化为 AI Skill，让新加入的开发者通过 AI 快速上手。
- 统一代码质量：强制 AI 遵循 TDD（测试驱动开发）流程、特定的错误处理机制或 API 响应格式。
核心工作流
一套完整的项目指南应包含以下核心维度：
- 架构概览（Architecture Overview）：明确定义前端、后端、数据库及 AI 服务的技术栈及其交互关系。
- 目录结构（File Structure）：提供清晰的树状图，告知 AI 哪些逻辑应放在
services/，哪些应放在hooks/。 - 代码模式（Code Patterns）：提供关键的代码片段（如 API 响应基类、通用的 API 调用函数），要求 AI 在实现新功能时必须继承或参考这些模式。
- 测试与部署要求：定义具体的测试命令（如
pytest或playwright）及部署前检查清单。 - 关键约束（Critical Rules）：列出绝对禁止的行为（如禁止使用
console.log、禁止直接修改对象），以强制执行代码质量。
下载和安装
下载 cc-skill-project-guidelines-example 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐