ethan-skill 1.11.0 → 1.12.0

package/dist/skills/32-green-code.js

@@ -0,0 +1,346 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.greenCodeSkill = void 0;
+exports.greenCodeSkill = {
+    id: 'green-code',
+    name: '绿色编码实践',
+    nameEn: 'green_code',
+    order: 32,
+    description: '识别代码能耗热点，优化算法复杂度与云资源效率，估算并降低软件碳排放',
+    descriptionEn: 'Identify code energy hotspots, optimize algorithm complexity and cloud resource efficiency, estimate and reduce software carbon footprint',
+    detailDescription: `软件系统的碳排放已成为不可忽视的环境责任——全球 IT 行业贡献了约 2-4% 的碳排放。
+本 Skill 提供务实的绿色编码方法：从识别 CPU 密集、无效轮询、内存泄漏等能耗热点，
+到算法复杂度优化和云资源 Right-sizing，再到前端绿色实践和碳排放量化，
+让工程师在不牺牲性能的前提下写出更节能的代码。`,
+    triggers: [
+        '绿色编码',
+        'green code',
+        'green software',
+        'carbon footprint',
+        '能耗优化',
+        'sustainable code',
+        '碳排放',
+        '节能',
+        '@ethan green-code',
+        '/green-code',
+    ],
+    steps: [
+        {
+            title: '1. 能耗热点识别',
+            content: `扫描代码库，定位高能耗模式：
+
+**六大能耗反模式**
+
+| 反模式 | 表现 | 能耗级别 |
+|--------|------|---------|
+| **无效轮询** | \`while(true) { check(); sleep(100) }\` | 🔴 极高 |
+| **CPU 密集循环** | 嵌套循环处理大数据集 | 🔴 极高 |
+| **内存泄漏** | 对象无法被 GC 回收 | 🟠 高 |
+| **冗余网络请求** | 重复请求相同资源 | 🟠 高 |
+| **过度序列化** | 频繁 JSON.stringify 大对象 | 🟡 中 |
+| **阻塞 I/O** | 同步文件读写阻塞主线程 | 🟡 中 |
+
+**识别工具命令**
+\`\`\`bash
+# Node.js — CPU Profile
+node --prof app.js
+node --prof-process isolate-*.log > profile.txt
+
+# 内存快照（Node.js）
+node --heap-prof app.js
+
+# 前端 — Chrome DevTools
+# Performance 面板 → Record → 分析 Long Tasks（>50ms）
+
+# Python — cProfile
+python -m cProfile -o output.prof app.py
+python -m pstats output.prof  # 查看热点函数
+\`\`\`
+
+**无效轮询重构**
+\`\`\`typescript
+// ❌ 能耗高：每 100ms 轮询
+while (true) {
+  const status = await checkJobStatus(jobId);
+  if (status === 'done') break;
+  await sleep(100);
+}
+
+// ✅ 绿色：指数退避 + 最大间隔
+async function pollWithBackoff(jobId: string) {
+  let delay = 500;
+  const MAX_DELAY = 30000;
+  while (true) {
+    const status = await checkJobStatus(jobId);
+    if (status === 'done') return;
+    await sleep(Math.min(delay, MAX_DELAY));
+    delay *= 1.5;
+  }
+}
+
+// ✅ 更绿色：WebSocket / SSE（服务端推送，零轮询）
+const ws = new WebSocket('/api/jobs/status');
+ws.onmessage = (e) => handleUpdate(JSON.parse(e.data));
+\`\`\`
+
+**输出**：能耗热点清单（位置 + 类型 + 估算影响）`,
+        },
+        {
+            title: '2. 算法复杂度优化',
+            content: `用低复杂度算法替换高能耗实现：
+
+**复杂度对碳排放的影响（1M 数据量对比）**
+\`\`\`
+O(n²)  → 10^12 操作 → 约 100W CPU 秒  🔴
+O(n log n) → 2×10^7 操作 → 约 20ms     🟢
+O(n)   → 10^6 操作  → 约 1ms          🟢
+O(1)   → 1 操作     → 即时            🟢
+\`\`\`
+
+**常见优化模式**
+
+**① 嵌套循环 → 哈希查找**
+\`\`\`typescript
+// ❌ O(n²) — 大数据量极度消耗 CPU
+function findMatches(users: User[], orders: Order[]) {
+  return orders.filter(order =>
+    users.some(user => user.id === order.userId) // O(n) per order
+  );
+}
+
+// ✅ O(n) — 预建索引
+function findMatchesOptimized(users: User[], orders: Order[]) {
+  const userMap = new Map(users.map(u => [u.id, u]));  // 一次性 O(n)
+  return orders.filter(order => userMap.has(order.userId)); // O(1) per order
+}
+\`\`\`
+
+**② 重复计算 → 缓存/记忆化**
+\`\`\`typescript
+// ❌ 每次调用重新计算
+function expensiveCalc(n: number) { /* O(2^n) */ }
+
+// ✅ 记忆化缓存
+const memo = new Map<number, number>();
+function cachedCalc(n: number): number {
+  if (memo.has(n)) return memo.get(n)!;
+  const result = expensiveCalc(n);
+  memo.set(n, result);
+  return result;
+}
+\`\`\`
+
+**③ 大列表操作 → 流式处理**
+\`\`\`typescript
+// ❌ 全量加载到内存
+const allRecords = await db.findAll(); // 可能 100MB
+processAll(allRecords);
+
+// ✅ 流式分批处理
+const BATCH = 1000;
+for await (const batch of db.findInBatches(BATCH)) {
+  await processBatch(batch);
+}
+\`\`\`
+
+**输出**：算法优化建议 + 重构前后复杂度对比`,
+        },
+        {
+            title: '3. 云资源效率优化',
+            content: `减少云资源浪费，降低运行能耗：
+
+**云资源三大浪费来源**
+\`\`\`
+1. Over-provisioning（过度配置）：实际 CPU 利用率 < 20%，却购买了大型实例
+2. 僵尸资源：停止的 EC2、未挂载的 EBS 卷、空闲的 NAT 网关
+3. 低效架构：长时间运行的大实例 vs. Serverless 按需执行
+\`\`\`
+
+**Right-sizing 实践**
+\`\`\`bash
+# AWS — 查看 CPU 利用率趋势（CloudWatch）
+aws cloudwatch get-metric-statistics \
+  --metric-name CPUUtilization \
+  --dimensions Name=InstanceId,Value=i-xxxx \
+  --start-time 2024-01-01T00:00:00 \
+  --end-time 2024-01-31T00:00:00 \
+  --period 86400 --statistics Average
+
+# 建议：平均 CPU < 20% → 降低一档实例类型
+# m5.xlarge (4 vCPU) → m5.large (2 vCPU) = 节省 50% 成本和能耗
+\`\`\`
+
+**自动伸缩配置（节能关键）**
+\`\`\`yaml
+# Kubernetes HPA — 按 CPU 自动伸缩
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: api-server
+spec:
+  minReplicas: 1   # 低峰期缩减到 1 个副本
+  maxReplicas: 10
+  metrics:
+  - type: Resource
+    resource:
+      name: cpu
+      target:
+        type: Utilization
+        averageUtilization: 60
+\`\`\`
+
+**Serverless 适用场景**
+\`\`\`
+适合 Serverless（事件驱动，闲时零消耗）：
+✅ 图片处理、文件转换
+✅ 定时任务、数据同步
+✅ Webhook 处理器
+
+不适合 Serverless（冷启动延迟不可接受）：
+❌ 实时游戏服务器
+❌ 高频低延迟 API（< 100ms SLA）
+\`\`\`
+
+**输出**：云资源优化建议（Right-sizing + 自动伸缩 + 架构选型）`,
+        },
+        {
+            title: '4. 前端绿色实践',
+            content: `减少前端资源消耗，降低设备端能耗：
+
+**前端能耗五大优化**
+
+**① JavaScript Bundle 瘦身**
+\`\`\`bash
+# 分析 Bundle 大小
+npx webpack-bundle-analyzer stats.json
+npx vite-bundle-visualizer
+
+# 目标：首屏 JS < 150KB (gzipped)
+\`\`\`
+
+\`\`\`typescript
+// ✅ Tree-shaking（只导入用到的函数）
+import { debounce } from 'lodash-es';  // 不要 import _ from 'lodash'
+
+// ✅ 动态导入（按需加载非关键模块）
+const HeavyChart = lazy(() => import('./HeavyChart'));
+
+// ✅ 外部化大型库（CDN 缓存复用）
+// vite.config.ts
+build: { rollupOptions: { external: ['react', 'react-dom'] } }
+\`\`\`
+
+**② 图片优化**
+\`\`\`html
+<!-- ✅ 现代格式 + 响应式 -->
+<picture>
+  <source srcset="hero.avif" type="image/avif">
+  <source srcset="hero.webp" type="image/webp">
+  <img src="hero.jpg" width="800" height="600"
+       loading="lazy" decoding="async" alt="...">
+</picture>
+<!-- WebP 比 JPEG 小 30%，AVIF 比 JPEG 小 50% -->
+\`\`\`
+
+**③ CSS 精简**
+\`\`\`bash
+# PurgeCSS — 移除未使用的 CSS
+npx purgecss --css dist/*.css --content dist/*.html dist/*.js --output dist/
+\`\`\`
+
+**④ 减少不必要的动画**
+\`\`\`css
+/* 尊重用户的省电模式偏好 */
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after {
+    animation-duration: 0.01ms !important;
+    transition-duration: 0.01ms !important;
+  }
+}
+\`\`\`
+
+**⑤ 高效 DOM 操作**
+\`\`\`typescript
+// ❌ 频繁触发 Reflow
+items.forEach(item => {
+  item.style.width = container.offsetWidth + 'px'; // 每次读写触发 Reflow
+});
+
+// ✅ 批量读后批量写
+const width = container.offsetWidth; // 一次读取
+items.forEach(item => { item.style.width = width + 'px'; }); // 批量写
+\`\`\`
+
+**输出**：前端绿色实践清单 + Bundle 分析建议`,
+        },
+        {
+            title: '5. 碳排放估算',
+            content: `用 SCI（Software Carbon Intensity）公式量化软件碳排放：
+
+**SCI 公式**
+\`\`\`
+SCI = (E × I) + M
+
+E = 软件消耗的电能（kWh）
+I = 电网碳强度（gCO₂eq/kWh）— 取决于服务器所在地区
+M = 硬件制造碳排放（均摊到使用寿命）
+\`\`\`
+
+**各地区电网碳强度参考**
+\`\`\`
+地区          碳强度 (gCO₂eq/kWh)
+─────────────────────────────────
+西欧 / Nordic   ~150-300  （可再生能源占比高）
+us-east-1       ~350-400
+ap-northeast-1  ~450-500  （日本，主要火电）
+cn-north-1      ~550-600  （中国，煤电为主）
+AWS GovCloud    ~200      （承诺使用清洁能源）
+\`\`\`
+
+**API 服务碳排放估算示例**
+\`\`\`
+假设：
+- API 服务器：4 vCPU，平均 40% 利用率
+- TDP（热设计功耗）：100W（4 vCPU 服务器）
+- 实际功耗：100W × 40% × PUE(1.2) = 48W
+- 每月运行：48W × 730h = 35 kWh
+- 碳排放（us-east-1，380 gCO₂/kWh）：
+  35 × 380 = 13,300 gCO₂ = 13.3 kg CO₂/月
+
+优化后（CPU 利用率从 40% 优化到 20% 后缩容）：
+  12W × 730h × 380 / 1000 = 3.3 kg CO₂/月
+  节省：10 kg CO₂/月（减少 75%）
+\`\`\`
+
+**绿色目标设定**
+\`\`\`
+当前基准: ___ gCO₂/1000 API 请求
+目标（3个月）: 降低 30%
+目标（1年）: 迁移到低碳区域（or 可再生能源数据中心）
+\`\`\`
+
+**Carbon.txt 声明**（向用户公示绿色承诺）
+\`\`\`
+# /carbon.txt
+We are committed to reducing our software's carbon footprint.
+Hosting: AWS us-west-2 (powered by renewable energy)
+Current SCI: 15g CO₂eq per 1000 requests
+Target: < 10g CO₂eq per 1000 requests by 2025
+\`\`\`
+
+**输出**：碳排放基准报告 + SCI 计算表 + 减碳路线图`,
+        },
+    ],
+    outputFormat: '能耗热点报告 + 算法优化建议 + 云资源 Right-sizing 方案 + 前端绿色实践 Checklist + 碳排放估算（SCI）',
+    examples: [],
+    notes: [
+        '绿色编码和性能优化高度重合——节能的代码往往也是更快的代码，两者并不冲突',
+        '将服务器迁移到使用可再生能源的区域（如 AWS us-west-2 Oregon）是降低碳排放最立竿见影的方式',
+        '前端优化对碳排放影响巨大：每减少 1KB JS，每百万用户每年可节省约 0.5 kg CO₂',
+        'SCI 指标建议纳入团队 KPI，每季度度量，与其他工程指标（性能/可用性）并列追踪',
+        '使用 AWS Customer Carbon Footprint Tool 或 Google Cloud Carbon Footprint 获取真实数据',
+    ],
+    category: '质量侧',
+    nextSkill: 'performance',
+};
+//# sourceMappingURL=32-green-code.js.map

