@waoooo/claude-skills 1.0.0

package/skills/capability-tree-query/SKILL.md

@@ -0,0 +1,112 @@
+# Skill: capability-tree-query
+
+## 功能
+
+查询和更新全局能力树（capability-tree.json）。
+
+## 何时调用
+
+- 开始任何 Job 之前
+- 需要查询能力状态时
+- 需要检查能力是否存在时
+
+## 输入
+
+无需输入参数
+
+## 输出
+
+- `exports/capability-tree/capability-tree.json` - 全局能力树
+- `exports/capability-tree/capability-tree.yaml` - YAML 格式（可选）
+
+## 执行步骤
+
+1. 运行构建脚本
+   ```bash
+   pnpm capability:build-tree
+   ```
+
+2. 验证输出
+   - 检查 `capability-tree.json` 是否生成
+   - 检查文件格式是否正确
+
+3. 显示统计信息
+   - 总能力数量
+   - 各层级能力数量（L1, L2, L3, L5）
+   - 已实现 vs 未实现
+
+## 使用示例
+
+### 示例 1：更新能力树
+
+```
+用户: "更新能力树"
+
+Agent 行动:
+1. 调用 capability-tree-query
+2. 运行 pnpm capability:build-tree
+3. 显示结果:
+   ✅ 能力树已更新
+   📊 统计:
+   - 总计: 83 个能力
+   - L1: 13 个
+   - L2: 51 个
+   - L3: 15 个
+   - L5: 4 个
+```
+
+### 示例 2：查询能力状态
+
+```
+用户: "auth 能力存在吗？"
+
+Agent 行动:
+1. 读取 capability-tree.json
+2. 搜索 id = "auth"
+3. 显示结果:
+   ✅ 找到能力: auth
+   - 名称: 认证系统
+   - 层级: L1
+   - 状态: implemented
+```
+
+## 错误处理
+
+### 错误 1：能力文档不存在
+
+```
+❌ 错误: 找不到能力文档
+📁 路径: waoooo-docs/developer-docs/capabilities/
+
+💡 建议:
+1. 检查 waoooo-docs 仓库是否存在
+2. 确认路径配置正确
+3. 检查文档目录结构
+```
+
+### 错误 2：生成失败
+
+```
+❌ 错误: 能力树生成失败
+🔍 原因: MDX 解析错误
+
+💡 建议:
+1. 检查 MDX 文档格式
+2. 查看详细错误日志
+3. 修复 MDX 后重试
+```
+
+## 相关脚本
+
+- `src/scripts/build-capability-tree.ts` - 构建能力树的核心脚本
+
+## 相关文件
+
+- `exports/capability-tree/capability-tree.json` - 输出文件
+- `waoooo-docs/developer-docs/capabilities/**/*.mdx` - 输入文件
+
+## 注意事项
+
+1. **只读操作** - 此 Skill 只生成能力树，不修改源文件
+2. **幂等性** - 可以重复执行，结果一致
+3. **依赖外部仓库** - 需要 waoooo-docs 仓库存在

package/skills/capability-tree-query/scripts/build-capability-tree.ts

