@mison/ag-kit-cn 2.0.1

package/.agent/skills/seo-fundamentals/scripts/seo_checker.py

@@ -0,0 +1,215 @@
+#!/usr/bin/env python3
+"""
+SEO Checker - Search Engine Optimization Audit
+Checks HTML/JSX/TSX pages for SEO best practices.
+
+PURPOSE:
+    - Verify meta tags, titles, descriptions
+    - Check Open Graph tags for social sharing
+    - Validate heading hierarchy
+    - Check image accessibility (alt attributes)
+
+WHAT IT CHECKS:
+    - HTML files (actual web pages)
+    - JSX/TSX files (React page components)
+    - Only files that are likely PUBLIC pages
+
+Usage:
+    python seo_checker.py <project_path>
+"""
+import sys
+import json
+import re
+from pathlib import Path
+from datetime import datetime
+
+# Fix Windows console encoding
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except:
+    pass
+
+
+# Directories to skip
+SKIP_DIRS = {
+    'node_modules', '.next', 'dist', 'build', '.git', '.github',
+    '__pycache__', '.vscode', '.idea', 'coverage', 'test', 'tests',
+    '__tests__', 'spec', 'docs', 'documentation', 'examples', 'reference'
+}
+
+# Files to skip (not pages)
+SKIP_PATTERNS = [
+    'config', 'setup', 'util', 'helper', 'hook', 'context', 'store',
+    'service', 'api', 'lib', 'constant', 'type', 'interface', 'mock',
+    '.test.', '.spec.', '_test.', '_spec.'
+]
+
+
+def is_page_file(file_path: Path) -> bool:
+    """Check if this file is likely a public-facing page."""
+    name = file_path.name.lower()
+    stem = file_path.stem.lower()
+    
+    # Skip utility/config files
+    if any(skip in name for skip in SKIP_PATTERNS):
+        return False
+    
+    # Skip files in common component/UI directories
+    parts = [p.lower() for p in file_path.parts]
+    if any(d in parts for d in ['components', 'ui', 'fragments', 'elements', 'header', 'footer']):
+        return False
+    
+    # Check path - pages in specific directories are likely pages
+    page_dirs = ['pages', 'app', 'routes', 'views', 'screens']
+    
+    if any(d in parts for d in page_dirs):
+        # Even in app dir, skip layout/template/loading/error for main SEO check
+        # but keep them for global meta tags
+        if stem in ['page', 'layout', 'index']:
+            return True
+    
+    return False
+
+
+def find_pages(project_path: Path) -> list:
+    """Find page files to check."""
+    patterns = ['**/*.html', '**/*.htm', '**/*.jsx', '**/*.tsx']
+    
+    files = []
+    for pattern in patterns:
+        for f in project_path.glob(pattern):
+            # Skip excluded directories
+            if any(skip in f.parts for skip in SKIP_DIRS):
+                continue
+            
+            # Check if it's likely a page
+            if is_page_file(f):
+                files.append(f)
+    
+    return files[:50]  # Limit to 50 files
+
+
+def check_page(file_path: Path) -> dict:
+    """Check a single page for SEO issues."""
+    issues = []
+    
+    try:
+        content = file_path.read_text(encoding='utf-8', errors='ignore')
+    except Exception as e:
+        return {"file": str(file_path.name), "issues": [f"Error: {e}"]}
+    
+    # Detect if this is a layout/template file (has Head component or metadata export)
+    is_layout = 'Head>' in content or '<head' in content.lower() or 'export const metadata' in content
+    
+    # 1. Title tag
+    has_title = '<title' in content.lower() or 'title:' in content or 'Head>' in content or 'metadata' in content
+    if not has_title and is_layout:
+        issues.append("Missing <title> tag")
+    
+    # 2. Meta description
+    has_description = 'description' in content.lower() or 'name="description"' in content.lower()
+    if not has_description and is_layout:
+        issues.append("Missing meta description")
+    
+    # 3. Open Graph tags
+    has_og = 'og:' in content or 'property="og:' in content.lower() or 'openGraph' in content
+    if not has_og and is_layout:
+        issues.append("Missing Open Graph tags")
+    
+    # 4. Heading hierarchy - multiple H1s
+    h1_matches = re.findall(r'<h1[^>]*>', content, re.I)
+    if len(h1_matches) > 1:
+        issues.append(f"Multiple H1 tags ({len(h1_matches)})")
+    
+    # 5. Images without alt
+    img_pattern = r'<img[^>]+>'
+    imgs = re.findall(img_pattern, content, re.I)
+    for img in imgs:
+        if 'alt=' not in img.lower():
+            issues.append("Image missing alt attribute")
+            break
+        if 'alt=""' in img or "alt=''" in img:
+            issues.append("Image has empty alt attribute")
+            break
+    
+    # 6. Check for canonical link (nice to have)
+    # has_canonical = 'rel="canonical"' in content.lower()
+    
+    return {
+        "file": str(file_path.name),
+        "issues": issues
+    }
+
+
+def main():
+    project_path = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
+    
+    print(f"\n{'='*60}")
+    print(f"  SEO CHECKER - Search Engine Optimization Audit")
+    print(f"{'='*60}")
+    print(f"Project: {project_path}")
+    print(f"Time: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    print("-"*60)
+    
+    # Find pages
+    pages = find_pages(project_path)
+    
+    if not pages:
+        print("\n[!] No page files found.")
+        print("    Looking for: HTML, JSX, TSX in pages/app/routes directories")
+        output = {"script": "seo_checker", "files_checked": 0, "passed": True}
+        print("\n" + json.dumps(output, indent=2))
+        sys.exit(0)
+    
+    print(f"Found {len(pages)} page files to analyze\n")
+    
+    # Check each page
+    all_issues = []
+    for f in pages:
+        result = check_page(f)
+        if result["issues"]:
+            all_issues.append(result)
+    
+    # Summary
+    print("=" * 60)
+    print("SEO ANALYSIS RESULTS")
+    print("=" * 60)
+    
+    if all_issues:
+        # Group by issue type
+        issue_counts = {}
+        for item in all_issues:
+            for issue in item["issues"]:
+                issue_counts[issue] = issue_counts.get(issue, 0) + 1
+        
+        print("\nIssue Summary:")
+        for issue, count in sorted(issue_counts.items(), key=lambda x: -x[1]):
+            print(f"  [{count}] {issue}")
+        
+        print(f"\nAffected files ({len(all_issues)}):")
+        for item in all_issues[:5]:
+            print(f"  - {item['file']}")
+        if len(all_issues) > 5:
+            print(f"  ... and {len(all_issues) - 5} more")
+    else:
+        print("\n[OK] No SEO issues found!")
+    
+    total_issues = sum(len(item["issues"]) for item in all_issues)
+    passed = total_issues == 0
+    
+    output = {
+        "script": "seo_checker",
+        "project": str(project_path),
+        "files_checked": len(pages),
+        "files_with_issues": len(all_issues),
+        "issues_found": total_issues,
+        "passed": passed
+    }
+    
+    print("\n" + json.dumps(output, indent=2))
+    
+    sys.exit(0 if passed else 1)
+
+
+if __name__ == "__main__":
+    main()

package/.agent/skills/server-management/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: server-management
+description: 服务器管理原则与决策方法。涵盖进程管理、监控策略与扩缩容判断。强调思维方式，而非死记命令。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# 服务器管理
+
+> 面向生产运维的服务器管理原则。  
+> **学习如何思考，不是背命令。**
+
+---
+
+## 1. 进程管理原则
+
+### 工具选型
+
+| 场景 | 工具 |
+|------|------|
+| **Node.js 应用** | PM2（集群 clustering、重载 reload） |
+| **任意应用** | systemd（Linux 原生） |
+| **容器** | Docker/Podman |
+| **编排** | Kubernetes, Docker Swarm |
+
+### 进程管理目标
+
+| 目标 | 含义 |
+|------|------|
+| **崩溃后重启（Restart on crash）** | 自动恢复（Auto-recovery） |
+| **零停机重载（Zero-downtime reload）** | 服务不中断 |
+| **集群（Clustering）** | 用满 CPU 多核 |
+| **持久化（Persistence）** | 服务器重启后仍可恢复 |
+
+---
+
+## 2. 监控原则
+
+### 监控什么
+
+| 类别 | 关键指标 |
+|------|----------|
+| **可用性（Availability）** | 在线率（Uptime）、健康检查 |
+| **性能（Performance）** | 响应时间、吞吐量 |
+| **错误（Errors）** | 错误率、错误类型 |
+| **资源（Resources）** | CPU、内存、磁盘 |
+
+### 告警分级策略
+
+| 级别 | 响应 |
+|------|------|
+| **Critical（严重）** | 立即处理 |
+| **Warning（警告）** | 尽快排查 |
+| **Info（信息）** | 每日审查 |
+
+### 监控工具选择
+
+| 需求 | 可选工具 |
+|------|----------|
+| 简单/免费 | PM2 metrics, htop |
+| 全链路可观测 | Grafana, Datadog |
+| 错误追踪 | Sentry |
+| 在线率监控 | UptimeRobot, Pingdom |
+
+---
+
+## 3. 日志管理原则
+
+### 日志策略
+
+| 日志类型 | 用途 |
+|----------|------|
+| **应用日志（Application logs）** | 调试、审计 |
+| **访问日志（Access logs）** | 流量分析 |
+| **错误日志（Error logs）** | 问题发现 |
+
+### 日志原则
+
+1. 进行 **日志轮转（Rotate logs）**，避免磁盘打满
+2. 使用 **结构化日志（Structured logging）**（如 JSON）便于解析
+3. 合理划分日志级别（error/warn/info/debug）
+4. 日志中不得出现敏感数据
+
+---
+
+## 4. 扩缩容决策
+
+### 何时扩缩容
+
+| 症状 | 应对 |
+|------|------|
+| CPU 持续高负载 | 增加实例（水平扩展 horizontal） |
+| 内存持续高占用 | 增加 RAM 或修复内存泄漏 |
+| 响应变慢 | 先做性能分析（Profile）再扩容 |
+| 流量突增 | 自动扩缩容（Auto-scaling） |
+
+### 扩缩容策略
+
+| 类型 | 适用场景 |
+|------|----------|
+| **垂直扩展（Vertical）** | 快速止血、单实例场景 |
+| **水平扩展（Horizontal）** | 长期可持续、分布式场景 |
+| **自动扩缩容（Auto）** | 流量波动明显 |
+
+---
+
+## 5. 健康检查原则
+
+### 健康状态判定
+
+| 检查项 | 含义 |
+|--------|------|
+| **HTTP 200** | 服务可响应 |
+| **数据库已连接** | 数据可访问 |
+| **依赖可用** | 外部服务可达 |
+| **资源正常** | CPU/内存未耗尽 |
+
+### 健康检查实现方式
+
+- 简单模式：仅返回 200
+- 深度模式：检查所有关键依赖
+- 按负载均衡器（Load Balancer）的接入需求选择
+
+---
+
+## 6. 安全原则
+
+| 领域 | 原则 |
+|------|------|
+| **访问控制（Access）** | 仅用 SSH key，禁用口令登录 |
+| **防火墙（Firewall）** | 只开放必要端口 |
+| **更新（Updates）** | 定期打安全补丁 |
+| **密钥管理（Secrets）** | 放环境变量，不落地文件 |
+| **审计（Audit）** | 记录访问与变更 |
+
+---
+
+## 7. 故障排查优先级
+
+当系统异常时按顺序排查：
+
+1. **先看是否在运行**（进程状态）
+2. **再看日志**（错误信息）
+3. **检查资源**（磁盘、内存、CPU）
+4. **检查网络**（端口、DNS）
+5. **检查依赖**（数据库、外部 API）
+
+---
+
+## 8. 反模式
+
+| ❌ 不要这样做 | ✅ 推荐做法 |
+|--------------|-----------|
+| 以 root 身份直接运行服务 | 使用非 root 账号运行 |
+| 忽略日志管理 | 配置日志轮转 |
+| 不做监控 | 从第一天就接入监控 |
+| 手工重启服务 | 配置自动重启 |
+| 没有备份策略 | 制定并执行定期备份 |
+
+---
+
+> **牢记：** 管得好的服务器应当“平平无奇”。这正是目标。

package/.agent/skills/systematic-debugging/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: systematic-debugging
+description: 4 阶段系统化调试方法，包含根因分析与基于证据的验证。用于调试复杂问题。
+allowed-tools: Read, Glob, Grep
+---
+
+# 系统化调试
+
+> 来源：obra/superpowers
+
+## 概览
+
+本技能提供结构化的调试方法，避免随机猜测，确保在修复前已充分理解问题。
+
+## 4 阶段调试流程
+
+### 阶段 1：复现
+
+修复前，必须稳定复现问题。
+
+```markdown
+## 复现步骤
+1. [精确复现步骤]
+2. [下一步]
+3. [预期结果 vs 实际结果]
+
+## 复现率
+- [ ] 必现 (100%)
+- [ ] 经常 (50-90%)
+- [ ] 偶发 (10-50%)
+- [ ] 罕见 (<10%)
+```
+
+### 阶段 2：隔离
+
+缩小问题来源范围。
+
+```markdown
+## 隔离问题提问
+- 问题从什么时候开始出现？
+- 最近改了什么？
+- 所有环境都会出现吗？
+- 能否用最小代码复现？
+- 触发问题的最小改动是什么？
+```
+
+### 阶段 3：理解
+
+找到根因，而不只停留在症状层。
+
+```markdown
+## 根因分析
+### 5 个为什么
+1. 为什么：[第一层观测]
+2. 为什么：[更深层原因]
+3. 为什么：[继续深入]
+4. 为什么：[接近根因]
+5. 为什么：[锁定根因]
+```
+
+### 阶段 4：修复与验证
+
+修复后，验证问题已真正解决。
+
+```markdown
+## 修复验证
+- [ ] Bug 不再复现
+- [ ] 关联功能仍然正常
+- [ ] 未引入新问题
+- [ ] 已添加防回归测试
+```
+
+## 调试检查清单
+
+```markdown
+## 开始前
+- [ ] 能稳定复现
+- [ ] 有最小复现用例
+- [ ] 明确预期行为
+
+## 调查中
+- [ ] 检查最近改动 (git log)
+- [ ] 检查日志报错
+- [ ] 必要时增加日志
+- [ ] 使用调试器/断点
+
+## 修复后
+- [ ] 已记录根因
+- [ ] 已验证修复
+- [ ] 已添加回归测试
+- [ ] 已排查相似代码
+```
+
+## 常用调试命令
+
+```bash
+# Recent changes
+git log --oneline -20
+git diff HEAD~5
+
+# Search for pattern
+grep -r "errorPattern" --include="*.ts"
+
+# Check logs
+pm2 logs app-name --err --lines 100
+```
+
+## 反模式
+
+❌ **随机改动** - “也许改这里就好了”
+❌ **忽视证据** - “这不可能是原因”
+❌ **主观断言** - 没有证据就说“肯定是 X”
+❌ **未先复现** - 盲修
+❌ **止步症状** - 没有挖到根因