package/dist/skills/32-green-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"32-green-code.js","sourceRoot":"","sources":["../../src/skills/32-green-code.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAoB;IAC7C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,mCAAmC;IAChD,aAAa,EAAE,2IAA2I;IAC1J,iBAAiB,EAAE;;;wBAGG;IACtB,QAAQ,EAAE;QACR,MAAM;QACN,YAAY;QACZ,gBAAgB;QAChB,kBAAkB;QAClB,MAAM;QACN,kBAAkB;QAClB,KAAK;QACL,IAAI;QACJ,mBAAmB;QACnB,aAAa;KACd;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAwDe;SACzB;QACD;YACE,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAwDW;SACrB;QACD;YACE,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CAsD4B;SACtC;QACD;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAkEe;SACzB;QACD;YACE,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAqDkB;SAC5B;KACF;IACD,YAAY,EAAE,uEAAuE;IACrF,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,sCAAsC;QACtC,yDAAyD;QACzD,gDAAgD;QAChD,4CAA4C;QAC5C,8EAA8E;KAC/E;IACD,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,aAAa;CACzB,CAAC"}

package/dist/skills/33-service-catalog.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const serviceCatalogSkill: SkillDefinition;
+//# sourceMappingURL=33-service-catalog.d.ts.map

package/dist/skills/33-service-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"33-service-catalog.d.ts","sourceRoot":"","sources":["../../src/skills/33-service-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,mBAAmB,EAAE,eAyUjC,CAAC"}

