@waoooo/claude-skills 1.0.0

package/skills/mdx-to-openspec/scripts/mdx-to-openspec.ts

@@ -0,0 +1,320 @@
+/**
+ * Convert MDX document to OpenSpec format
+ * 
+ * This script:
+ * 1. Uses OpenSpec CLI to create standard structure
+ * 2. Parses MDX document
+ * 3. Fills OpenSpec files (proposal.md, design.md, tasks.md)
+ * 
+ * Usage:
+ *   npx tsx .claude/skills/mdx-to-openspec/scripts/mdx-to-openspec.ts \
+ *     --mdx-path <path> \
+ *     --change-name <name>
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import matter from 'gray-matter';
+
+interface MdxContent {
+  frontmatter: Record<string, any>;
+  content: string;
+  title: string;
+  description: string;
+  sections: Record<string, string>;
+}
+
+function parseMdx(mdxPath: string): MdxContent {
+  const content = fs.readFileSync(mdxPath, 'utf-8');
+  const { data: frontmatter, content: body } = matter(content);
+  
+  // Extract title
+  let title = frontmatter.title || '';
+  if (!title) {
+    const titleMatch = body.match(/^#\s+(.+)$/m);
+    if (titleMatch) {
+      title = titleMatch[1];
+    }
+  }
+  
+  const description = frontmatter.description || '';
+  
+  // Extract sections by ## headings
+  const sections: Record<string, string> = {};
+  const parts = body.split(/^##\s+/m);
+  
+  for (let i = 1; i < parts.length; i++) {
+    const lines = parts[i].split('\n');
+    const heading = lines[0].trim();
+    const sectionBody = lines.slice(1).join('\n').trim();
+    sections[heading] = sectionBody;
+  }
+  
+  return {
+    frontmatter,
+    content: body,
+    title,
+    description,
+    sections
+  };
+}
+
+function extractTasks(content: string): string[] {
+  const tasks: string[] = [];
+  
+  // Extract checkbox items
+  const checkboxPattern = /^[-*]\s+\[[ x]\]\s+(.+)$/gm;
+  let match;
+  
+  while ((match = checkboxPattern.exec(content)) !== null) {
+    tasks.push(match[1]);
+  }
+  
+  // Extract numbered lists if no checkboxes found
+  if (tasks.length === 0) {
+    const numberedPattern = /^\d+\.\s+(.+)$/gm;
+    while ((match = numberedPattern.exec(content)) !== null) {
+      tasks.push(match[1]);
+    }
+  }
+  
+  return tasks;
+}
+
+function generateProposal(mdxContent: MdxContent): string {
+  const { title, description, sections } = mdxContent;
+  
+  const goals = sections['目标'] || sections['Goals'] || sections['战略目标'] || 
+                sections['Strategic Goals'] || '从 MDX 文档中提取的目标';
+  
+  const background = sections['背景'] || sections['Background'] || sections['愿景'] ||
+                    sections['Vision'] || '从 MDX 文档中提取的背景信息';
+  
+  const scope = sections['范围'] || sections['Scope'] || sections['功能范围'] ||
+               '从 MDX 文档中提取的范围说明';
+  
+  return `# ${title}
+
+## 概述
+
+${description || '从 MDX 文档转换的提案'}
+
+## 目标
+
+${goals}
+
+## 背景
+
+${background}
+
+## 范围
+
+${scope}
+
+## 非目标
+
+（请补充非目标内容）
+
+## 成功标准
+
+（请补充成功标准）
+
+## 时间线
+
+（请补充时间线）
+
+---
+
+**来源**: 从 MDX 文档自动生成
+**状态**: 草稿
+**创建时间**: ${new Date().toISOString()}
+`;
+}
+
+function generateDesign(mdxContent: MdxContent): string {
+  const { title, sections } = mdxContent;
+  
+  const architecture = sections['架构'] || sections['Architecture'] ||
+                      sections['架构设计'] || sections['整体架构'] ||
+                      sections['设计'] || sections['Design'] ||
+                      '（请补充架构设计）';
+  
+  const implementation = sections['实现'] || sections['Implementation'] ||
+                        sections['技术方案'] || sections['Technical Solution'] ||
+                        sections['实现细节'] || sections['前端实现'] ||
+                        '（请补充实现细节）';
+  
+  return `# ${title} - 技术设计
+
+## 架构设计
+
+${architecture}
+
+## 实现细节
+
+${implementation}
+
+## 数据模型
+
+（请补充数据模型）
+
+## API 设计
+
+（请补充 API 设计）
+
+## 安全考虑
+
+（请补充安全考虑）
+
+## 性能考虑
+
+（请补充性能考虑）
+
+## 测试策略
+
+（请补充测试策略）
+
+---
+
+**来源**: 从 MDX 文档自动生成
+**状态**: 草稿
+**创建时间**: ${new Date().toISOString()}
+`;
+}
+
+function generateTasks(mdxContent: MdxContent): string {
+  const { title, content } = mdxContent;
+  
+  // Extract tasks from MDX
+  const tasks = extractTasks(content);
+  
+  let tasksSection = '';
+  if (tasks.length > 0) {
+    tasksSection = tasks.map(task => `- [ ] ${task}`).join('\n');
+  } else {
+    tasksSection = `- [ ] 任务 1：（请补充）
+- [ ] 任务 2：（请补充）
+- [ ] 任务 3：（请补充）`;
+  }
+  
+  return `# ${title} - 任务清单
+
+## 开发任务
+
+${tasksSection}
+
+## 测试任务
+
+- [ ] 单元测试
+- [ ] 集成测试
+- [ ] 端到端测试
+
+## 文档任务
+
+- [ ] 更新 API 文档
+- [ ] 更新用户文档
+- [ ] 更新 CHANGELOG
+
+## 验证标准
+
+- [ ] 所有测试通过
+- [ ] 代码审查完成
+- [ ] 文档更新完成
+
+---
+
+**来源**: 从 MDX 文档自动生成
+**状态**: 草稿
+**创建时间**: ${new Date().toISOString()}
+`;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  
+  let mdxPath = '';
+  let changeName = '';
+  let openspecRoot = '/Users/danlio/Repositories/waoooo/openspec';
+  
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--mdx-path' && args[i + 1]) {
+      mdxPath = args[i + 1];
+      i++;
+    } else if (args[i] === '--change-name' && args[i + 1]) {
+      changeName = args[i + 1];
+      i++;
+    } else if (args[i] === '--openspec-root' && args[i + 1]) {
+      openspecRoot = args[i + 1];
+      i++;
+    }
+  }
+  
+  if (!mdxPath || !changeName) {
+    console.error('Usage: tsx mdx-to-openspec.ts --mdx-path <path> --change-name <name>');
+    console.error('');
+    console.error('Example:');
+    console.error('  tsx mdx-to-openspec.ts \\');
+    console.error('    --mdx-path /path/to/pricing-system.mdx \\');
+    console.error('    --change-name pricing-frontend-refactor');
+    process.exit(1);
+  }
+  
+  if (!fs.existsSync(mdxPath)) {
+    console.error(`❌ Error: MDX file not found: ${mdxPath}`);
+    process.exit(1);
+  }
+  
+  console.log('📖 Parsing MDX document...');
+  const mdxContent = parseMdx(mdxPath);
+  console.log(`✅ Parsed: ${mdxContent.title}`);
+  
+  console.log('\n📁 Creating OpenSpec structure...');
+  const changesDir = path.join(openspecRoot, 'changes', changeName);
+  
+  if (fs.existsSync(changesDir)) {
+    console.error(`❌ Error: OpenSpec change already exists: ${changeName}`);
+    console.error(`📁 Directory: ${changesDir}`);
+    console.error('');
+    console.error('💡 Options:');
+    console.error('  1. Use a different change name');
+    console.error('  2. Delete the existing change');
+    console.error('  3. Update the existing change');
+    process.exit(1);
+  }
+  
+  fs.mkdirSync(changesDir, { recursive: true });
+  fs.mkdirSync(path.join(changesDir, 'specs'), { recursive: true });
+  console.log(`✅ Created: ${changesDir}`);
+  
+  console.log('\n📝 Generating OpenSpec files...');
+  
+  console.log('  - proposal.md');
+  const proposal = generateProposal(mdxContent);
+  fs.writeFileSync(path.join(changesDir, 'proposal.md'), proposal, 'utf-8');
+  
+  console.log('  - design.md');
+  const design = generateDesign(mdxContent);
+  fs.writeFileSync(path.join(changesDir, 'design.md'), design, 'utf-8');
+  
+  console.log('  - tasks.md');
+  const tasks = generateTasks(mdxContent);
+  fs.writeFileSync(path.join(changesDir, 'tasks.md'), tasks, 'utf-8');
+  
+  console.log('\n✅ OpenSpec created successfully!');
+  console.log(`\n📂 Location: ${changesDir}`);
+  console.log('📄 Files:');
+  console.log('  - proposal.md');
+  console.log('  - design.md');
+  console.log('  - tasks.md');
+  console.log('\n💡 Next steps:');
+  console.log('  1. Review and complete the generated files');
+  console.log('  2. Run: openspec validate ' + changeName);
+  console.log('  3. Run: openspec approve ' + changeName);
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}
+
+export { parseMdx, generateProposal, generateDesign, generateTasks };

package/skills/mounted/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: mounted
+description: Report which CCB providers are mounted (session exists AND daemon is online). Outputs JSON.
+metadata:
+  short-description: Show mounted CCB providers as JSON
+---
+
+# Mounted Providers
+
+Reports which CCB providers are considered "mounted" for the current project.
+
+## Definition
+
+`mounted = has_session && daemon_on`
+
+## Execution
+
+```bash
+ccb-mounted
+```