wizz-method 1.0.3 → 1.1.0

package/src/skills-lib/huashu-design/scripts/tts-doubao.mjs

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+/**
+ * tts-doubao.mjs · 豆包语音 TTS（火山引擎 openspeech）
+ *
+ * 用法：
+ *   node scripts/tts-doubao.mjs --text "你好" --out demo.mp3
+ *   node scripts/tts-doubao.mjs --text-file script.txt --out out.mp3 --speed 1.0
+ *
+ * 输出：
+ *   - mp3 文件写到 --out 路径
+ *   - stdout 打印一行 JSON: {"path":"...","duration":12.34,"bytes":54321}
+ *
+ * 依赖：Node 18+（自带 fetch/crypto）、ffprobe（测时长，brew install ffmpeg）
+ *
+ * env（自动从 skill 根目录 .env 读取，也可走 process.env 覆盖）：
+ *   DOUBAO_TTS_API_KEY     必填
+ *   DOUBAO_TTS_VOICE_ID    必填（音色 id）
+ *   DOUBAO_TTS_CLUSTER     默认 volcano_icl
+ *   DOUBAO_TTS_ENDPOINT    默认 https://openspeech.bytedance.com/api/v1/tts
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { randomUUID } from 'node:crypto';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SKILL_ROOT = path.resolve(__dirname, '..');
+
+function loadEnv() {
+  const envPath = path.join(SKILL_ROOT, '.env');
+  if (!fs.existsSync(envPath)) return;
+  const text = fs.readFileSync(envPath, 'utf8');
+  for (const line of text.split('\n')) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) continue;
+    const idx = trimmed.indexOf('=');
+    if (idx < 0) continue;
+    const key = trimmed.slice(0, idx).trim();
+    let val = trimmed.slice(idx + 1).trim();
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+      val = val.slice(1, -1);
+    }
+    if (!(key in process.env)) process.env[key] = val;
+  }
+}
+loadEnv();
+
+function parseArgs(argv) {
+  const args = { speed: '1.0', encoding: 'mp3' };
+  for (let i = 2; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === '--text') args.text = argv[++i];
+    else if (a === '--text-file') args.textFile = argv[++i];
+    else if (a === '--out') args.out = argv[++i];
+    else if (a === '--speed') args.speed = argv[++i];
+    else if (a === '--voice') args.voice = argv[++i];
+    else if (a === '--encoding') args.encoding = argv[++i];
+    else if (a === '--help' || a === '-h') args.help = true;
+  }
+  return args;
+}
+
+function usage() {
+  console.error(`
+tts-doubao.mjs · 豆包语音 TTS
+
+  --text <str>          要合成的文本
+  --text-file <path>    从文件读取文本（与 --text 二选一）
+  --out <path>          输出 mp3 路径（必填）
+  --speed <float>       语速倍率，默认 1.0（0.5-2.0）
+  --voice <voice_id>    覆盖 .env 里的音色 id
+  --encoding <ext>      mp3 / wav / pcm，默认 mp3
+`.trim());
+  process.exit(1);
+}
+
+function getDuration(filePath) {
+  try {
+    const out = execFileSync('ffprobe', [
+      '-v', 'error',
+      '-show_entries', 'format=duration',
+      '-of', 'default=noprint_wrappers=1:nokey=1',
+      filePath,
+    ], { encoding: 'utf8' });
+    return parseFloat(out.trim());
+  } catch (e) {
+    return null;
+  }
+}
+
+async function tts({ text, voice, speed, encoding }) {
+  const apiKey = process.env.DOUBAO_TTS_API_KEY;
+  const cluster = process.env.DOUBAO_TTS_CLUSTER || 'volcano_icl';
+  const endpoint = process.env.DOUBAO_TTS_ENDPOINT || 'https://openspeech.bytedance.com/api/v1/tts';
+  const voiceId = voice || process.env.DOUBAO_TTS_VOICE_ID;
+
+  if (!apiKey) throw new Error('缺 DOUBAO_TTS_API_KEY（检查 .env）');
+  if (!voiceId) throw new Error('缺 DOUBAO_TTS_VOICE_ID（检查 .env 或用 --voice 传）');
+
+  const body = {
+    app: { cluster },
+    user: { uid: 'huashu-design' },
+    audio: {
+      voice_type: voiceId,
+      encoding,
+      speed_ratio: parseFloat(speed),
+    },
+    request: {
+      reqid: randomUUID(),
+      text,
+      operation: 'query',
+    },
+  };
+
+  const res = await fetch(endpoint, {
+    method: 'POST',
+    headers: {
+      'x-api-key': apiKey,
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(body),
+  });
+
+  if (!res.ok) {
+    const errText = await res.text();
+    throw new Error(`HTTP ${res.status}: ${errText.slice(0, 500)}`);
+  }
+
+  const json = await res.json();
+  // 豆包标准返回：{ code, message, data: "<base64 audio>", ... }
+  // code === 3000 表示成功
+  if (json.code !== undefined && json.code !== 3000) {
+    throw new Error(`API 返回错误 code=${json.code} msg=${json.message || JSON.stringify(json)}`);
+  }
+  if (!json.data) {
+    throw new Error(`API 响应无 data 字段：${JSON.stringify(json).slice(0, 500)}`);
+  }
+  return Buffer.from(json.data, 'base64');
+}
+
+async function main() {
+  const args = parseArgs(process.argv);
+  if (args.help) usage();
+
+  let text = args.text;
+  if (!text && args.textFile) {
+    text = fs.readFileSync(args.textFile, 'utf8').trim();
+  }
+  if (!text) {
+    console.error('错：缺 --text 或 --text-file');
+    usage();
+  }
+  if (!args.out) {
+    console.error('错：缺 --out');
+    usage();
+  }
+
+  const outPath = path.resolve(args.out);
+  fs.mkdirSync(path.dirname(outPath), { recursive: true });
+
+  const audio = await tts({
+    text,
+    voice: args.voice,
+    speed: args.speed,
+    encoding: args.encoding,
+  });
+
+  fs.writeFileSync(outPath, audio);
+  const duration = getDuration(outPath);
+  const result = {
+    path: outPath,
+    bytes: audio.length,
+    duration,
+    text_chars: text.length,
+  };
+  console.log(JSON.stringify(result));
+}
+
+main().catch((err) => {
+  console.error(`TTS 失败：${err.message}`);
+  process.exit(1);
+});

package/src/skills-lib/huashu-design/scripts/verify.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+"""
+verify.py — Playwright封装，用于验证claude-design产出的HTML
+
+Usage:
+    python verify.py path/to/design.html                    # 基础：打开+截图+抓控制台错误
+    python verify.py design.html --viewports 1920x1080,375x667  # 多viewport
+    python verify.py deck.html --slides 10                  # 幻灯片逐页截（前10张）
+    python verify.py design.html --output ./screenshots/   # 输出目录
+    python verify.py design.html --show                    # 非headless，打开真实浏览器
+
+依赖：
+    pip install playwright
+    playwright install chromium
+"""
+
+import argparse
+import sys
+import os
+import time
+from pathlib import Path
+
+
+def parse_viewport(s):
+    w, h = s.split('x')
+    return {'width': int(w), 'height': int(h)}
+
+
+def verify_html(html_path, viewports=None, slides=0, output_dir=None, show=False, wait=2000):
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError:
+        print("ERROR: playwright未安装。")
+        print("运行: pip install playwright && playwright install chromium")
+        sys.exit(1)
+
+    html_path = Path(html_path).resolve()
+    if not html_path.exists():
+        print(f"ERROR: 文件不存在: {html_path}")
+        sys.exit(1)
+
+    if output_dir is None:
+        output_dir = html_path.parent / 'screenshots'
+    output_dir = Path(output_dir)
+    output_dir.mkdir(parents=True, exist_ok=True)
+
+    file_url = html_path.as_uri()
+    stem = html_path.stem
+
+    if viewports is None:
+        viewports = [{'width': 1440, 'height': 900}]
+
+    console_errors = []
+    page_errors = []
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=not show)
+
+        for viewport in viewports:
+            context = browser.new_context(viewport=viewport, device_scale_factor=2)
+            page = context.new_page()
+
+            page.on("console", lambda msg: console_errors.append(f"[{msg.type}] {msg.text}") if msg.type in ("error", "warning") else None)
+            page.on("pageerror", lambda err: page_errors.append(str(err)))
+
+            print(f"\n→ 打开 {file_url} @ {viewport['width']}x{viewport['height']}")
+            page.goto(file_url, wait_until='networkidle')
+            page.wait_for_timeout(wait)
+
+            if slides > 0:
+                for i in range(slides):
+                    screenshot_path = output_dir / f"{stem}-slide-{str(i + 1).zfill(2)}.png"
+                    page.screenshot(path=str(screenshot_path), full_page=False)
+                    print(f"  ✓ slide {i+1} → {screenshot_path.name}")
+
+                    if i < slides - 1:
+                        page.keyboard.press('ArrowRight')
+                        page.wait_for_timeout(500)
+            else:
+                suffix = f"-{viewport['width']}x{viewport['height']}" if len(viewports) > 1 else ""
+                screenshot_path = output_dir / f"{stem}{suffix}.png"
+                page.screenshot(path=str(screenshot_path), full_page=False)
+                print(f"  ✓ 截图 → {screenshot_path.name}")
+
+                full_path = output_dir / f"{stem}{suffix}-full.png"
+                page.screenshot(path=str(full_path), full_page=True)
+                print(f"  ✓ 完整页 → {full_path.name}")
+
+            if show:
+                print("  (浏览器窗口保持打开，按Enter关闭...)")
+                input()
+
+            context.close()
+
+        browser.close()
+
+    print("\n" + "=" * 50)
+    print("验证报告")
+    print("=" * 50)
+
+    if page_errors:
+        print(f"\n❌ Page Errors ({len(page_errors)}):")
+        for e in page_errors:
+            print(f"  - {e}")
+    else:
+        print("\n✅ 无JavaScript错误")
+
+    if console_errors:
+        print(f"\n⚠️  Console Errors/Warnings ({len(console_errors)}):")
+        for e in console_errors[:20]:
+            print(f"  - {e}")
+        if len(console_errors) > 20:
+            print(f"  ... 还有{len(console_errors) - 20}条")
+    else:
+        print("✅ Console干净")
+
+    print(f"\n📸 截图保存至: {output_dir}")
+
+    return 0 if not page_errors else 1
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Verify HTML design outputs with Playwright",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    parser.add_argument("html_path", help="HTML file path")
+    parser.add_argument("--viewports", default="1440x900",
+                        help="逗号分隔的viewport列表，格式 WxH（默认 1440x900）")
+    parser.add_argument("--slides", type=int, default=0,
+                        help="幻灯片模式：截取前N张（需要HTML支持ArrowRight翻页）")
+    parser.add_argument("--output", default=None,
+                        help="输出目录（默认HTML所在目录的screenshots/）")
+    parser.add_argument("--show", action="store_true",
+                        help="非headless，打开真实浏览器窗口")
+    parser.add_argument("--wait", type=int, default=2000,
+                        help="打开页面后等待的毫秒数（默认2000）")
+
+    args = parser.parse_args()
+
+    viewports = [parse_viewport(v) for v in args.viewports.split(",")]
+
+    return verify_html(
+        html_path=args.html_path,
+        viewports=viewports,
+        slides=args.slides,
+        output_dir=args.output,
+        show=args.show,
+        wait=args.wait,
+    )
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/src/skills-lib/huashu-design/test-prompts.json

@@ -0,0 +1,38 @@
+[
+  {
+    "id": 1,
+    "prompt": "我想做一个SaaS产品的登录页面，给我3个风格方向对比看看",
+    "expected": "触发clarifying questions问design context/brand；产出3个variation的design_canvas；不用紫渐变/emoji/Inter等AI slop；有具体理由说明每个variation的差异维度",
+    "tests": "workflow问问题 + variations逻辑 + 反AI slop清单 + design_canvas使用"
+  },
+  {
+    "id": 2,
+    "prompt": "帮我做一份10页的产品pitch deck，讲一个AI工具的创业项目",
+    "expected": "用deck_stage.js起手；先口头vocalize设计系统（色彩/字型/layout节奏）等确认；Section divider/content/data/quote多种layout交替；字号≥24px；1-indexed labels",
+    "tests": "Junior Designer先汇报再做 + deck_stage使用 + 视觉节奏 + scale规范"
+  },
+  {
+    "id": 3,
+    "prompt": "做个30秒的HTML动画，讲神经网络怎么工作",
+    "expected": "用animations.jsx的Stage+Sprite；先写时间轴再写组件；入场easeOut出场easeIn；分phase讲故事而不是堆动画；文字停留≥3秒",
+    "tests": "animations工作流 + easing正确 + 节奏设计 + 时长控制"
+  },
+  {
+    "id": 4,
+    "prompt": "做一个 Habit Tracker App 原型",
+    "expected": "问用户要 overview 平铺 or flow demo（默认走 overview）；用 assets/ios_frame.jsx，不手写 Dynamic Island；Tracker 属高密度型，每屏 ≥ 3 处信息密度元素（习惯完成率、连续天数、趋势曲线、成就badge等，非装饰）；至少 5-7 屏并排（首页/新建习惯/详情/统计/设置）",
+    "tests": "overview/flow 形态路由 + ios_frame 硬绑定 + 信息密度分型（高密度型）+ 多屏并排"
+  },
+  {
+    "id": 5,
+    "prompt": "做一个读书笔记 App 原型",
+    "expected": "overview 平铺为主；ios_frame.jsx；读书笔记偏内容展示类，信息密度要求不如 Tracker 极端，但笔记列表页仍需 ≥ 3 层信息（书籍、引文、标签、进度）；至少 4-6 屏（首页书架/笔记详情/标注高亮/搜索/笔记本管理）；字体优先 serif display",
+    "tests": "overview 默认 + ios_frame + 信息层次 + 内容为主的视觉节奏"
+  },
+  {
+    "id": 6,
+    "prompt": "做一个跑步记录 App 原型",
+    "expected": "overview 平铺；ios_frame.jsx；跑步 App 属高密度型（地图、配速曲线、心率区间、每公里分段数据），每屏 ≥ 3 处产品差异化信息；至少 5 屏（今日总览/跑步中实时数据/路线地图/历史记录/月度统计）；避免撞 AI slop（不用紫渐变、不堆装饰 icon，但数据可视化 icon 允许保留）",
+    "tests": "overview + ios_frame + 高密度型数据可视化 + 地图/图表混排 + slop 边界条件"
+  }
+]

package/src/skills-lib/humanizer/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Siqi Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/src/skills-lib/humanizer/README.md

@@ -0,0 +1,145 @@
+# Humanizer
+
+A Claude Code skill that removes signs of AI-generated writing from text, making it sound more natural and human.
+
+## Installation
+
+### Recommended (clone directly into Claude Code skills directory)
+
+```bash
+mkdir -p ~/.claude/skills
+git clone https://github.com/blader/humanizer.git ~/.claude/skills/humanizer
+```
+
+### Manual install/update (only the skill file)
+
+If you already have this repo cloned (or you downloaded `SKILL.md`), copy the skill file into Claude Code’s skills directory:
+
+```bash
+mkdir -p ~/.claude/skills/humanizer
+cp SKILL.md ~/.claude/skills/humanizer/
+```
+
+## Usage
+
+In Claude Code, invoke the skill:
+
+```
+/humanizer
+
+[paste your text here]
+```
+
+Or ask Claude to humanize text directly:
+
+```
+Please humanize this text: [your text]
+```
+
+## Overview
+
+Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guide, maintained by WikiProject AI Cleanup. This comprehensive guide comes from observations of thousands of instances of AI-generated text.
+
+The skill also includes a final "obviously AI generated" audit pass and a second rewrite, to catch lingering AI-isms in the first draft.
+
+### Key Insight from Wikipedia
+
+> "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
+
+## 25 Patterns Detected (with Before/After Examples)
+
+### Content Patterns
+
+| # | Pattern | Before | After |
+|---|---------|--------|-------|
+| 1 | **Significance inflation** | "marking a pivotal moment in the evolution of..." | "was established in 1989 to collect regional statistics" |
+| 2 | **Notability name-dropping** | "cited in NYT, BBC, FT, and The Hindu" | "In a 2024 NYT interview, she argued..." |
+| 3 | **Superficial -ing analyses** | "symbolizing... reflecting... showcasing..." | Remove or expand with actual sources |
+| 4 | **Promotional language** | "nestled within the breathtaking region" | "is a town in the Gonder region" |
+| 5 | **Vague attributions** | "Experts believe it plays a crucial role" | "according to a 2019 survey by..." |
+| 6 | **Formulaic challenges** | "Despite challenges... continues to thrive" | Specific facts about actual challenges |
+
+### Language Patterns
+
+| # | Pattern | Before | After |
+|---|---------|--------|-------|
+| 7 | **AI vocabulary** | "Additionally... testament... landscape... showcasing" | "also... remain common" |
+| 8 | **Copula avoidance** | "serves as... features... boasts" | "is... has" |
+| 9 | **Negative parallelisms** | "It's not just X, it's Y" | State the point directly |
+| 10 | **Rule of three** | "innovation, inspiration, and insights" | Use natural number of items |
+| 11 | **Synonym cycling** | "protagonist... main character... central figure... hero" | "protagonist" (repeat when clearest) |
+| 12 | **False ranges** | "from the Big Bang to dark matter" | List topics directly |
+
+### Style Patterns
+
+| # | Pattern | Before | After |
+|---|---------|--------|-------|
+| 13 | **Em dash overuse** | "institutions—not the people—yet this continues—" | Use commas or periods |
+| 14 | **Boldface overuse** | "**OKRs**, **KPIs**, **BMC**" | "OKRs, KPIs, BMC" |
+| 15 | **Inline-header lists** | "**Performance:** Performance improved" | Convert to prose |
+| 16 | **Title Case Headings** | "Strategic Negotiations And Partnerships" | "Strategic negotiations and partnerships" |
+| 17 | **Emojis** | "🚀 Launch Phase: 💡 Key Insight:" | Remove emojis |
+| 18 | **Curly quotes** | `said “the project”` | `said “the project”` |
+| 25 | **Hyphenated word pairs** | “cross-functional, data-driven, client-facing” | Drop hyphens on common word pairs |
+
+### Communication Patterns
+
+| # | Pattern | Before | After |
+|---|---------|--------|-------|
+| 19 | **Chatbot artifacts** | "I hope this helps! Let me know if..." | Remove entirely |
+| 20 | **Cutoff disclaimers** | "While details are limited in available sources..." | Find sources or remove |
+| 21 | **Sycophantic tone** | "Great question! You're absolutely right!" | Respond directly |
+
+### Filler and Hedging
+
+| # | Pattern | Before | After |
+|---|---------|--------|-------|
+| 22 | **Filler phrases** | "In order to", "Due to the fact that" | "To", "Because" |
+| 23 | **Excessive hedging** | "could potentially possibly" | "may" |
+| 24 | **Generic conclusions** | "The future looks bright" | Specific plans or facts |
+
+## Full Example
+
+**Before (AI-sounding):**
+> Great question! Here is an essay on this topic. I hope this helps!
+>
+> AI-assisted coding serves as an enduring testament to the transformative potential of large language models, marking a pivotal moment in the evolution of software development. In today's rapidly evolving technological landscape, these groundbreaking tools—nestled at the intersection of research and practice—are reshaping how engineers ideate, iterate, and deliver, underscoring their vital role in modern workflows.
+>
+> At its core, the value proposition is clear: streamlining processes, enhancing collaboration, and fostering alignment. It's not just about autocomplete; it's about unlocking creativity at scale, ensuring that organizations can remain agile while delivering seamless, intuitive, and powerful experiences to users. The tool serves as a catalyst. The assistant functions as a partner. The system stands as a foundation for innovation.
+>
+> Industry observers have noted that adoption has accelerated from hobbyist experiments to enterprise-wide rollouts, from solo developers to cross-functional teams. The technology has been featured in The New York Times, Wired, and The Verge. Additionally, the ability to generate documentation, tests, and refactors showcases how AI can contribute to better outcomes, highlighting the intricate interplay between automation and human judgment.
+>
+> - 💡 **Speed:** Code generation is significantly faster, reducing friction and empowering developers.
+> - 🚀 **Quality:** Output quality has been enhanced through improved training, contributing to higher standards.
+> - ✅ **Adoption:** Usage continues to grow, reflecting broader industry trends.
+>
+> While specific details are limited based on available information, it could potentially be argued that these tools might have some positive effect. Despite challenges typical of emerging technologies—including hallucinations, bias, and accountability—the ecosystem continues to thrive. In order to fully realize this potential, teams must align with best practices.
+>
+> In conclusion, the future looks bright. Exciting times lie ahead as we continue this journey toward excellence. Let me know if you’d like me to expand on any section!
+
+**After (Humanized):**
+> AI coding assistants can speed up the boring parts of the job. They're great at boilerplate: config files and the little glue code you don't want to write. They can also help you sketch a test, but you still have to read it.
+>
+> The dangerous part is how confident the suggestions look. I've accepted code that compiled and passed lint, then discovered later it missed the point because I stopped paying attention.
+>
+> If you treat it like autocomplete and review every line, it's useful. If you use it to avoid thinking, it will help you ship bugs faster.
+>
+> The only real backstop is tests. Without them, you're mostly judging vibes.
+
+## References
+
+- [Wikipedia: Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) - Primary source
+- [WikiProject AI Cleanup](https://en.wikipedia.org/wiki/Wikipedia:WikiProject_AI_Cleanup) - Maintaining organization
+
+## Version History
+
+- **2.3.0** - Added pattern #25: hyphenated word pair overuse
+- **2.2.0** - Added a final "obviously AI generated" audit + second-pass rewrite prompts
+- **2.1.1** - Fixed pattern #18 example (curly quotes vs straight quotes)
+- **2.1.0** - Added before/after examples for all 24 patterns
+- **2.0.0** - Complete rewrite based on raw Wikipedia article content
+- **1.0.0** - Initial release
+
+## License
+
+MIT