尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
【计算机工具类-开发工具Skills】cc-skill-project-guidelines-example 技能
Project Guidelines Skill (Example) - 项目指南技能示例用于特定项目的架构、代码模式和部署工作流程。技能概述cc-skill-project-guidelines-example 技能是一个项目特定技能的示例模板。该技能包含了项目的架构概览、文件结构、代码模式、测试要求和部署工作流程。基于真实的生产应用程序 ZenithAI驱动的客户发现平台构建。下载地址https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/cc-skill-project-guidelines-example主要功能架构概览: 提供完整的技术栈信息包括前端、后端、数据库、AI服务和部署配置文件结构: 详细的项目目录结构说明帮助开发者快速定位代码代码模式: 提供标准化的代码模板包括API响应格式、前端API调用、Claude AI集成等测试要求: 明确的测试标准和覆盖率要求包括后端pytest和前端React Testing Library部署工作流程: 完整的部署前检查清单和部署命令触发条件在以下情况下应该调用此技能:当开发人员需要了解项目的整体架构和技术栈时当需要参考标准代码模式和最佳实践时当需要了解测试要求和部署流程时当为新项目创建类似的技能模板时技术架构技术栈前端: Next.js 15 (App Router), TypeScript, React后端: FastAPI (Python), Pydantic models数据库: Supabase (PostgreSQL)AI: Claude API with tool calling and structured output部署: Google Cloud Run测试: Playwright (E2E), pytest (backend), React Testing Library代码模式示例API响应格式 (FastAPI)from pydantic import BaseModelfrom typing import Generic, TypeVar, OptionalT TypeVar(T)class ApiResponse(BaseModel, Generic[T]):success: booldata: Optional[T] Noneerror: Optional[str] Noneclassmethoddef ok(cls, data: T) - ApiResponse[T]:return cls(successTrue, datadata)classmethoddef fail(cls, error: str) - ApiResponse[T]:return cls(successFalse, errorerror)前端API调用 (TypeScript)interface ApiResponseT {success: booleandata?: Terror?: string}async function fetchApiT(endpoint: string,options?: RequestInit): PromiseApiResponseT {try {const response await fetch(/api${endpoint}, {...options,headers: {Content-Type: application/json,...options?.headers,},})if (!response.ok) {return { success: false, error: HTTP ${response.status} }}return await response.json()} catch (error) {return { success: false, error: String(error) }}}测试要求后端测试 (pytest)# 运行所有测试poetry run pytest tests/# 运行覆盖率测试poetry run pytest tests/ --cov. --cov-reporthtml# 运行特定测试文件poetry run pytest tests/test_auth.py -v前端测试 (React Testing Library)# 运行测试npm run test# 运行覆盖率测试npm run test -- --coverage# 运行E2E测试npm run test:e2e部署工作流程部署前检查清单所有测试在本地通过前端构建成功 (npm run build)后端测试通过 (poetry run pytest)没有硬编码的密钥环境变量已文档化数据库迁移已准备部署命令# 构建并部署前端 cd frontend npm run build gcloud run deploy frontend --source . # 构建并部署后端 cd backend gcloud run deploy backend --source .关键规则禁止表情符号: 代码、注释或文档中不得使用表情符号不可变性: 永远不要改变对象或数组TDD: 在实现之前编写测试80%覆盖率: 最低测试覆盖率要求小文件: 典型200-400行最多800行禁止console.log: 生产代码中不得使用正确的错误处理: 使用try/catch输入验证: 使用Pydantic/Zod相关技能coding-standards.md: 通用编码最佳实践backend-patterns.md: API和数据库模式frontend-patterns.md: React和Next.js模式tdd-workflow/: 测试驱动开发方法论使用限制仅在任务明确匹配上述范围时使用此技能。不要将输出作为环境特定验证、测试或专家审查的替代品。如果缺少所需的输入、权限、安全边界或成功标准请停止并寻求澄清。
RELATED

相关推荐

过滤器(Filter)和 拦截器(Interceptor)

过滤器(Filter)和 拦截器(Interceptor)

一、引言在开发过程中我们经常会遇到 过滤器(Filter) 和 拦截器(Interceptor),找个也是面试中容易被问道的一个问题,两者的使用和作用又颇为相似,是个容易被大家混淆的问题,在此总结下,希望能对大家有所帮助。二、Filt…

📅 2026/10/6 6:25:04
Spring Boot、Spring Cloud实现原理

Spring Boot、Spring Cloud实现原理

Spring,Srping Boot ,Srping Cloud三者的出现时间极其发展关系Spring -> Srping Boot -> Srping Cloud下面我们浅析一下三者的发展历程及其原理。Spring什么是springSpring框架是Java平台上的一种开源应用框架,提供具有控制反转特性的容…

📅 2026/9/30 8:20:04
lsblk Command in Linux: Syntax, Options  Practical Examples (Block Devices)

lsblk Command in Linux: Syntax, Options Practical Examples (Block Devices)

lsblk — quick reference Default listing Show the block-device tree with name, size, type, and mount points — no root required. When to useCommandDefault tree of all block deviceslsblkLimit output to one disk and its childrenlsblk /dev/sdaList format (…

📅 2026/9/30 8:26:48
MORE NEWS

更多资讯

📰

YAML声明式配置虚拟机,打造可复现的团队开发环境

最近帮一个朋友梳理本地开发环境,他抱怨最多的就是“新电脑到手,光装环境就折腾两天”。数据库、缓存、消息队列、微服务依赖,一个个手动装,版本还对不上。这其实是很多开发者的真实痛点:开发环境太脆弱,换…

📰

连锁门店管理系统选型解析:从技术路线到落地避坑

上个月帮一位做连锁烘焙的朋友做选型复盘,他问了我一个特别到位的问题:为什么我表哥的奶茶店用两千块的收银机就能管好,我开了二十家店却要花十几万上系统?这个问题背后,其实是很多连锁老板都没想清楚的一件事——你需…

📰

STM32电子密码锁实战:矩阵键盘与Flash掉电保存完整实现

简介:面向STM32入门学习者与电子设计爱好者,这是一份完整的基于STM32的电子密码锁设计方案,涵盖OLED屏幕SPI通信显示、矩阵键盘输入与密码校验等核心模块,可直接参考工程结构进行二次开发。资源包共142个文件,以35个C语…

📰

STM32F407六路串口DMA稳定收发实战指南

简介:本资源是一份面向STM32嵌入式开发者的高阶串口通信实践项目,聚焦STM32F407芯片在多路并发场景下的DMA高效传输与中断协同处理能力,特别适用于工业控制、多设备组网及物联网终端等需稳定承载6路串口通信的实际应用。资源包共106个文件&am…

📰

H.264源码包实战指南:从拆包编译到PSNR调优

简介:这份资源面向视频编码初学者与进阶开发者,围绕H.264标准提供从理论到实践的完整学习路径,帮助读者理解宏块划分、熵编码、运动估计、变换量化等核心编码环节。包内以源代码、标准文档与解析资料为主,源代码是理解算法实现细节…

📰

用S3 Vectors替代托管向量库,RAG存储成本直降85%

先把那笔“月度账单”摊开:RAG 项目的钱到底花在了哪做 RAG 问答系统做了快两年,我最大的体会之一是:很多人上线第一个 demo 时很兴奋,三个月后看到账单就笑不出来了。模型推理费用你以为是大头,但真正把预算悄悄吃掉的…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