claude-code-workflow 6.3.24 → 6.3.25

package/.claude/skills/text-formatter/SKILL.md

@@ -0,0 +1,196 @@
+---
+name: text-formatter
+description: Transform and optimize text content with intelligent formatting. Output BBCode + Markdown hybrid format optimized for forums. Triggers on "format text", "text formatter", "排版", "格式化文本", "BBCode".
+allowed-tools: Task, AskUserQuestion, Read, Write, Bash, Glob
+---
+
+# Text Formatter
+
+Transform and optimize text content with intelligent structure analysis. Output format: **BBCode + Markdown hybrid** optimized for forum publishing.
+
+## Architecture Overview
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Text Formatter Architecture (BBCode + MD Mode)                  │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│  Phase 1: Input Collection  → 接收文本/文件                       │
+│           ↓                                                      │
+│  Phase 2: Content Analysis  → 分析结构、识别 Callout/Admonition  │
+│           ↓                                                      │
+│  Phase 3: Format Transform  → 转换为 BBCode+MD 格式              │
+│           ↓                                                      │
+│  Phase 4: Output & Preview  → 保存文件 + 预览                    │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Key Design Principles
+
+1. **Single Format Output**: BBCode + Markdown hybrid (forum optimized)
+2. **Pixel-Based Sizing**: size=150/120/100/80 (not 1-7 levels)
+3. **Forum Compatibility**: Only use widely-supported BBCode tags
+4. **Markdown Separators**: Use `---` for horizontal rules (not `[hr]`)
+5. **No Alignment Tags**: `[align]` not supported, avoid usage
+
+---
+
+## Format Specification
+
+### Supported BBCode Tags
+
+| Tag | Usage | Example |
+|-----|-------|---------|
+| `[size=N]` | Font size (pixels) | `[size=120]Title[/size]` |
+| `[color=X]` | Text color (hex/name) | `[color=#2196F3]Blue[/color]` 或 `[color=blue]` |
+| `[b]` | Bold | `[b]Bold text[/b]` |
+| `[i]` | Italic | `[i]Italic[/i]` |
+| `[s]` | Strikethrough | `[s]deleted[/s]` |
+| `[u]` | Underline | `[u]underlined[/u]` |
+| `[quote]` | Quote block | `[quote]Content[/quote]` |
+| `[code]` | Code block | `[code]code[/code]` |
+| `[img]` | Image | `[img]url[/img]` |
+| `[url]` | Link | `[url=link]text[/url]` |
+| `[list]` | List container | `[list][*]item[/list]` |
+| `[spoiler]` | Collapsible content | `[spoiler=标题]隐藏内容[/spoiler]` |
+
+### HTML to BBCode Conversion
+
+| HTML Input | BBCode Output |
+|------------|---------------|
+| `<mark>高亮</mark>` | `[color=yellow]高亮[/color]` |
+| `<u>下划线</u>` | `[u]下划线[/u]` |
+| `<details><summary>标题</summary>内容</details>` | `[spoiler=标题]内容[/spoiler]` |
+
+### Unsupported Tags (Avoid!)
+
+| Tag | Reason | Alternative |
+|-----|--------|-------------|
+| `[align]` | Not rendered | Remove or use default left |
+| `[hr]` | Shows as text | Use Markdown `---` |
+| `<div>` | HTML not supported | Use BBCode only |
+| `[table]` | Limited support | Use list or code block |
+
+### Size Hierarchy (Pixels)
+
+| Element | Size | Color | Usage |
+|---------|------|-------|-------|
+| **Main Title** | 150 | #2196F3 | Document title |
+| **Section Title** | 120 | #2196F3 | Major sections (## H2) |
+| **Subsection** | 100 | #333 | Sub-sections (### H3) |
+| **Normal Text** | (default) | - | Body content |
+| **Notes/Gray** | 80 | gray | Footnotes, metadata |
+
+### Color Palette
+
+| Color | Hex | Semantic Usage |
+|-------|-----|----------------|
+| **Blue** | #2196F3 | Titles, links, info |
+| **Green** | #4CAF50 | Success, tips, features |
+| **Orange** | #FF9800 | Warnings, caution |
+| **Red** | #F44336 | Errors, danger, important |
+| **Purple** | #9C27B0 | Examples, code |
+| **Gray** | gray | Notes, metadata |
+
+---
+
+## Mandatory Prerequisites
+
+> Read before execution:
+
+| Document | Purpose | Priority |
+|----------|---------|----------|
+| [specs/format-rules.md](specs/format-rules.md) | Format conversion rules | **P0** |
+| [specs/element-mapping.md](specs/element-mapping.md) | Element type mappings | P1 |
+| [specs/callout-types.md](specs/callout-types.md) | Callout/Admonition types | P1 |
+
+---
+
+## Execution Flow
+
+```
+┌────────────────────────────────────────────────────────────────┐
+│  Phase 1: Input Collection                                      │
+│  - Ask: paste text OR file path                                │
+│  - Output: input-config.json                                   │
+├────────────────────────────────────────────────────────────────┤
+│  Phase 2: Content Analysis                                      │
+│  - Detect structure: headings, lists, code blocks, tables      │
+│  - Identify Callouts/Admonitions (>[!type])                    │
+│  - Output: analysis.json                                       │
+├────────────────────────────────────────────────────────────────┤
+│  Phase 3: Format Transform                                      │
+│  - Apply BBCode + MD rules from specs/format-rules.md          │
+│  - Convert elements with pixel-based sizes                     │
+│  - Use Markdown --- for separators                             │
+│  - Output: formatted content                                   │
+├────────────────────────────────────────────────────────────────┤
+│  Phase 4: Output & Preview                                      │
+│  - Save to .bbcode.txt file                                    │
+│  - Display preview                                              │
+│  - Output: final file                                          │
+└────────────────────────────────────────────────────────────────┘
+```
+
+## Callout/Admonition Support
+
+支持 Obsidian 风格的 Callout 语法，转换为 BBCode quote：
+
+```markdown
+> [!NOTE]
+> 这是一个提示信息
+
+> [!WARNING]
+> 这是一个警告信息
+```
+
+转换结果：
+
+```bbcode
+[quote]
+[size=100][color=#2196F3][b]📝 注意[/b][/color][/size]
+
+这是一个提示信息
+[/quote]
+```
+
+| Type | Color | Icon |
+|------|-------|------|
+| NOTE/INFO | #2196F3 | 📝 |
+| TIP/HINT | #4CAF50 | 💡 |
+| SUCCESS | #4CAF50 | ✅ |
+| WARNING/CAUTION | #FF9800 | ⚠️ |
+| DANGER/ERROR | #F44336 | ❌ |
+| EXAMPLE | #9C27B0 | 📋 |
+
+## Directory Setup
+
+```javascript
+const timestamp = new Date().toISOString().slice(0,10).replace(/-/g, '');
+const workDir = `.workflow/.scratchpad/text-formatter-${timestamp}`;
+
+Bash(`mkdir -p "${workDir}"`);
+```
+
+## Output Structure
+
+```
+.workflow/.scratchpad/text-formatter-{date}/
+├── input-config.json       # 输入配置
+├── analysis.json           # 内容分析结果
+└── output.bbcode.txt       # BBCode+MD 输出
+```
+
+## Reference Documents
+
+| Document | Purpose |
+|----------|---------|
+| [phases/01-input-collection.md](phases/01-input-collection.md) | 收集输入内容 |
+| [phases/02-content-analysis.md](phases/02-content-analysis.md) | 分析内容结构 |
+| [phases/03-format-transform.md](phases/03-format-transform.md) | 格式转换 |
+| [phases/04-output-preview.md](phases/04-output-preview.md) | 输出和预览 |
+| [specs/format-rules.md](specs/format-rules.md) | 格式转换规则 |
+| [specs/element-mapping.md](specs/element-mapping.md) | 元素映射表 |
+| [specs/callout-types.md](specs/callout-types.md) | Callout 类型定义 |
+| [templates/bbcode-template.md](templates/bbcode-template.md) | BBCode 模板 |

