@mison/ag-kit-cn 2.0.1

package/.agent/skills/geo-fundamentals/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: geo-fundamentals
+description: 针对 AI 搜索引擎（ChatGPT、Claude、Perplexity）的生成式引擎优化。
+allowed-tools: Read, Glob, Grep
+---
+
+# GEO 基础
+
+> 针对 AI 驱动型搜索引擎的优化。
+
+---
+
+## 1. 什么是 GEO？
+
+**GEO** = Generative Engine Optimization（生成式引擎优化）
+
+| 目标 | 涉及平台 |
+| --- | --- |
+| 在 AI 的回答中被引用 | ChatGPT、Claude、Perplexity、Gemini |
+
+### SEO 与 GEO 对比
+
+| 维度 | SEO | GEO |
+| --- | --- | --- |
+| 目标 | 排名第一 | 被 AI 引用 |
+| 平台 | Google | AI 引擎 |
+| 指标 | 排名、CTR | 引用率 |
+| 核心 | 关键词 | 实体、数据 |
+
+---
+
+## 2. AI 引擎版图
+
+| 引擎 | 引用样式 | 机遇 |
+| --- | --- | --- |
+| **Perplexity** | 编号样式 [1][2] | 引用率最高 |
+| **ChatGPT** | 行内/脚注 | 自定义 GPTs |
+| **Claude** | 上下文关联 | 长文本内容 |
+| **Gemini** | 来源板块 | 与 SEO 有交集 |
+
+---
+
+## 3. RAG 检索因子
+
+AI 引擎如何选择要引用的内容：
+
+| 因子 | 权重（估算） |
+| --- | --- |
+| 语义相关性 | ~40% |
+| 关键词匹配 | ~20% |
+| 权威性信号 | ~15% |
+| 时效性 | ~10% |
+| 来源多样性 | ~15% |
+
+---
+
+## 4. 易被引用的内容类型
+
+| 元素 | 作用原则 |
+| --- | --- |
+| **原创统计数据** | 独特、可引用的数据 |
+| **专家语录** | 权重转移 |
+| **清晰的定义** | 易于被提取 |
+| **分步指南** | 提供可操作价值 |
+| **对比表格** | 结构化信息 |
+| **FAQ 常见问题** | 直接给出答案 |
+
+---
+
+## 5. GEO 内容检查清单
+
+### 内容元素
+
+- [ ] 基于问题的标题
+- [ ] 顶部包含摘要/TL;DR
+- [ ] 带有来源说明的原创数据
+- [ ] 专家语录（姓名、头衔）
+- [ ] FAQ 章节（3-5 个问答）
+- [ ] 清晰的定义
+- [ ] “最后更新”时间戳
+- [ ] 作者附带资质说明
+
+### 技术元素
+
+- [ ] 含日期的 Article schema（结构化数据）
+- [ ] 作者的 Person schema
+- [ ] FAQPage schema
+- [ ] 极速加载（< 2.5s）
+- [ ] 整洁的 HTML 结构
+
+---
+
+## 6. 实体构建
+
+| 动作 | 目的 |
+| --- | --- |
+| Google 知识面板（Knowledge Panel） | 实现实体识别 |
+| 维基百科（如具备知名度） | 建立权威来源 |
+| 全网信息保持一致 | 实体整合 |
+| 行业媒体提及 | 增强权威信号 |
+
+---
+
+## 7. AI 爬虫访问
+
+### 关键 AI User-Agent
+
+| 爬虫 | 对应引擎 |
+| --- | --- |
+| GPTBot | ChatGPT/OpenAI |
+| Claude-Web | Claude |
+| PerplexityBot | Perplexity |
+| Googlebot | Gemini（共享） |
+
+### 访问决策
+
+| 策略 | 适用场景 |
+| --- | --- |
+| 允许所有 | 渴望获得 AI 引用 |
+| 屏蔽 GPTBot | 不希望被用于 OpenAI 训练 |
+| 选择性允许 | 允许部分、屏蔽其他 |
+
+---
+
+## 8. 效果衡量
+
+| 指标 | 追踪方式 |
+| --- | --- |
+| AI 引用量 | 手动监控 |
+| “According to [品牌]” 提及量 | 在 AI 中检索 |
+| 竞品引用量 | 对比占有率 |
+| AI 引流流量 | 使用 UTM 参数 |
+
+---
+
+## 9. 反模式
+
+| ❌ 禁止 | ✅ 推荐 |
+| --- | --- |
+| 发布不带日期的内容 | 添加时间戳 |
+| 模糊的来源引用 | 明确标注来源名称 |
+| 忽略作者信息 | 展示其资质背景 |
+| 内容空洞 | 全面覆盖 |
+
+---
+
+> **记住：** AI 会引用清晰、权威且易于提取的内容。努力成为最好的答案。
+
+---
+
+## 脚本
+
+| 脚本 | 用途 | 执行命令 |
+| --- | --- | --- |
+| `scripts/geo_checker.py` | GEO 审计（AI 引用就绪度） | `python scripts/geo_checker.py <project_path>` |