@@ -0,0 +1,402 @@
+/**
+ * Build Capability Tree from mint.json
+ * 
+ * Purpose: Generate a simple capability reference list for Product Builder
+ * Output: JSON with id, name, layer, status, description, children, docsLink
+ */
+
+import fs from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+
+interface MintNavigation {
+  group: string;
+  pages: (string | MintNavigation)[];
+}
+
+interface MintJson {
+  navigation: MintNavigation[];
+}
+
+interface Capability {
+  id: string;
+  name: string;
+  layer: 'L1' | 'L2' | 'L3' | 'L4' | 'L5';
+  status: 'implemented' | 'partial' | 'planned' | 'missing';
+  description: string;
+  tags: string[]; // 自动生成的标签
+  requires?: string[]; // 依赖的能力 ID
+  relatedTo?: string[]; // 相关的能力 ID
+  parentId?: string;
+  children?: Capability[];
+  docsLink: string;
+}
+
+interface CapabilityTree {
+  version: string;
+  generatedAt: string;
+  sourceDir: string;
+  capabilities: Capability[];
+}
+
+function loadMintJson(docsDir: string): MintJson {
+  const mintPath = path.join(docsDir, 'mint.json');
+  const content = fs.readFileSync(mintPath, 'utf-8');
+  return JSON.parse(content);
+}
+
+function extractLayer(groupName: string): Capability['layer'] | null {
+  // Skip non-capability groups
+  if (groupName.includes('开发指南') || groupName.includes('使用指南') || groupName.includes('指南')) {
+    return null;
+  }
+  
+  // Skip L4 product capabilities and product documentation
+  if (groupName.includes('产品')) {
+    return null;
+  }
+  
+  if (groupName.includes('L1') || groupName.includes('基础能力')) return 'L1';
+  if (groupName.includes('L2') || groupName.includes('连接能力')) return 'L2';
+  if (groupName.includes('L3') || groupName.includes('专业能力')) return 'L3';
+  if (groupName.includes('L5') || groupName.includes('开放能力')) return 'L5';
+  return null;
+}
+
+function shouldSkipPage(pagePath: string): boolean {
+  const skipPages = [
+    'capabilities/l1-foundation',
+    'capabilities/l2-integration',
+    'capabilities/l3-professional',
+    'capabilities/l4-product',
+    'capabilities/l5-open',
+  ];
+  return skipPages.includes(pagePath);
+}
+
+function extractId(pagePath: string): string {
+  const pathParts = pagePath.split('/');
+  if (pathParts[pathParts.length - 1] === 'overview') {
+    return pathParts[pathParts.length - 2];
+  }
+  return pathParts[pathParts.length - 1];
+}
+
+function extractStatus(content: string): Capability['status'] {
+  if (content.includes('✅ 已实现') || content.includes('已完成')) {
+    return 'implemented';
+  } else if (content.includes('⚠️') || content.includes('🚧') || content.includes('部分')) {
+    return 'partial';
+  } else if (content.includes('📅') || content.includes('计划')) {
+    return 'planned';
+  }
+  return 'missing';
+}
+
+/**
+ * Auto-generate tags from capability name and description
+ */
+function generateTags(name: string, description: string, id: string): string[] {
+  const tags = new Set<string>();
+  
+  // Add ID
+  tags.add(id);
+  
+  // Add name (split by space, dash, etc.)
+  const nameWords = name
+    .toLowerCase()
+    .split(/[\s\-_\/]+/)
+    .filter(w => w.length > 1);
+  nameWords.forEach(w => tags.add(w));
+  
+  // Add description keywords (extract important words)
+  if (description) {
+    const descWords = description
+      .toLowerCase()
+      .replace(/[^\w\s\u4e00-\u9fa5]/g, ' ')
+      .split(/\s+/)
+      .filter(w => w.length > 1)
+      .slice(0, 10); // Top 10 words
+    descWords.forEach(w => tags.add(w));
+  }
+  
+  // Add English translation of common Chinese terms
+  const translations: Record<string, string[]> = {
+    '认证': ['auth', 'authentication'],
+    '授权': ['authorization', 'permission'],
+    '会员': ['membership', 'member'],
+    '定价': ['pricing', 'price'],
+    '支付': ['payment', 'pay'],
+    '路由': ['routing', 'route'],
+    '网关': ['gateway'],
+    '存储': ['storage', 'store'],
+    '监控': ['monitoring', 'monitor'],
+    '日志': ['logging', 'log'],
+  };
+  
+  for (const [chinese, english] of Object.entries(translations)) {
+    if (name.includes(chinese) || description.includes(chinese)) {
+      english.forEach(e => tags.add(e));
+    }
+  }
+  
+  return Array.from(tags);
+}
+
+function readMDXMetadata(docsDir: string, pagePath: string): { 
+  description: string; 
+  status: Capability['status']; 
+  tags: string[]; 
+  keywords: string[];
+  requires?: string[];
+  relatedTo?: string[];
+} {
+  const mdxPath = path.join(docsDir, `${pagePath}.mdx`);
+  
+  if (!fs.existsSync(mdxPath)) {
+    return { description: '', status: 'missing', tags: [], keywords: [] };
+  }
+  
+  try {
+    const content = fs.readFileSync(mdxPath, 'utf-8');
+    const { data } = matter(content);
+    const description = data.description || '';
+    const status = extractStatus(content);
+    
+    // Read keywords from frontmatter (preferred)
+    const keywords = data.keywords || [];
+    
+    // Read dependency information from frontmatter
+    const requires = data.requires || [];
+    const relatedTo = data.relatedTo || data.related || [];
+    
+    // Fallback: generate tags from name and description
+    const capName = pagePath.split('/').pop() || '';
+    const tags = keywords.length > 0 ? keywords : generateTags(capName, description, capName);
+    
+    return { description, status, tags, keywords, requires, relatedTo };
+  } catch (error) {
+    return { description: '', status: 'missing', tags: [], keywords: [] };
+  }
+}
+
+function parseCapabilityFromGroup(
+  docsDir: string,
+  group: MintNavigation,
+  layer: Capability['layer'],
+  parentId?: string
+): Capability | null {
+  try {
+    const groupName = group.group;
+    
+    const mainPage = group.pages.find(p => {
+      if (typeof p === 'string') {
+        return p.endsWith('/overview') || true;
+      }
+      return false;
+    }) as string | undefined;
+    
+    if (!mainPage) {
+      console.warn(`  ⚠ No main page found for group: ${groupName}`);
+      return null;
+    }
+    
+    const id = extractId(mainPage);
+    const { description, status, tags, requires, relatedTo } = readMDXMetadata(docsDir, mainPage);
+    
+    const children: Capability[] = [];
+    for (const page of group.pages) {
+      if (typeof page === 'string') {
+        const pageName = page.split('/').pop() || '';
+        // Skip documentation pages (not capabilities)
+        if (pageName === 'overview' || pageName === 'concepts' || pageName === 'usage') {
+          continue;
+        }
+        
+        const childId = extractId(page);
+        const { description: childDescription, status: childStatus, requires: childRequires, relatedTo: childRelatedTo } = readMDXMetadata(docsDir, page);
+        
+        const mdxPath = path.join(docsDir, `${page}.mdx`);
+        let childName = childId;
+        
+        if (fs.existsSync(mdxPath)) {
+          const content = fs.readFileSync(mdxPath, 'utf-8');
+          const { data } = matter(content);
+          childName = data.title || childId;
+        }
+        
+        children.push({
+          id: childId,
+          name: childName,
+          layer,
+          status: childStatus,
+          description: childDescription,
+          requires: childRequires,
+          relatedTo: childRelatedTo,
+          parentId: id,
+          docsLink: `/${page}`,
+        });
+      } else if (page.group) {
+        const child = parseCapabilityFromGroup(docsDir, page, layer, id);
+        if (child) {
+          children.push(child);
+        }
+      }
+    }
+    
+    return {
+      id,
+      name: groupName,
+      layer,
+      status,
+      description,
+      requires,
+      relatedTo,
+      parentId,
+      children: children.length > 0 ? children : undefined,
+      docsLink: `/${mainPage}`,
+    };
+  } catch (error) {
+    console.error(`Error parsing group ${group.group}:`, error);
+    return null;
+  }
+}
+
+function parseCapabilityFromPage(
+  docsDir: string,
+  pagePath: string,
+  layer: Capability['layer']
+): Capability | null {
+  try {
+    const id = extractId(pagePath);
+    const { description, status, requires, relatedTo } = readMDXMetadata(docsDir, pagePath);
+    
+    const mdxPath = path.join(docsDir, `${pagePath}.mdx`);
+    let name = id;
+    
+    if (fs.existsSync(mdxPath)) {
+      const content = fs.readFileSync(mdxPath, 'utf-8');
+      const { data } = matter(content);
+      name = data.title || id;
+    }
+    
+    return {
+      id,
+      name,
+      layer,
+      status,
+      description,
+      requires,
+      relatedTo,
+      docsLink: `/${pagePath}`,
+    };
+  } catch (error) {
+    console.error(`Error parsing page ${pagePath}:`, error);
+    return null;
+  }
+}
+
+export function buildCapabilityTree(docsDir: string): CapabilityTree {
+  const mintJson = loadMintJson(docsDir);
+  const capabilities: Capability[] = [];
+  
+  for (const navGroup of mintJson.navigation) {
+    const layer = extractLayer(navGroup.group);
+    
+    if (!layer) {
+      continue;
+    }
+    
+    console.log(`\nProcessing ${navGroup.group} (${layer})...`);
+    
+    for (const page of navGroup.pages) {
+      if (typeof page === 'string') {
+        if (shouldSkipPage(page)) {
+          console.log(`  Skipping layer overview: ${page}`);
+          continue;
+        }
+        
+        const capability = parseCapabilityFromPage(docsDir, page, layer);
+        if (capability) {
+          console.log(`  ✓ Added capability: ${capability.name} (${capability.id})`);
+          capabilities.push(capability);
+        }
+      } else if (page.group) {
+        const capability = parseCapabilityFromGroup(docsDir, page, layer);
+        if (capability) {
+          const childCount = capability.children ? capability.children.length : 0;
+          console.log(`  ✓ Added capability: ${capability.name} (${capability.id})${childCount > 0 ? ` with ${childCount} children` : ''}`);
+          capabilities.push(capability);
+        }
+      }
+    }
+  }
+  
+  capabilities.sort((a, b) => {
+    if (a.layer !== b.layer) {
+      return a.layer.localeCompare(b.layer);
+    }
+    return a.name.localeCompare(b.name);
+  });
+  
+  return {
+    version: '1.0.0',
+    generatedAt: new Date().toISOString(),
+    sourceDir: docsDir,
+    capabilities,
+  };
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const args = process.argv.slice(2);
+  const inputDir = args[0] || '../../../waoooo-docs/developer-docs';
+  const outputFile = args[1] || './exports/capability-tree/capability-tree.json';
+  
+  console.log('Building capability tree from mint.json...');
+  console.log('Input:', inputDir);
+  
+  const tree = buildCapabilityTree(inputDir);
+  
+  function countCapabilities(caps: Capability[]): { total: number; byLayer: Record<string, number> } {
+    let total = 0;
+    const byLayer: Record<string, number> = { L1: 0, L2: 0, L3: 0, L4: 0, L5: 0 };
+    
+    for (const cap of caps) {
+      total++;
+      byLayer[cap.layer]++;
+      
+      if (cap.children) {
+        const childCounts = countCapabilities(cap.children);
+        total += childCounts.total;
+        Object.keys(childCounts.byLayer).forEach(layer => {
+          byLayer[layer] += childCounts.byLayer[layer];
+        });
+      }
+    }
+    
+    return { total, byLayer };
+  }
+  
+  const counts = countCapabilities(tree.capabilities);
+  
+  console.log(`\n✓ Found ${counts.total} capabilities (${tree.capabilities.length} root):`);
+  console.log(`  L1: ${counts.byLayer.L1}`);
+  console.log(`  L2: ${counts.byLayer.L2}`);
+  console.log(`  L3: ${counts.byLayer.L3}`);
+  console.log(`  L4: ${counts.byLayer.L4}`);
+  console.log(`  L5: ${counts.byLayer.L5}`);
+  
+  const outputDir = path.dirname(outputFile);
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  
+  fs.writeFileSync(outputFile, JSON.stringify(tree, null, 2));
+  console.log(`\n✓ Output (JSON): ${outputFile}`);
+  
+  const yaml = await import('js-yaml');
+  const yamlFile = outputFile.replace('.json', '.yaml');
+  const yamlContent = yaml.dump(tree, { indent: 2, lineWidth: 120 });
+  fs.writeFileSync(yamlFile, yamlContent);
+  console.log(`✓ Output (YAML): ${yamlFile}`);
+}

