cc-skill-project-guidelines-example

项目指南技能作为将领域特定工程标准嵌入 AI 代码编写代理的基础模板。它使开发人员能够记录项目的关键架构、技术栈和约定，确保代理充当确定性的助手，而不是错误代码的来源。此技能专为复杂的生产环境而设计，例如使用 Next.js、FastAPI、Supabase 和 Claude API 的系统。通过提供关于文件结构、API 响应格式和测试要求的明确指导，它帮助团队在大型软件项目中保持一致性。

• 封装架构概览，包括前端和后端服务通信模式。

• 标准化代码模式，例如 API 响应包装器、用于状态管理的 React Hooks 以及结构化的 AI 工具使用方式。

• 定义文件结构约定，例如路由逻辑、组件组织和公用程序放置位置。

• 嵌入测试要求，包括对 Playwright、pytest 和集成测试的要求，以确保代码验证。

• 提供用于记录部署工作流程和配置管理的强大框架。

• 非常适合管理生产环境中复杂代理工作流程的团队主管和架构师。

• 适用于引导新开发人员，或使用具有特定组织知识的自动化代码编写助手进行设置。

• 输入包括您的具体项目结构和指南，而输出则为代理提供了一个指导其代码生成的“单一事实来源”。

• 限制：当本地文档与仓库保持同步时可获得最佳结果；依赖于对定义架构的严格遵守以防止偏离。建议与其他专门的代理套件一起使用，以确保全面涵盖项目领域和运营需求。