package/dist/skills/33-service-catalog.js

@@ -0,0 +1,334 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serviceCatalogSkill = void 0;
+exports.serviceCatalogSkill = {
+    id: 'service-catalog',
+    name: '服务目录管理',
+    nameEn: 'service_catalog',
+    order: 33,
+    description: '建立标准化服务目录，生成 Backstage 兼容的 catalog-info.yaml，可视化服务依赖与健康评分',
+    descriptionEn: 'Build standardized service catalog, generate Backstage-compatible catalog-info.yaml, visualize service dependencies and health scores',
+    detailDescription: `在微服务架构中，服务蔓延（Service Sprawl）让工程师不知道"谁拥有哪个服务"。
+本 Skill 帮助团队建立标准化的服务目录：采集服务元数据、生成 Backstage/IDP 兼容的 catalog-info.yaml、
+绘制服务依赖关系图、建立服务健康评分体系，
+让每个工程师都能快速找到服务的 Owner、SLA、依赖关系和运行状态。`,
+    triggers: [
+        '服务目录',
+        'service catalog',
+        'service registry',
+        'backstage',
+        '内部开发者平台',
+        'idp',
+        '服务注册',
+        '@ethan service-catalog',
+        '/service-catalog',
+    ],
+    steps: [
+        {
+            title: '1. 服务元数据采集',
+            content: `系统化收集每个服务的关键元数据：
+
+**服务元数据清单**
+
+\`\`\`yaml
+# 必填字段
+name:          服务唯一标识（小写 + 连字符）
+display_name:  人类可读名称
+owner:         团队/个人（GitHub Team 或 email）
+tech_stack:    主要技术栈（Node.js/Go/Java 等）
+type:          服务类型（service/library/website/pipeline）
+
+# 运维信息
+tier:          重要性等级（tier-1/tier-2/tier-3）
+sla:           可用性目标（99.9%/99.95%/99.99%）
+on_call:       值班联系方式（PagerDuty/Slack channel）
+runbook:       运维手册 URL
+
+# 依赖关系
+dependencies:  依赖的其他服务列表
+consumers:     消费本服务的上游列表
+databases:     使用的数据库（类型 + 库名）
+external_apis: 调用的外部 API（如 Stripe/SendGrid）
+
+# 文档与质量
+docs:          文档链接（Confluence/Notion）
+api_spec:      OpenAPI/AsyncAPI 规范文件路径
+test_coverage: 当前测试覆盖率
+deployment_frequency: 发布频率（daily/weekly/monthly）
+\`\`\`
+
+**批量采集脚本**
+\`\`\`bash
+#!/bin/bash
+# 扫描所有服务目录，检查是否有 catalog-info.yaml
+for dir in services/*/; do
+  if [ ! -f "$dir/catalog-info.yaml" ]; then
+    echo "❌ Missing: $dir/catalog-info.yaml"
+  else
+    echo "✅ Found:   $dir/catalog-info.yaml"
+  fi
+done
+\`\`\`
+
+**输出**：服务元数据采集表（所有服务 + 完整度评分）`,
+        },
+        {
+            title: '2. 生成 catalog-info.yaml',
+            content: `生成 Backstage/内部开发者平台兼容的服务定义文件：
+
+**完整 catalog-info.yaml 模板**
+\`\`\`yaml
+# services/order-service/catalog-info.yaml
+apiVersion: backstage.io/v1alpha1
+kind: Component
+metadata:
+  name: order-service
+  title: 订单服务
+  description: 处理订单创建、支付和履约的核心服务
+  tags:
+    - nodejs
+    - postgresql
+    - kafka
+    - tier-1
+  annotations:
+    # GitHub 集成
+    github.com/project-slug: myorg/order-service
+    # 监控集成
+    prometheus.io/alert: 'order-service-alerts'
+    grafana.com/dashboard: 'https://grafana.internal/d/orders'
+    # 文档
+    backstage.io/techdocs-ref: dir:.
+    # PagerDuty
+    pagerduty.com/service-id: P123456
+  links:
+    - url: https://runbook.internal/order-service
+      title: Runbook
+      icon: book
+    - url: https://grafana.internal/d/orders
+      title: Dashboard
+      icon: dashboard
+
+spec:
+  type: service
+  lifecycle: production        # experimental | production | deprecated
+  owner: group:backend-team
+  system: ecommerce-platform
+
+  # 依赖声明
+  dependsOn:
+    - component:user-service
+    - component:inventory-service
+    - resource:orders-postgres
+    - resource:payment-kafka-topic
+
+  # 对外提供的 API
+  providesApis:
+    - order-api-v2
+\`\`\`
+
+**API 定义（关联）**
+\`\`\`yaml
+# order-api.yaml
+apiVersion: backstage.io/v1alpha1
+kind: API
+metadata:
+  name: order-api-v2
+  description: 订单服务 REST API v2
+spec:
+  type: openapi
+  lifecycle: production
+  owner: group:backend-team
+  definition:
+    $text: ./openapi/order-api-v2.yaml
+\`\`\`
+
+**Resource 定义（数据库/队列）**
+\`\`\`yaml
+apiVersion: backstage.io/v1alpha1
+kind: Resource
+metadata:
+  name: orders-postgres
+  description: 订单主数据库（PostgreSQL 14）
+spec:
+  type: database
+  owner: group:dba-team
+  system: ecommerce-platform
+\`\`\`
+
+**输出**：catalog-info.yaml + API 定义文件 + Resource 定义文件`,
+        },
+        {
+            title: '3. 服务依赖关系图',
+            content: `可视化服务间的上下游依赖关系：
+
+**Mermaid 依赖图生成**
+\`\`\`typescript
+// scripts/gen-dependency-graph.ts
+function generateMermaid(services: Service[]): string {
+  const lines = ['graph LR'];
+
+  for (const service of services) {
+    for (const dep of service.dependencies) {
+      lines.push(\`  \${service.name} --> \${dep}\`);
+    }
+  }
+
+  return lines.join('\\n');
+}
+
+// 输出示例：
+// graph LR
+//   order-service --> user-service
+//   order-service --> inventory-service
+//   order-service --> payment-service
+//   api-gateway --> order-service
+//   api-gateway --> user-service
+\`\`\`
+
+**关键依赖分析**
+\`\`\`
+依赖分析报告
+════════════
+
+高扇入服务（被依赖最多，故障影响最广）：
+  user-service        被 8 个服务依赖  ⚠️ 单点风险
+  auth-service        被 12 个服务依赖 🔴 关键路径
+
+高扇出服务（依赖最多，级联失败风险）：
+  order-service       依赖 6 个服务    ⚠️ 需熔断保护
+  report-service      依赖 9 个服务    🔴 脆弱性高
+
+循环依赖检测：
+  ✅ 未发现循环依赖
+
+孤立服务（无依赖/无被依赖）：
+  legacy-batch-job    ⚠️ 是否可下线？
+\`\`\`
+
+**依赖健康度 Checklist**
+- [ ] 高扇入服务（>5个依赖）配备了熔断器（Circuit Breaker）
+- [ ] 高扇出服务对所有依赖设置了超时（Timeout）
+- [ ] 关键路径服务有冗余/多活部署
+- [ ] 无循环依赖
+
+**输出**：服务依赖关系图（Mermaid/DOT）+ 风险分析报告`,
+        },
+        {
+            title: '4. 服务健康评分',
+            content: `建立多维度服务健康评分体系，量化技术质量：
+
+**服务健康评分卡（满分 100）**
+
+\`\`\`
+维度              权重   评分标准
+─────────────────────────────────────────
+📄 文档完整性      20分
+  catalog-info.yaml    5分  （存在且完整）
+  README.md            5分  （含部署、接口说明）
+  API 规范             5分  （OpenAPI/AsyncAPI）
+  Runbook              5分  （含常见故障处理）
+
+🧪 测试质量        25分
+  单元测试覆盖率 >80%  15分
+  集成测试存在         10分
+
+🚀 部署规范        25分
+  CI/CD 流水线完整     10分
+  容器化（Dockerfile） 5分
+  健康检查接口         5分
+  优雅关闭实现         5分
+
+📊 可观测性        20分
+  Metrics 暴露         8分  （/metrics endpoint）
+  结构化日志           7分  （JSON 格式 + trace ID）
+  告警规则配置         5分
+
+🔒 安全合规        10分
+  依赖漏洞扫描通过     5分  （npm audit/Snyk 0 High）
+  密钥未硬编码         5分
+\`\`\`
+
+**评分等级**
+- 🟢 **优秀（90-100）**：可作为黄金路径参考
+- 🟡 **良好（70-89）**：有改进空间，下季度计划
+- 🟠 **待改进（50-69）**：需要专项提升
+- 🔴 **高风险（< 50）**：必须立即改进
+
+**批量评分脚本示例**
+\`\`\`bash
+#!/bin/bash
+# 检查服务健康评分关键项
+check_service() {
+  local dir=$1
+  local score=0
+
+  [ -f "$dir/catalog-info.yaml" ] && score=$((score+5))
+  [ -f "$dir/README.md" ] && score=$((score+5))
+  [ -f "$dir/Dockerfile" ] && score=$((score+5))
+  [ -f "$dir/.github/workflows/ci.yml" ] && score=$((score+10))
+
+  echo "$dir: $score / 25 (快速检查)"
+}
+
+for dir in services/*/; do check_service "$dir"; done
+\`\`\`
+
+**输出**：服务健康评分卡 + 改进优先级清单`,
+        },
+        {
+            title: '5. 服务生命周期管理',
+            content: `建立服务从孵化到下线的标准生命周期流程：
+
+**四阶段生命周期**
+\`\`\`
+孵化（Experimental）→ 成熟（Production）→ 维护（Maintenance）→ 下线（Deprecated）
+\`\`\`
+
+**各阶段定义与要求**
+
+| 阶段 | lifecycle 值 | 要求 | 颜色标记 |
+|------|-------------|------|---------|
+| 孵化 | experimental | 开发中，不可用于生产 | 🟡 |
+| 成熟 | production | 满足健康评分 ≥ 80 | 🟢 |
+| 维护 | maintenance | 仅修复 Bug，不加新功能 | 🟠 |
+| 下线 | deprecated | 已有替代服务，设定截止日 | 🔴 |
+
+**服务下线流程**
+\`\`\`
+Day 0:  更新 lifecycle: deprecated，添加 deprecation notice
+        通知所有已知消费者（来自 catalog 的 consumers 列表）
+
+Day 30: 确认所有消费者已迁移
+        关闭新注册/新依赖
+
+Day 60: 停止接受新请求（返回 410 Gone）
+        保留 Read-only 访问用于历史数据查询
+
+Day 90: 完全下线，数据归档
+        从 catalog 中标记 archived: true
+\`\`\`
+
+**服务晋升 Checklist（Experimental → Production）**
+- [ ] 服务健康评分 ≥ 80
+- [ ] 通过 Load Test（目标 TPS 的 150% 压力）
+- [ ] 完成安全扫描（0 个 High/Critical 漏洞）
+- [ ] Runbook 已编写并通过演练
+- [ ] 监控告警已配置并验证（OnCall 团队确认）
+- [ ] 至少经过 2 周 Canary 发布观察
+
+**输出**：服务生命周期文档 + 下线流程 + 晋升 Checklist`,
+        },
+    ],
+    outputFormat: 'catalog-info.yaml 文件 + 服务依赖关系图（Mermaid）+ 服务健康评分卡 + 生命周期管理规范',
+    examples: [],
+    notes: [
+        '服务目录的价值在于"被发现"——确保 catalog-info.yaml 提交到代码库并与 Backstage/IDP 自动同步',
+        '从高 Tier（Tier-1 核心服务）开始建立目录，而非试图一次性覆盖所有服务',
+        '服务健康评分应作为季度技术评审的固定议题，驱动持续改进',
+        '依赖关系图定期更新至关重要——过时的依赖图比没有图更危险',
+        'Backstage 是目前最成熟的开源 IDP，推荐中大型团队直接采用；小团队可用 catalog-info.yaml 文件 + 简单脚本代替',
+    ],
+    category: '执行侧',
+    nextSkill: 'deployment',
+};
+//# sourceMappingURL=33-service-catalog.js.map

