System: {System Name}【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skillsRequirementsFunctional[What the system must do][Core features and capabilities]Non-FunctionalPerformance: Response time 200ms p95Availability: 99.9% uptime (8.76 hours downtime/year)Scalability: Support 10,000 concurrent usersSecurity: PCI DSS compliance requiredConstraintsBudget: $X/month for infrastructureTimeline: MVP in 3 monthsTeam: 5 backend, 3 frontend engineers- **Functional**功能需求回答系统必须做什么。建议按用户故事或能力域拆条每条以动词开头便于后续映射到具体组件。 - **Non-Functional**非功能需求回答做到多好。模板给出了四个可量化的示例维度实际写作时可参考 [nfr-checklist.md](https://link.gitcode.com/i/51e9aecc5b0f5d7421e6503c35d4f109) 扩展到七大类性能p95 响应时间、页面加载、查询耗时、可扩展性并发数、RPS、数据量、增长率、可用性可用性百分比与对应年停机时长换算、安全认证方式、授权模型、合规要求、加密、可靠性RPO/RTO、备份频率、容灾范围、可维护性部署频率、监控需求、值班要求、成本基础设施预算、运维预算。 - **Constraints**约束是需求中被给定死的部分——预算、时间线、团队规模。这三个约束往往直接决定后续架构选择的自由度例如5 后端 3 前端、3 个月 MVP这一组合基本排除了自建多团队微服务体系的选项。 ### 2. 高层架构High-Level Architecture 模板用 ASCII 图示意系统的拓扑结构┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ Client │────▶│ API Gateway │────▶│ Service │ │ (Web) │ │ (Kong) │ │ (Node.js) │ └─────────────┘ └─────────────┘ └─────────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ Auth │ │ Database │ │ (Auth0) │ │ (PostgreSQL)│ └─────────────┘ └─────────────┘画架构图的要点每一条连线都要有明确语义请求、数据流、事件流每个节点都要标注技术选型或组件名关键的非请求链路认证旁路、缓存旁路也应在图中体现避免评审者误解依赖方向。 需要说明的是SKILL.md 的 Output Templates 部分推荐 **Mermaid 作为首选** 的架构图格式Claude 可以直接生成可渲染的 Mermaid 源码更利于在文档站点、GitHub、知识库中展示ASCII 图适合终端或纯文本场景。两者可以并存正文给出 Mermaid注释或附录保留 ASCII。SKILL.md 中给出的 Mermaid 示例为  ### 3. 组件细节Component Details 模板将组件分为三层分别描述 markdown ## Component Details ### API Layer - Technology: Node.js with Express/NestJS - Responsibilities: Request routing, validation, auth - Scaling: Horizontal via load balancer ### Data Layer - Primary: PostgreSQL (transactions, relationships) - Cache: Redis (sessions, hot data) - Storage: S3 (files, images) ### External Services - Auth: Auth0 (SSO, MFA) - Email: SendGrid (transactional) - Monitoring: Datadog (APM, logs)每个组件统一用三个维度描述Technology技术选型、Responsibilities职责边界、Scaling扩展方式。职责边界的描述尤其重要它是后续划定服务边界、进行微服务拆分的依据Scaling 一栏则与第五节扩展策略直接呼应。数据层按数据用途做三重分离关系数据 / 缓存 / 文件对象存储这是大多数 Web 系统的标准分层选型理由可参考 database-selection.md 的决策矩阵ACID 事务选关系型、亚毫秒读选 Redis、文件存储选对象存储。4. 关键决策Key Decisions模板用决策表的形式呈现决定 理由| Decision | Rationale | |----------|-----------| | PostgreSQL over MongoDB | Relational data, ACID needed | | Redis for caching | Sub-ms latency required | | Auth0 over custom | Reduce security risk |这张表是文档中最容易被评审者追问的部分因此每一项决策都应当能展开成一份完整的 ADR。SKILL.md 的 MUST DO 约束明确要求用 ADR 记录所有重大决策、评估权衡而非只看收益adr-template.md 提供了标准 ADR 结构Status / Context / Decision / Consequences / Alternatives Considered / References并给出了一个完整的为订单存储选择 PostgreSQL示例其中 Alternatives Considered 部分对比了 MongoDB 与 DynamoDB 的取舍、Consequences 区分了 Positive / Negative / Neutral。决策表可以理解为ADR 的索引而 ADR 文件是决策的完整档案。5. 扩展策略Scaling Strategy模板区分当前MVP与未来10 倍增长两个时间点### Current (MVP) - Single region deployment - 2 API instances behind ALB - Single RDS instance ### Future (10x growth) - Multi-region with CDN - Auto-scaling API (2-10 instances) - RDS read replicas这个设计理念与 SKILL.md 的 MUST NOT DO 约束不要为假想的规模过度设计一脉相承MVP 阶段用最小可用的部署形态单区域、双实例、单库只有在明确 10 倍增长路径时才引入 CDN、自动伸缩、读写分离。写作时建议为每一条未来策略标注触发条件例如当 p95 延迟超过 300ms 时启用读副本让扩展策略可执行、可度量。6. 安全考量Security Considerations模板给出了四个基线条目- All traffic over TLS 1.3 - JWT tokens with 15-min expiry - Rate limiting: 100 req/min per user - WAF for common attacks这些条目与 nfr-checklist.md 的安全维度一脉相承认证方式JWT/OAuth/MFA、数据敏感度public/internal/confidential/PII、合规要求GDPR/HIPAA/PCI DSS/SOC 2、加密需求传输中/静态/端到端。建议在模板基础上补充凭证存放位置密钥轮换策略日志脱敏等条目并说明每项安全措施的适用边界。7. 故障模式Failure Modes模板用故障—影响—缓解三列矩阵覆盖核心依赖故障| Failure | Impact | Mitigation | |---------|--------|------------| | DB down | Full outage | Multi-AZ failover | | Cache down | Degraded perf | Fallback to DB | | Auth down | No new logins | Cache valid tokens |这一节直接对应 SKILL.md 的 MUST DO 约束为故障模式做预案。写作时建议从依赖图中逐条枚举关键依赖数据库、缓存、认证、消息队列、外部 API判断每个依赖故障的影响面并给出一条可落地的缓解动作。注意缓解措施要避免以缓存代数据库这类会让数据一致性问题升级的方案需要结合数据的 RPO/RTO 要求权衡参见 nfr-checklist.md 的可靠性维度。8. 快速参考Quick Reference| Section | Key Questions | |---------|---------------| | Requirements | What must it do? How well? | | Architecture | What components? How connected? | | Decisions | Why these choices? | | Scaling | How to grow? | | Failures | What can break? How to recover? |【免费下载链接】claude-skills67 Specialized Skills for Full-Stack Developers. Transform Claude Code into your expert pair programmer.项目地址: https://gitcode.com/GitHub_Trending/claud/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考