ccgx-workflow 1.0.0 → 1.0.2

package/templates/skills/domains/architecture/SKILL.md

@@ -1,43 +1,43 @@
----
-name: architecture
-description: 架构设计能力索引（API 设计、安全架构、云原生、数据安全）。
-license: MIT
-user-invocable: false
-disable-model-invocation: false
-context: fork
----
-
-# 🏗 阵法秘典 · 架构设计能力中枢
-
-
-## 能力矩阵
-
-| Skill | 定位 | 核心能力 |
-|-------|------|----------|
-| [api-design](api-design.md) | API 设计 | RESTful、GraphQL、OpenAPI |
-| [security-arch](security-arch.md) | 安全架构 | 零信任、IAM、威胁建模、数据安全、合规审计 |
-| [cloud-native](cloud-native.md) | 云原生 | 容器、K8s、Serverless |
-| [message-queue](message-queue.md) | 消息队列 | Kafka、RabbitMQ、事件驱动 |
-| [caching](caching.md) | 缓存策略 | Redis、CDN、缓存一致性 |
-
-## 架构原则
-
-```yaml
-SOLID:
-  - S: 单一职责
-  - O: 开闭原则
-  - L: 里氏替换
-  - I: 接口隔离
-  - D: 依赖倒置
-
-分布式:
-  - CAP 定理
-  - BASE 理论
-  - 最终一致性
-
-安全:
-  - 纵深防御
-  - 最小权限
-  - 零信任
-```
-
+---
+name: architecture
+description: 架构设计能力索引（API 设计、安全架构、云原生、数据安全）。
+license: MIT
+user-invocable: false
+disable-model-invocation: false
+context: fork
+---
+
+# 🏗 阵法秘典 · 架构设计能力中枢
+
+
+## 能力矩阵
+
+| Skill | 定位 | 核心能力 |
+|-------|------|----------|
+| [api-design](api-design.md) | API 设计 | RESTful、GraphQL、OpenAPI |
+| [security-arch](security-arch.md) | 安全架构 | 零信任、IAM、威胁建模、数据安全、合规审计 |
+| [cloud-native](cloud-native.md) | 云原生 | 容器、K8s、Serverless |
+| [message-queue](message-queue.md) | 消息队列 | Kafka、RabbitMQ、事件驱动 |
+| [caching](caching.md) | 缓存策略 | Redis、CDN、缓存一致性 |
+
+## 架构原则
+
+```yaml
+SOLID:
+  - S: 单一职责
+  - O: 开闭原则
+  - L: 里氏替换
+  - I: 接口隔离
+  - D: 依赖倒置
+
+分布式:
+  - CAP 定理
+  - BASE 理论
+  - 最终一致性
+
+安全:
+  - 纵深防御
+  - 最小权限
+  - 零信任
+```
+

package/templates/skills/domains/architecture/api-design.md