package/.claude/skills/text-formatter/phases/01-input-collection.md

@@ -0,0 +1,111 @@
+# Phase 1: Input Collection
+
+收集用户输入的文本内容。
+
+## Objective
+
+- 获取用户输入内容（直接粘贴或文件路径）
+- 生成输入配置文件
+
+**注意**: 输出格式固定为 BBCode + Markdown 混合格式（论坛优化），无需选择。
+
+## Input
+
+- 来源: 用户交互
+- 配置: 无前置依赖
+
+## Execution Steps
+
+### Step 1: 询问输入方式
+
+```javascript
+const inputMethod = await AskUserQuestion({
+  questions: [
+    {
+      question: "请选择输入方式",
+      header: "输入方式",
+      multiSelect: false,
+      options: [
+        { label: "直接粘贴文本", description: "在对话中粘贴要格式化的内容" },
+        { label: "指定文件路径", description: "读取指定文件的内容" }
+      ]
+    }
+  ]
+});
+```
+
+### Step 2: 获取内容
+
+```javascript
+let content = '';
+
+if (inputMethod["输入方式"] === "直接粘贴文本") {
+  // 提示用户粘贴内容
+  const textInput = await AskUserQuestion({
+    questions: [
+      {
+        question: "请粘贴要格式化的文本内容（粘贴后选择确认）",
+        header: "文本内容",
+        multiSelect: false,
+        options: [
+          { label: "已粘贴完成", description: "确认已在上方粘贴内容" }
+        ]
+      }
+    ]
+  });
+  // 从用户消息中提取文本内容
+  content = extractUserText();
+} else {
+  // 询问文件路径
+  const filePath = await AskUserQuestion({
+    questions: [
+      {
+        question: "请输入文件路径",
+        header: "文件路径",
+        multiSelect: false,
+        options: [
+          { label: "已输入路径", description: "确认路径已在上方输入" }
+        ]
+      }
+    ]
+  });
+  content = Read(extractedFilePath);
+}
+```
+
+### Step 3: 保存配置
+
+```javascript
+const config = {
+  input_method: inputMethod["输入方式"],
+  target_format: "BBCode+MD",  // 固定格式
+  original_content: content,
+  timestamp: new Date().toISOString()
+};
+
+Write(`${workDir}/input-config.json`, JSON.stringify(config, null, 2));
+```
+
+## Output
+
+- **File**: `input-config.json`
+- **Format**: JSON
+
+```json
+{
+  "input_method": "直接粘贴文本",
+  "target_format": "BBCode+MD",
+  "original_content": "...",
+  "timestamp": "2026-01-13T..."
+}
+```
+
+## Quality Checklist
+
+- [ ] 成功获取用户输入内容
+- [ ] 内容非空且有效
+- [ ] 配置文件已保存
+
+## Next Phase
+
+→ [Phase 2: Content Analysis](02-content-analysis.md)