package/skills/changelog-generator/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: changelog-generator
+description: Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
+---
+
+# Changelog Generator
+
+This skill transforms technical git commits into polished, user-friendly changelogs that your customers and users will actually understand and appreciate.
+
+## When to Use This Skill
+
+- Preparing release notes for a new version
+- Creating weekly or monthly product update summaries
+- Documenting changes for customers
+- Writing changelog entries for app store submissions
+- Generating update notifications
+- Creating internal release documentation
+- Maintaining a public changelog/product updates page
+
+## What This Skill Does
+
+1. **Scans Git History**: Analyzes commits from a specific time period or between versions
+2. **Categorizes Changes**: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
+3. **Translates Technical → User-Friendly**: Converts developer commits into customer language
+4. **Formats Professionally**: Creates clean, structured changelog entries
+5. **Filters Noise**: Excludes internal commits (refactoring, tests, etc.)
+6. **Follows Best Practices**: Applies changelog guidelines and your brand voice
+
+## How to Use
+
+### Basic Usage
+
+From your project repository:
+
+```
+Create a changelog from commits since last release
+```
+
+```
+Generate changelog for all commits from the past week
+```
+
+```
+Create release notes for version 2.5.0
+```
+
+### With Specific Date Range
+
+```
+Create a changelog for all commits between March 1 and March 15
+```
+
+### With Custom Guidelines
+
+```
+Create a changelog for commits since v2.4.0, using my changelog 
+guidelines from CHANGELOG_STYLE.md
+```
+
+## Example
+
+**User**: "Create a changelog for commits from the past 7 days"
+
+**Output**:
+```markdown
+# Updates - Week of March 10, 2024
+
+## ✨ New Features
+
+- **Team Workspaces**: Create separate workspaces for different 
+  projects. Invite team members and keep everything organized.
+
+- **Keyboard Shortcuts**: Press ? to see all available shortcuts. 
+  Navigate faster without touching your mouse.
+
+## 🔧 Improvements
+
+- **Faster Sync**: Files now sync 2x faster across devices
+- **Better Search**: Search now includes file contents, not just titles
+
+## 🐛 Fixes
+
+- Fixed issue where large images wouldn't upload
+- Resolved timezone confusion in scheduled posts
+- Corrected notification badge count
+```
+
+**Inspired by:** Manik Aggarwal's use case from Lenny's Newsletter
+
+## Tips
+
+- Run from your git repository root
+- Specify date ranges for focused changelogs
+- Use your CHANGELOG_STYLE.md for consistent formatting
+- Review and adjust the generated changelog before publishing
+- Save output directly to CHANGELOG.md
+
+## Related Use Cases
+
+- Creating GitHub release notes
+- Writing app store update descriptions
+- Generating email updates for users
+- Creating social media announcement posts
+