package/dist/skills/33-service-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"33-service-catalog.js","sourceRoot":"","sources":["../../src/skills/33-service-catalog.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAoB;IAClD,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,2DAA2D;IACxE,aAAa,EAAE,uIAAuI;IACtJ,iBAAiB,EAAE;;;qCAGgB;IACnC,QAAQ,EAAE;QACR,MAAM;QACN,iBAAiB;QACjB,kBAAkB;QAClB,WAAW;QACX,SAAS;QACT,KAAK;QACL,MAAM;QACN,wBAAwB;QACxB,kBAAkB;KACnB;IACD,KAAK,EAAE;QACL;YACE,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BA4Ce;SACzB;QACD;YACE,KAAK,EAAE,yBAAyB;YAChC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oDAiFqC;SAC/C;QACD;YACE,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAoDqB;SAC/B;QACD;YACE,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA0DU;SACpB;QACD;YACE,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sCAuCuB;SACjC;KACF;IACD,YAAY,EAAE,6DAA6D;IAC3E,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE;QACL,kEAAkE;QAClE,0CAA0C;QAC1C,6BAA6B;QAC7B,8BAA8B;QAC9B,yEAAyE;KAC1E;IACD,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,YAAY;CACxB,CAAC"}

package/dist/skills/34-mobile-review.d.ts

@@ -0,0 +1,3 @@
+import type { SkillDefinition } from './types';
+export declare const mobileReviewSkill: SkillDefinition;
+//# sourceMappingURL=34-mobile-review.d.ts.map