package/.claude/skills/text-formatter/phases/02-content-analysis.md

@@ -0,0 +1,248 @@
+# Phase 2: Content Analysis
+
+分析输入内容的结构和语义元素。
+
+## Objective
+
+- 识别内容结构（标题、段落、列表等）
+- 检测特殊元素（代码块、表格、链接等）
+- 生成结构化分析结果
+
+## Input
+
+- 依赖: `input-config.json`
+- 配置: `{workDir}/input-config.json`
+
+## Execution Steps
+
+### Step 1: 加载输入
+
+```javascript
+const config = JSON.parse(Read(`${workDir}/input-config.json`));
+const content = config.original_content;
+```
+
+### Step 2: 结构分析
+
+```javascript
+function analyzeStructure(text) {
+  const analysis = {
+    elements: [],
+    stats: {
+      headings: 0,
+      paragraphs: 0,
+      lists: 0,
+      code_blocks: 0,
+      tables: 0,
+      links: 0,
+      images: 0,
+      quotes: 0,
+      callouts: 0
+    }
+  };
+
+  // Callout 检测正则 (Obsidian 风格)
+  const CALLOUT_PATTERN = /^>\s*\[!(\w+)\](?:\s+(.+))?$/;
+
+  const lines = text.split('\n');
+  let currentElement = null;
+  let inCodeBlock = false;
+  let inList = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+
+    // 检测代码块
+    if (line.match(/^```/)) {
+      inCodeBlock = !inCodeBlock;
+      if (inCodeBlock) {
+        analysis.elements.push({
+          type: 'code_block',
+          start: i,
+          language: line.replace(/^```/, '').trim()
+        });
+        analysis.stats.code_blocks++;
+      }
+      continue;
+    }
+
+    if (inCodeBlock) continue;
+
+    // 检测标题 (Markdown 或纯文本模式)
+    if (line.match(/^#{1,6}\s/)) {
+      const level = line.match(/^(#+)/)[1].length;
+      analysis.elements.push({
+        type: 'heading',
+        level: level,
+        content: line.replace(/^#+\s*/, ''),
+        line: i
+      });
+      analysis.stats.headings++;
+      continue;
+    }
+
+    // 检测列表
+    if (line.match(/^[\s]*[-*+]\s/) || line.match(/^[\s]*\d+\.\s/)) {
+      if (!inList) {
+        analysis.elements.push({
+          type: 'list',
+          start: i,
+          ordered: line.match(/^\d+\./) !== null
+        });
+        analysis.stats.lists++;
+        inList = true;
+      }
+      continue;
+    } else {
+      inList = false;
+    }
+
+    // 检测 Callout (Obsidian 风格) - 优先于普通引用
+    const calloutMatch = line.match(CALLOUT_PATTERN);
+    if (calloutMatch) {
+      const calloutType = calloutMatch[1].toLowerCase();
+      const calloutTitle = calloutMatch[2] || null;
+      // 收集 Callout 内容行
+      const calloutContent = [];
+      let j = i + 1;
+      while (j < lines.length && lines[j].startsWith('>')) {
+        calloutContent.push(lines[j].replace(/^>\s*/, ''));
+        j++;
+      }
+      analysis.elements.push({
+        type: 'callout',
+        calloutType: calloutType,
+        title: calloutTitle,
+        content: calloutContent.join('\n'),
+        start: i,
+        end: j - 1
+      });
+      analysis.stats.callouts++;
+      i = j - 1; // 跳过已处理的行
+      continue;
+    }
+
+    // 检测普通引用
+    if (line.match(/^>\s/)) {
+      analysis.elements.push({
+        type: 'quote',
+        content: line.replace(/^>\s*/, ''),
+        line: i
+      });
+      analysis.stats.quotes++;
+      continue;
+    }
+
+    // 检测表格
+    if (line.match(/^\|.*\|$/)) {
+      analysis.elements.push({
+        type: 'table_row',
+        line: i
+      });
+      if (!analysis.elements.find(e => e.type === 'table')) {
+        analysis.stats.tables++;
+      }
+      continue;
+    }
+
+    // 检测链接
+    const links = line.match(/\[([^\]]+)\]\(([^)]+)\)/g);
+    if (links) {
+      analysis.stats.links += links.length;
+    }
+
+    // 检测图片
+    const images = line.match(/!\[([^\]]*)\]\(([^)]+)\)/g);
+    if (images) {
+      analysis.stats.images += images.length;
+    }
+
+    // 普通段落
+    if (line.trim() && !line.match(/^[-=]{3,}$/)) {
+      analysis.elements.push({
+        type: 'paragraph',
+        line: i,
+        preview: line.substring(0, 50)
+      });
+      analysis.stats.paragraphs++;
+    }
+  }
+
+  return analysis;
+}
+
+const analysis = analyzeStructure(content);
+```
+
+### Step 3: 语义增强
+
+```javascript
+// 识别特殊语义
+function enhanceSemantics(text, analysis) {
+  const enhanced = { ...analysis };
+
+  // 检测关键词强调
+  const boldPatterns = text.match(/\*\*[^*]+\*\*/g) || [];
+  const italicPatterns = text.match(/\*[^*]+\*/g) || [];
+
+  enhanced.semantics = {
+    emphasis: {
+      bold: boldPatterns.length,
+      italic: italicPatterns.length
+    },
+    estimated_reading_time: Math.ceil(text.split(/\s+/).length / 200) // 200 words/min
+  };
+
+  return enhanced;
+}
+
+const enhancedAnalysis = enhanceSemantics(content, analysis);
+```
+
+### Step 4: 保存分析结果
+
+```javascript
+Write(`${workDir}/analysis.json`, JSON.stringify(enhancedAnalysis, null, 2));
+```
+
+## Output
+
+- **File**: `analysis.json`
+- **Format**: JSON
+
+```json
+{
+  "elements": [
+    { "type": "heading", "level": 1, "content": "Title", "line": 0 },
+    { "type": "paragraph", "line": 2, "preview": "..." },
+    { "type": "callout", "calloutType": "warning", "title": "注意事项", "content": "...", "start": 4, "end": 6 },
+    { "type": "code_block", "start": 8, "language": "javascript" }
+  ],
+  "stats": {
+    "headings": 3,
+    "paragraphs": 10,
+    "lists": 2,
+    "code_blocks": 1,
+    "tables": 0,
+    "links": 5,
+    "images": 0,
+    "quotes": 1,
+    "callouts": 2
+  },
+  "semantics": {
+    "emphasis": { "bold": 5, "italic": 3 },
+    "estimated_reading_time": 2
+  }
+}
+```
+
+## Quality Checklist
+
+- [ ] 所有结构元素已识别
+- [ ] 统计信息准确
+- [ ] 语义增强完成
+- [ ] 分析文件已保存
+
+## Next Phase
+
+→ [Phase 3: Format Transform](03-format-transform.md)