@@ -1,225 +1,225 @@
----
-name: api-design
-description: API 设计。RESTful、GraphQL、OpenAPI、版本管理。当用户提到 API设计、RESTful、GraphQL、OpenAPI、接口设计时使用。
----
-
-# 🏗 阵法秘典 · API 设计
-
-
-## RESTful 设计
-
-### 资源命名
-```yaml
-# 使用名词复数
-GET    /users          # 获取用户列表
-GET    /users/{id}     # 获取单个用户
-POST   /users          # 创建用户
-PUT    /users/{id}     # 更新用户
-PATCH  /users/{id}     # 部分更新
-DELETE /users/{id}     # 删除用户
-
-# 嵌套资源
-GET    /users/{id}/orders
-POST   /users/{id}/orders
-
-# 避免
-GET    /getUsers       # ❌ 动词
-GET    /user           # ❌ 单数
-POST   /createUser     # ❌ 动词
-```
-
-### HTTP 状态码
-```yaml
-2xx 成功:
-  200: OK
-  201: Created
-  204: No Content
-
-4xx 客户端错误:
-  400: Bad Request
-  401: Unauthorized
-  403: Forbidden
-  404: Not Found
-  409: Conflict
-  422: Unprocessable Entity
-
-5xx 服务端错误:
-  500: Internal Server Error
-  502: Bad Gateway
-  503: Service Unavailable
-```
-
-### 响应格式
-```json
-// 成功响应
-{
-  "data": {
-    "id": 1,
-    "name": "Alice"
-  }
-}
-
-// 列表响应
-{
-  "data": [...],
-  "pagination": {
-    "page": 1,
-    "per_page": 20,
-    "total": 100
-  }
-}
-
-// 错误响应
-{
-  "error": {
-    "code": "VALIDATION_ERROR",
-    "message": "Invalid email format",
-    "details": [
-      {"field": "email", "message": "Invalid format"}
-    ]
-  }
-}
-```
-
-## OpenAPI 规范
-
-```yaml
-openapi: 3.0.3
-info:
-  title: User API
-  version: 1.0.0
-
-paths:
-  /users:
-    get:
-      summary: List users
-      parameters:
-        - name: page
-          in: query
-          schema:
-            type: integer
-            default: 1
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: '#/components/schemas/User'
-
-    post:
-      summary: Create user
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/CreateUser'
-      responses:
-        '201':
-          description: Created
-
-components:
-  schemas:
-    User:
-      type: object
-      properties:
-        id:
-          type: integer
-        name:
-          type: string
-        email:
-          type: string
-          format: email
-
-    CreateUser:
-      type: object
-      required:
-        - name
-        - email
-      properties:
-        name:
-          type: string
-        email:
-          type: string
-```
-
-## GraphQL
-
-```graphql
-# Schema
-type User {
-  id: ID!
-  name: String!
-  email: String!
-  posts: [Post!]!
-}
-
-type Post {
-  id: ID!
-  title: String!
-  author: User!
-}
-
-type Query {
-  user(id: ID!): User
-  users(limit: Int, offset: Int): [User!]!
-}
-
-type Mutation {
-  createUser(input: CreateUserInput!): User!
-  updateUser(id: ID!, input: UpdateUserInput!): User!
-}
-
-input CreateUserInput {
-  name: String!
-  email: String!
-}
-
-# Query
-query GetUser($id: ID!) {
-  user(id: $id) {
-    name
-    email
-    posts {
-      title
-    }
-  }
-}
-```
-
-## 版本管理
-
-```yaml
-策略:
-  URL路径: /api/v1/users (推荐)
-  请求头: Accept: application/vnd.api+json;version=1
-  查询参数: /api/users?version=1
-
-原则:
-  - 向后兼容
-  - 废弃通知
-  - 迁移指南
-```
-
-## 安全设计
-
-```yaml
-认证:
-  - API Key
-  - JWT
-  - OAuth 2.0
-
-授权:
-  - RBAC
-  - ABAC
-  - Scope
-
-防护:
-  - 速率限制
-  - 输入验证
-  - HTTPS
-```
-
+---
+name: api-design
+description: API 设计。RESTful、GraphQL、OpenAPI、版本管理。当用户提到 API设计、RESTful、GraphQL、OpenAPI、接口设计时使用。
+---
+
+# 🏗 阵法秘典 · API 设计
+
+
+## RESTful 设计
+
+### 资源命名
+```yaml
+# 使用名词复数
+GET    /users          # 获取用户列表
+GET    /users/{id}     # 获取单个用户
+POST   /users          # 创建用户
+PUT    /users/{id}     # 更新用户
+PATCH  /users/{id}     # 部分更新
+DELETE /users/{id}     # 删除用户
+
+# 嵌套资源
+GET    /users/{id}/orders
+POST   /users/{id}/orders
+
+# 避免
+GET    /getUsers       # ❌ 动词
+GET    /user           # ❌ 单数
+POST   /createUser     # ❌ 动词
+```
+
+### HTTP 状态码
+```yaml
+2xx 成功:
+  200: OK
+  201: Created
+  204: No Content
+
+4xx 客户端错误:
+  400: Bad Request
+  401: Unauthorized
+  403: Forbidden
+  404: Not Found
+  409: Conflict
+  422: Unprocessable Entity
+
+5xx 服务端错误:
+  500: Internal Server Error
+  502: Bad Gateway
+  503: Service Unavailable
+```
+
+### 响应格式
+```json
+// 成功响应
+{
+  "data": {
+    "id": 1,
+    "name": "Alice"
+  }
+}
+
+// 列表响应
+{
+  "data": [...],
+  "pagination": {
+    "page": 1,
+    "per_page": 20,
+    "total": 100
+  }
+}
+
+// 错误响应
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Invalid email format",
+    "details": [
+      {"field": "email", "message": "Invalid format"}
+    ]
+  }
+}
+```
+
+## OpenAPI 规范
+
+```yaml
+openapi: 3.0.3
+info:
+  title: User API
+  version: 1.0.0
+
+paths:
+  /users:
+    get:
+      summary: List users
+      parameters:
+        - name: page
+          in: query
+          schema:
+            type: integer
+            default: 1
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/User'
+
+    post:
+      summary: Create user
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/CreateUser'
+      responses:
+        '201':
+          description: Created
+
+components:
+  schemas:
+    User:
+      type: object
+      properties:
+        id:
+          type: integer
+        name:
+          type: string
+        email:
+          type: string
+          format: email
+
+    CreateUser:
+      type: object
+      required:
+        - name
+        - email
+      properties:
+        name:
+          type: string
+        email:
+          type: string
+```
+
+## GraphQL
+
+```graphql
+# Schema
+type User {
+  id: ID!
+  name: String!
+  email: String!
+  posts: [Post!]!
+}
+
+type Post {
+  id: ID!
+  title: String!
+  author: User!
+}
+
+type Query {
+  user(id: ID!): User
+  users(limit: Int, offset: Int): [User!]!
+}
+
+type Mutation {
+  createUser(input: CreateUserInput!): User!
+  updateUser(id: ID!, input: UpdateUserInput!): User!
+}
+
+input CreateUserInput {
+  name: String!
+  email: String!
+}
+
+# Query
+query GetUser($id: ID!) {
+  user(id: $id) {
+    name
+    email
+    posts {
+      title
+    }
+  }
+}
+```
+
+## 版本管理
+
+```yaml
+策略:
+  URL路径: /api/v1/users (推荐)
+  请求头: Accept: application/vnd.api+json;version=1
+  查询参数: /api/users?version=1
+
+原则:
+  - 向后兼容
+  - 废弃通知
+  - 迁移指南
+```
+
+## 安全设计
+
+```yaml
+认证:
+  - API Key
+  - JWT
+  - OAuth 2.0
+
+授权:
+  - RBAC
+  - ABAC
+  - Scope
+
+防护:
+  - 速率限制
+  - 输入验证
+  - HTTPS
+```
+