package/skills/continue/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: continue
+description: Attach the newest context-transfer Markdown from the current project's ./.ccb/history/ into Claude using @file. Use when the user types /continue or asks to resume with the latest transfer file in this project.
+---
+
+# Continue (Attach Latest History)
+
+## Overview
+
+Find the newest Markdown in `./.ccb/history/` (or legacy `./.ccb_config/history/`) and reply with an `@file` reference so Claude loads it.
+
+## Workflow
+
+1. Locate the newest `.md` under the current project's history folder.
+2. If none exists, report that no history file was found.
+3. Reply with a single line `@<path>` and nothing else.
+
+## Execution (MANDATORY)
+
+```bash
+latest="$(ls -t "$PWD"/.ccb/history/*.md 2>/dev/null | head -n 1)"
+if [[ -z "$latest" ]]; then
+  latest="$(ls -t "$PWD"/.ccb_config/history/*.md 2>/dev/null | head -n 1)"
+fi
+if [[ -z "$latest" ]]; then
+  echo "No history file found in ./.ccb/history."
+  exit 0
+fi
+printf '@%s\n' "$latest"
+```
+
+## Output Rules
+
+- When a history file exists: output only `@<path>` on a single line.
+- When none exists: output the error message and stop.
+
+## Examples
+
+- `/continue` -> `@/home/bfly/workspace/hippocampus/.ccb/history/claude-20260208-225221-9f236442.md`

package/skills/continue/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Continue"
+  short_description: "Help with Continue tasks and workflows"