package/.agent/skills/geo-fundamentals/scripts/geo_checker.py

@@ -0,0 +1,289 @@
+#!/usr/bin/env python3
+"""
+GEO Checker - Generative Engine Optimization Audit
+Checks PUBLIC WEB CONTENT for AI citation readiness.
+
+PURPOSE:
+    - Analyze pages that will be INDEXED by AI engines (ChatGPT, Perplexity, etc.)
+    - Check for structured data, author info, dates, FAQ sections
+    - Help content rank in AI-generated answers
+
+WHAT IT CHECKS:
+    - HTML files (actual web pages)
+    - JSX/TSX files (React page components)
+    - NOT markdown files (those are developer docs, not public content)
+
+Usage:
+    python geo_checker.py <project_path>
+"""
+import sys
+import re
+import json
+from pathlib import Path
+
+# Fix Windows console encoding
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except AttributeError:
+    pass
+
+
+# Directories to skip (not public content)
+SKIP_DIRS = {
+    'node_modules', '.next', 'dist', 'build', '.git', '.github',
+    '__pycache__', '.vscode', '.idea', 'coverage', 'test', 'tests',
+    '__tests__', 'spec', 'docs', 'documentation'
+}
+
+# Files to skip (not public pages)
+SKIP_FILES = {
+    'jest.config', 'webpack.config', 'vite.config', 'tsconfig',
+    'package.json', 'package-lock', 'yarn.lock', '.eslintrc',
+    'tailwind.config', 'postcss.config', 'next.config'
+}
+
+
+def is_page_file(file_path: Path) -> bool:
+    """Check if this file is likely a public-facing page."""
+    name = file_path.stem.lower()
+    
+    # Skip config/utility files
+    if any(skip in name for skip in SKIP_FILES):
+        return False
+    
+    # Skip test files
+    if name.endswith('.test') or name.endswith('.spec'):
+        return False
+    if name.startswith('test_') or name.startswith('spec_'):
+        return False
+    
+    # Likely page indicators
+    page_indicators = ['page', 'index', 'home', 'about', 'contact', 'blog', 
+                       'post', 'article', 'product', 'service', 'landing']
+    
+    # Check if it's in a pages/app directory (Next.js, etc.)
+    parts = [p.lower() for p in file_path.parts]
+    if 'pages' in parts or 'app' in parts or 'routes' in parts:
+        return True
+    
+    # Check filename indicators
+    if any(ind in name for ind in page_indicators):
+        return True
+    
+    # HTML files are usually pages
+    if file_path.suffix.lower() == '.html':
+        return True
+    
+    return False
+
+
+def find_web_pages(project_path: Path) -> list:
+    """Find public-facing web pages only."""
+    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[:30]  # Limit to 30 pages
+
+
+def check_page(file_path: Path) -> dict:
+    """Check a single web page for GEO elements."""
+    try:
+        content = file_path.read_text(encoding='utf-8', errors='ignore')
+    except Exception as e:
+        return {'file': str(file_path.name), 'passed': [], 'issues': [f"Error: {e}"], 'score': 0}
+    
+    issues = []
+    passed = []
+    
+    # 1. JSON-LD Structured Data (Critical for AI)
+    if 'application/ld+json' in content:
+        passed.append("JSON-LD structured data found")
+        if '"@type"' in content:
+            if 'Article' in content:
+                passed.append("Article schema present")
+            if 'FAQPage' in content:
+                passed.append("FAQ schema present")
+            if 'Organization' in content or 'Person' in content:
+                passed.append("Entity schema present")
+    else:
+        issues.append("No JSON-LD structured data (AI engines prefer structured content)")
+    
+    # 2. Heading Structure
+    h1_count = len(re.findall(r'<h1[^>]*>', content, re.I))
+    h2_count = len(re.findall(r'<h2[^>]*>', content, re.I))
+    
+    if h1_count == 1:
+        passed.append("Single H1 heading (clear topic)")
+    elif h1_count == 0:
+        issues.append("No H1 heading - page topic unclear")
+    else:
+        issues.append(f"Multiple H1 headings ({h1_count}) - confusing for AI")
+    
+    if h2_count >= 2:
+        passed.append(f"{h2_count} H2 subheadings (good structure)")
+    else:
+        issues.append("Add more H2 subheadings for scannable content")
+    
+    # 3. Author Attribution (E-E-A-T signal)
+    author_patterns = ['author', 'byline', 'written-by', 'contributor', 'rel="author"']
+    has_author = any(p in content.lower() for p in author_patterns)
+    if has_author:
+        passed.append("Author attribution found")
+    else:
+        issues.append("No author info (AI prefers attributed content)")
+    
+    # 4. Publication Date (Freshness signal)
+    date_patterns = ['datePublished', 'dateModified', 'datetime=', 'pubdate', 'article:published']
+    has_date = any(re.search(p, content, re.I) for p in date_patterns)
+    if has_date:
+        passed.append("Publication date found")
+    else:
+        issues.append("No publication date (freshness matters for AI)")
+    
+    # 5. FAQ Section (Highly citable)
+    faq_patterns = [r'<details', r'faq', r'frequently.?asked', r'"FAQPage"']
+    has_faq = any(re.search(p, content, re.I) for p in faq_patterns)
+    if has_faq:
+        passed.append("FAQ section detected (highly citable)")
+    
+    # 6. Lists (Structured content)
+    list_count = len(re.findall(r'<(ul|ol)[^>]*>', content, re.I))
+    if list_count >= 2:
+        passed.append(f"{list_count} lists (structured content)")
+    
+    # 7. Tables (Comparison data)
+    table_count = len(re.findall(r'<table[^>]*>', content, re.I))
+    if table_count >= 1:
+        passed.append(f"{table_count} table(s) (comparison data)")
+    
+    # 8. Entity Recognition (E-E-A-T signal) - NEW 2025
+    entity_patterns = [
+        r'"@type"\s*:\s*"Organization"',
+        r'"@type"\s*:\s*"LocalBusiness"', 
+        r'"@type"\s*:\s*"Brand"',
+        r'itemtype.*schema\.org/(Organization|Person|Brand)',
+        r'rel="author"'
+    ]
+    has_entity = any(re.search(p, content, re.I) for p in entity_patterns)
+    if has_entity:
+        passed.append("Entity/Brand recognition (E-E-A-T)")
+    
+    # 9. Original Statistics/Data (AI citation magnet) - NEW 2025
+    stat_patterns = [
+        r'\d+%',                    # Percentages
+        r'\$[\d,]+',                # Dollar amounts
+        r'study\s+(shows|found)',   # Research citations
+        r'according to',            # Source attribution
+        r'data\s+(shows|reveals)',  # Data-backed claims
+        r'\d+x\s+(faster|better|more)', # Comparison stats
+        r'(million|billion|trillion)', # Large numbers
+    ]
+    stat_matches = sum(1 for p in stat_patterns if re.search(p, content, re.I))
+    if stat_matches >= 2:
+        passed.append("Original statistics/data (citation magnet)")
+    
+    # 10. Conversational/Direct answers - NEW 2025
+    direct_answer_patterns = [
+        r'is defined as',
+        r'refers to',
+        r'means that',
+        r'the answer is',
+        r'in short,',
+        r'simply put,',
+        r'<dfn'
+    ]
+    has_direct = any(re.search(p, content, re.I) for p in direct_answer_patterns)
+    if has_direct:
+        passed.append("Direct answer patterns (LLM-friendly)")
+    
+    # Calculate score
+    total = len(passed) + len(issues)
+    score = (len(passed) / total * 100) if total > 0 else 0
+    
+    return {
+        'file': str(file_path.name),
+        'passed': passed,
+        'issues': issues,
+        'score': round(score)
+    }
+
+
+def main():
+    target = sys.argv[1] if len(sys.argv) > 1 else "."
+    target_path = Path(target).resolve()
+    
+    print("\n" + "=" * 60)
+    print("  GEO CHECKER - AI Citation Readiness Audit")
+    print("=" * 60)
+    print(f"Project: {target_path}")
+    print("-" * 60)
+    
+    # Find web pages only
+    pages = find_web_pages(target_path)
+    
+    if not pages:
+        print("\n[!] No public web pages found.")
+        print("    Looking for: HTML, JSX, TSX files in pages/app directories")
+        print("    Skipping: docs, tests, config files, node_modules")
+        output = {"script": "geo_checker", "pages_found": 0, "passed": True}
+        print("\n" + json.dumps(output, indent=2))
+        sys.exit(0)
+    
+    print(f"Found {len(pages)} public pages to analyze\n")
+    
+    # Check each page
+    results = []
+    for page in pages:
+        result = check_page(page)
+        results.append(result)
+    
+    # Print results
+    for result in results:
+        status = "[OK]" if result['score'] >= 60 else "[!]"
+        print(f"{status} {result['file']}: {result['score']}%")
+        if result['issues'] and result['score'] < 60:
+            for issue in result['issues'][:2]:  # Show max 2 issues
+                print(f"    - {issue}")
+    
+    # Average score
+    avg_score = sum(r['score'] for r in results) / len(results) if results else 0
+    
+    print("\n" + "=" * 60)
+    print(f"AVERAGE GEO SCORE: {avg_score:.0f}%")
+    print("=" * 60)
+    
+    if avg_score >= 80:
+        print("[OK] Excellent - Content well-optimized for AI citations")
+    elif avg_score >= 60:
+        print("[OK] Good - Some improvements recommended")
+    elif avg_score >= 40:
+        print("[!] Needs work - Add structured elements")
+    else:
+        print("[X] Poor - Content needs GEO optimization")
+    
+    # JSON output
+    output = {
+        "script": "geo_checker",
+        "project": str(target_path),
+        "pages_checked": len(results),
+        "average_score": round(avg_score),
+        "passed": avg_score >= 60
+    }
+    print("\n" + json.dumps(output, indent=2))
+    
+    sys.exit(0 if avg_score >= 60 else 1)
+
+
+if __name__ == "__main__":
+    main()

package/.agent/skills/i18n-localization/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: i18n-localization
+description: 国际化与本地化模式。包含硬编码字符串检测、翻译管理、语言文件与 RTL 支持。
+allowed-tools: Read, Glob, Grep
+---
+
+# i18n 与本地化
+
+> 国际化（i18n）与本地化（L10n）最佳实践。
+
+---
+
+## 1. 核心概念
+
+| 术语 | 含义 |
+| --- | --- |
+| **i18n** | Internationalization（国际化）—— 使应用具备可翻译性 |
+| **L10n** | Localization（本地化）—— 实际的翻译实施过程 |
+| **Locale** | 语言 + 地区（例如：en-US, tr-TR） |
+| **RTL** | Right-to-left（从右向左语言，如阿拉伯语、希伯来语） |
+
+---
+
+## 2. 何时使用 i18n
+
+| 项目类型 | 是否需要 i18n？ |
+| --- | --- |
+| 公共 Web 应用 | ✅ 是 |
+| SaaS 产品 | ✅ 是 |
+| 内部工具 | ⚠️ 视情况而定 |
+| 单一地区应用 | ⚠️ 考虑未来扩展 |
+| 个人项目 | ❌ 可选 |
+
+---
+
+## 3. 实现模式
+
+### React（react-i18next）
+
+```tsx
+import { useTranslation } from 'react-i18next';
+
+function Welcome() {
+  const { t } = useTranslation();
+  return <h1>{t('welcome.title')}</h1>;
+}
+```
+
+### Next.js（next-intl）
+
+```tsx
+import { useTranslations } from 'next-intl';
+
+export default function Page() {
+  const t = useTranslations('Home');
+  return <h1>{t('title')}</h1>;
+}
+```
+
+### Python（gettext）
+
+```python
+from gettext import gettext as _
+
+print(_("Welcome to our app"))
+```
+
+---
+
+## 4. 文件结构
+
+```
+locales/
+├── en/
+│   ├── common.json
+│   ├── auth.json
+│   └── errors.json
+├── tr/
+│   ├── common.json
+│   ├── auth.json
+│   └── errors.json
+└── ar/          # RTL
+    └── ...
+```
+
+---
+
+## 5. 最佳实践
+
+### 推荐 ✅
+
+- 使用翻译键值，而非原始文本
+- 按功能模块对翻译进行命名空间划分
+- 支持复数形式
+- 根据不同地区处理日期/数字格式
+- 从项目开始就规划 RTL 支持
+- 对复杂字符串使用 ICU 消息格式
+
+### 避免 ❌
+
+- 在组件中硬编码字符串
+- 将多个翻译片段手动拼接
+- 假设文本长度一致（德语通常比英语长 30%）
+- 忘记考虑 RTL 布局
+- 在同一个文件中混用不同语言
+
+---
+
+## 6. 常见问题
+
+| 问题 | 解决方案 |
+| --- | --- |
+| 缺少翻译 | 回退到默认语言 |
+| 硬编码字符串 | 使用 Linter/检查脚本 |
+| 日期格式 | 使用 Intl.DateTimeFormat |
+| 数字格式 | 使用 Intl.NumberFormat |
+| 复数逻辑 | 使用 ICU 消息格式 |
+
+---
+
+## 7. RTL 支持
+
+```css
+/* CSS Logical Properties */
+.container {
+  margin-inline-start: 1rem;  /* Not margin-left */
+  padding-inline-end: 1rem;   /* Not padding-right */
+}
+
+[dir="rtl"] .icon {
+  transform: scaleX(-1);
+}
+```
+
+---
+
+## 8. 检查清单
+
+在正式发布前：
+
+- [ ] 所有面向用户的字符串都使用了翻译键值
+- [ ] 所有支持的语言都有对应的本地化文件
+- [ ] 日期/数字格式化使用了 Intl API
+- [ ] RTL 布局已测试（如适用）
+- [ ] 已配置默认回退语言
+- [ ] 组件中没有硬编码字符串
+
+---
+
+## 脚本
+
+| 脚本 | 用途 | 执行命令 |
+| --- | --- | --- |
+| `scripts/i18n_checker.py` | 检测硬编码字符串与缺失翻译 | `python scripts/i18n_checker.py <project_path>` |