better-dsh 0.2.5 → 0.3.0-c

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-sketch.md

@@ -1,238 +0,0 @@
----
-title: "Sketch — 一次性 HTML 原型：2-3 个设计方案对比"
-sidebar_label: "Sketch"
-description: "一次性 HTML 原型：2-3 个设计方案对比"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Sketch
-
-一次性 HTML 原型：2-3 个设计方案对比。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 内置（默认安装） |
-| 路径 | `skills/creative/sketch` |
-| 版本 | `1.0.0` |
-| 作者 | Hermes Agent（改编自 gsd-build/get-shit-done） |
-| 许可证 | MIT |
-| 平台 | linux, macos, windows |
-| 标签 | `sketch`, `mockup`, `design`, `ui`, `prototype`, `html`, `variants`, `exploration`, `wireframe`, `comparison` |
-| 相关 skill | [`spike`](/user-guide/skills/bundled/software-development/software-development-spike), [`claude-design`](/user-guide/skills/bundled/creative/creative-claude-design), [`popular-web-designs`](/user-guide/skills/bundled/creative/creative-popular-web-designs), [`excalidraw`](/user-guide/skills/bundled/creative/creative-excalidraw) |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发该 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# Sketch
-
-当用户希望**在确定方向之前先看到设计效果**时使用此 skill——以一次性 HTML 原型的形式探索 UI/UX 想法。目的是生成 2-3 个可交互的方案，让用户并排对比视觉方向，而非产出可交付的代码。
-
-当用户说以下内容时加载此 skill："sketch this screen"、"show me what X could look like"、"compare layout A vs B"、"give me 2-3 takes on this UI"、"let me see some variants"、"mockup this before I build"。
-
-## 不适用场景
-
-- 用户需要生产级组件——使用 `claude-design` 或正式构建
-- 用户需要精良的一次性 HTML 产物（落地页、幻灯片）——使用 `claude-design`
-- 用户需要图表——使用 `excalidraw`、`architecture-diagram`
-- 设计已确定——直接构建即可
-
-## 如果用户安装了完整的 GSD 系统
-
-如果 `gsd-sketch` 作为同级 skill 出现（通过 `npx get-shit-done-cc --hermes` 安装），优先使用 **`gsd-sketch`** 以获得完整工作流：持久化的 `.planning/sketches/` 目录（含 MANIFEST）、前沿模式分析、跨历史草图的一致性审计，以及与 GSD 其余部分的集成。本 skill 是轻量级独立版本——无状态机制的一次性草图。
-
-## 核心方法
-
-```
-intake  →  variants  →  head-to-head  →  pick winner (or iterate)
-```
-
-### 1. Intake（如果用户已提供足够信息则跳过）
-
-在生成方案之前，获取三项信息——每次只问一个问题，不要一次全问：
-
-1. **感觉。** "这个应该给人什么感觉？形容词、情绪、氛围。"——*"calm, editorial, like Linear"* 比 *"minimal"* 更有参考价值。
-2. **参考。** "哪些 app、网站或产品接近你想象中的感觉？"——实际参考比抽象描述更有效。
-3. **核心操作。** "用户在这个页面上最重要的单一操作是什么？"——所有方案都应服务于此；否则只是装饰。
-
-每次回答后简短复述，再问下一个问题。如果用户已一次性提供了全部三项，直接跳到方案生成。
-
-### 2. 方案（2-3 个，不少于 1 个，极少超过 4 个）
-
-一次性生成 **2-3 个方案**。每个方案是一个完整的独立 HTML 文件。不要描述方案——直接构建。目的是对比。
-
-每个方案应采取**不同的设计立场**，而非不同的像素值。三种有效的方案维度：
-
-- **密度：** 紧凑 / 宽松 / 极密（选两个对比极端）
-- **重点：** 内容优先 / 操作优先 / 工具优先
-- **美学：** 编辑风格 / 实用主义 / 趣味性
-- **布局：** 单列 / 侧边栏 / 分屏
-- **基调：** 卡片式 / 纯内容 / 文档风格
-
-选定一个维度并从中拉开差距。两个仅在强调色上不同的方案是无效的——用户无法区分。
-
-**方案命名：** 描述立场，而非编号。
-
-<!-- ascii-guard-ignore -->
-```
-sketches/
-├── 001-calm-editorial/
-│   ├── index.html
-│   └── README.md
-├── 001-utilitarian-dense/
-│   ├── index.html
-│   └── README.md
-└── 001-playful-split/
-    ├── index.html
-    └── README.md
-```
-<!-- ascii-guard-ignore-end -->
-
-### 3. 制作真实的 HTML
-
-每个方案是一个**单一自包含的 HTML 文件**：
-
-- 内联 `<style>`——无需构建步骤，无外部 CSS
-- 系统字体或通过 `<link>` 引入一个 Google Font
-- 通过 CDN 使用 Tailwind（`<script src="https://cdn.tailwindcss.com"></script>`）可以
-- 真实的虚假内容——实际句子、实际姓名，而非"Lorem ipsum"
-- **可交互**：链接可点击，悬停效果真实，至少一个状态转换（展开/收起、筛选、切换）。一个冻结的静态图比一个粗糙但有动效的方案更差。
-
-在浏览器中打开验证。如果看起来有问题，在展示给用户之前修复。
-
-**使用 Hermes 的浏览器工具对方案进行视觉验证。** 不要只写 HTML 然后寄希望于它能正常渲染；加载每个方案并查看：
-
-```
-browser_navigate(url="file:///absolute/path/to/sketches/001-calm-editorial/index.html")
-browser_vision(question="Does this layout look clean and readable? Any visible bugs (overlapping text, unstyled elements, broken images)?")
-```
-
-`browser_vision` 返回页面实际内容的 AI 描述及截图路径——能捕获纯源码检查遗漏的布局问题（例如字体导入静默失败、flex 容器塌陷）。修复后重新导航，直到每个方案看起来正确为止。
-
-**快速启动用的默认 CSS reset + 系统字体栈：**
-
-```html
-<style>
-  * { box-sizing: border-box; margin: 0; padding: 0; }
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
-                 "Helvetica Neue", Arial, sans-serif;
-    -webkit-font-smoothing: antialiased;
-    color: #1a1a1a;
-    background: #fafafa;
-    line-height: 1.5;
-  }
-</style>
-```
-
-### 4. 方案 README
-
-每个方案的 `README.md` 回答以下内容：
-
-```markdown
-## Variant: {stance name}
-
-### Design stance
-One sentence on the principle driving this variant.
-
-### Key choices
-- Layout: ...
-- Typography: ...
-- Color: ...
-- Interaction: ...
-
-### Trade-offs
-- Strong at: ...
-- Weak at: ...
-
-### Best for
-- The kind of user or use case this variant actually serves
-```
-
-### 5. 正面对比
-
-所有方案构建完成后，以对比形式呈现。不要只是罗列——**给出观点**：
-
-```markdown
-## Three takes on the home screen
-
-| Dimension | Calm editorial | Utilitarian dense | Playful split |
-|-----------|----------------|-------------------|---------------|
-| Density   | Low            | High              | Medium        |
-| Primary action visibility | Low | High | Medium |
-| Scan-ability | High | Medium | Low |
-| Feel | Calm, trusted | Sharp, tool-like | Inviting, energetic |
-
-**My take:** Utilitarian dense for power users, calm editorial for content-forward audiences. Playful split is weakest — tries to do both and commits to neither.
-```
-
-让用户选出胜出方案，或将两个方案合并为混合版，或要求新一轮迭代。
-
-## 主题化（当项目有视觉标识时）
-
-如果用户有现有主题（颜色、字体、token），将共享 token 放入 `sketches/themes/tokens.css` 并在每个方案中 `@import`。保持 token 精简：
-
-```css
-/* sketches/themes/tokens.css */
-:root {
-  --color-bg: #fafafa;
-  --color-fg: #1a1a1a;
-  --color-accent: #0066ff;
-  --color-muted: #666;
-  --radius: 8px;
-  --font-display: "Inter", sans-serif;
-  --font-body: -apple-system, BlinkMacSystemFont, sans-serif;
-}
-```
-
-不要对一次性草图过度 token 化——三种颜色加一种字体通常已足够。
-
-## 交互基准
-
-当用户能够完成以下操作时，草图的交互程度即为合格：
-
-1. **点击主要操作**并看到可见的变化（状态变更、模态框、toast、导航模拟）
-2. **看到一个有意义的状态转换**（筛选列表、切换模式、展开/收起面板）
-3. **悬停可识别的交互元素**（按钮、行、标签页）
-
-超过此程度是对一次性草图的过度工程化。低于此程度则只是截图。
-
-## 前沿模式（决定下一步草图内容）
-
-如果草图已存在且用户询问"接下来应该草图什么？"：
-
-- **一致性缺口**——来自不同草图的两个胜出方案做出了独立选择，尚未组合在一起
-- **未草图的页面**——被引用但从未探索过
-- **状态覆盖**——已草图了正常路径，但未覆盖空状态 / 加载中 / 错误 / 千条数据
-- **响应式缺口**——在某一视口下验证过；在移动端 / 超宽屏下是否成立？
-- **交互模式**——静态布局已存在；过渡动效、拖拽、滚动行为尚未探索
-
-提出 2-4 个命名候选项，让用户选择。
-
-## 输出
-
-- 在仓库根目录创建 `sketches/`（如果用户使用 GSD 约定则为 `.planning/sketches/`）
-- 每个方案一个子目录：`NNN-stance-name/index.html` + `README.md`
-- 告知用户如何打开：macOS 上用 `open sketches/001-calm-editorial/index.html`，Linux 上用 `xdg-open`，Windows 上用 `start`
-- 保持方案的一次性特性——如果你觉得有必要保留某个草图，应将其提升为真实项目代码，而非作为资产保管
-
-**单个方案的典型工具调用序列：**
-
-```
-terminal("mkdir -p sketches/001-calm-editorial")
-write_file("sketches/001-calm-editorial/index.html", "<!doctype html>...")
-write_file("sketches/001-calm-editorial/README.md", "## Variant: Calm editorial\n...")
-browser_navigate(url="file://$(pwd)/sketches/001-calm-editorial/index.html")
-browser_vision(question="How does this look? Any obvious layout issues?")
-```
-
-对每个方案重复上述步骤，然后呈现对比表格。
-
-## 致谢
-
-改编自 GSD（Get Shit Done）项目的 `/gsd-sketch` 工作流——MIT © 2025 Lex Christopherson（[gsd-build/get-shit-done](https://github.com/gsd-build/get-shit-done)）。完整 GSD 系统提供持久化草图状态、主题/方案模式参考及一致性审计工作流；通过 `npx get-shit-done-cc --hermes --global` 安装。

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/bundled/creative/creative-songwriting-and-ai-music.md

@@ -1,305 +0,0 @@
----
-title: "Songwriting And Ai Music — 歌词创作与 Suno AI 音乐提示词"
-sidebar_label: "Songwriting And Ai Music"
-description: "歌词创作与 Suno AI 音乐提示词"
----
-
-{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}
-
-# Songwriting And Ai Music
-
-歌词创作与 Suno AI 音乐提示词（prompt）。
-
-## Skill 元数据
-
-| | |
-|---|---|
-| 来源 | 内置（默认安装） |
-| 路径 | `skills/creative/songwriting-and-ai-music` |
-| 平台 | linux, macos, windows |
-
-## 参考：完整 SKILL.md
-
-:::info
-以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
-:::
-
-# 歌词创作与 AI 音乐生成
-
-这里的一切都是**指导原则**，不是规则。艺术本就是为了打破规则。
-用对歌曲有用的，忽略没用的。
-
----
-
-## 1. 歌曲结构（选一种或自创）
-
-常见骨架——可以混用、修改或直接丢弃：
-
-```
-ABABCB  主歌/副歌/主歌/副歌/桥段/副歌    （大多数流行/摇滚）
-AABA    主歌/主歌/桥段/主歌（基于叠句）    （爵士标准曲、抒情曲）
-ABAB    主歌/副歌交替                      （简洁直接）
-AAA     主歌/主歌/主歌（分节歌，无副歌）   （民谣、叙事曲）
-```
-
-六个基本构件：
-- Intro（前奏）    — 营造氛围，吸引听众进入
-- Verse（主歌）    — 故事、细节、世界构建
-- Pre-Chorus（预副歌） — 可选的张力铺垫，在高潮前蓄力
-- Chorus（副歌）   — 情感核心，让人记住的部分
-- Bridge（桥段）   — 转折，视角或调性的转变
-- Outro（尾奏）    — 告别，可以呼应或颠覆前面的内容
-
-你不需要全部用上。有些伟大的歌曲只有一个段落在演变。
-结构服务于情感，而不是反过来。
-
----
-
-## 2. 押韵、韵律与音效
-
-押韵类型（从紧到松）：
-- 完全押韵：lean/mean
-- 同族押韵：crate/braid
-- 元音押韵（Assonance）：had/glass（相同元音，不同结尾）
-- 辅音押韵（Consonance）：scene/when（不同元音，相似结尾）
-- 近似/斜韵（Near/slant）：足以暗示关联，但不锁死
-
-混合使用。全用完全押韵会像儿歌。全用斜韵会显得懒散。两者的融合才是关键。
-
-内部押韵（INTERNAL RHYME）：在一行内部押韵，而不只是行尾。
-  "We pruned the lies from bleeding trees / Distilled the storm
-   from entropy" — "lies/flies"、"trees/entropy" 形成内部回响。
-
-韵律（METER）：重读与非重读音节的节奏。
-- 平行行之间匹配音节数有助于可唱性
-- **重读**音节比总数更重要
-- 大声朗读。如果你绊嘴，韵律需要调整。
-- 刻意打破韵律可以制造强调或惊喜
-
----
-
-## 3. 情感弧线与动态
-
-把一首歌想象成一段旅程，而不是一条平路。
-
-能量映射（粗略参考，非规定）：
-  前奏：2-3  |  主歌：5-6  |  预副歌：7
-  副歌：8-9  |  桥段：不定  |  最终副歌：9-10
-
-最强大的动态技巧：**对比**。
-- 低语之后的嘶吼比一直嘶吼更有冲击力
-- 稀疏之后才有密集。缓慢之后才有急速。低沉之后才有高亢。
-- 爆发只因为有铺垫才有效
-- 沉默也是一种乐器
-
-"低语→咆哮→低语"——从亲密开始，推向全力，再剥离回脆弱。
-适用于抒情曲、史诗曲、颂歌。
-
----
-
-## 4. 写出有效的歌词
-
-**展示，而非陈述**（通常如此）：
-- "我很悲伤" = 平淡
-- "你的帽衫还挂在门边的钩子上" = 有生命力
-- 但有时"我献出我的生命"直白说出来**就是**力量所在
-
-**Hook（钩子）**：
-- 让人记住、哼唱、反复回味的那句话
-- 通常是标题或核心短语
-- 当旋律 + 歌词 + 情感三者对齐时效果最佳
-- 放在最有冲击力的位置（通常是副歌的第一行或最后一行）
-
-**韵律配合（Prosody）**——歌词与音乐相互支撑：
-- 稳定的情感（解脱、平静）配以稳定的旋律、完全押韵、解决和弦
-- 不稳定的情感（渴望、怀疑）配以游移的旋律、近似押韵、未解决和弦
-- 主歌旋律通常较低，副歌走高
-- 但如果对歌曲有利，可以反过来
-
-**避免**（除非你是故意的）：
-- 惯性使用陈词滥调（"黄金之心"，没有赋予它新意）
-- 为了押韵而扭曲词序（"Yoda 式说话"）
-- 每个段落能量相同（动态平淡）
-- 把初稿当作神圣不可改——修改就是创作
-
----
-
-## 5. 戏仿与改编
-
-用新歌词改写现有歌曲时：
-
-**骨架分析**：先绘制原曲结构。
-- 数每行音节数
-- 标注押韵方案（ABAB、AABB 等）
-- 识别哪些音节是**重读**的
-- 注意哪里有延长/持续音
-
-**填入新词**：
-- 将重读音节与原曲相同拍点对齐
-- 总音节数可以在非重读音节上浮动 1-2 个
-- 在长延音处，尽量匹配原曲的**元音音色**
-  （如果原曲延音是"LOOOVE"的"oo"元音，"FOOOD"比"LIFE"更合适）
-- 在关键位置用单音节词替换可保持节奏完整
-  （Crime -> Code，Snake -> Noose）
-- 把新词唱到原曲上——如果你绊嘴，就修改
-
-**概念**：
-- 选一个足够强大、能撑起整首歌的概念
-- 从标题/hook 出发，向外构建
-- 先大量生成原材料（双关语、短语、意象），再把最好的填入结构
-- 如果某处需要特定的一行，从押韵方案反向推导来铺垫它
-
-**保留部分原词**：保留几行原词或原有结构，增加辨识度，让听众感受到与原曲的联系。
-
----
-
-## 6. Suno AI Prompt 工程
-
-### 风格/流派描述字段
-
-公式（按需调整）：
-  流派 + 情绪 + 年代 + 乐器 + 人声风格 + 制作风格 + 动态
-
-```
-差：  "sad rock song"
-好：  "Cinematic orchestral spy thriller, 1960s Cold War era, smoky
-       sultry female vocalist, big band jazz, brass section with
-       trumpets and french horns, sweeping strings, minor key,
-       vintage analog warmth"
-```
-
-**描述旅程**，而不只是流派：
-```
-"Begins as a haunting whisper over sparse piano. Gradually layers
- in muted brass. Builds through the chorus with full orchestra.
- Second verse erupts with raw belting intensity. Outro strips back
- to a lone piano and a fragile whisper fading to silence."
-```
-
-提示：
-- V4.5+ 的 Style 字段支持最多 1,000 个字符——充分利用
-- **不要**使用艺人名字或商标。改为描述声音本身。
-  用"1960s Cold War spy thriller brass"，不用"James Bond style"
-  用"90s grunge"，不用"Nirvana-style"
-- 有偏好时请指定 BPM 和调性
-- 使用 Exclude Styles 字段排除你**不想要**的元素
-- 意想不到的流派组合往往是金矿："bossa nova trap"、
-  "Appalachian gothic"、"chiptune jazz"
-- 构建人声**人设**，而不只是性别：
-  "A weathered torch singer with a smoky alto, slight rasp,
-   who starts vulnerable and builds to devastating power"
-
-### Metatag（元标签，放在歌词字段的 [方括号] 内）
-
-结构：
-  [Intro] [Verse] [Verse 1] [Pre-Chorus] [Chorus]
-  [Post-Chorus] [Hook] [Bridge] [Interlude]
-  [Instrumental] [Instrumental Break] [Guitar Solo]
-  [Breakdown] [Build-up] [Outro] [Silence] [End]
-
-人声表演：
-  [Whispered] [Spoken Word] [Belted] [Falsetto] [Powerful]
-  [Soulful] [Raspy] [Breathy] [Smooth] [Gritty]
-  [Staccato] [Legato] [Vibrato] [Melismatic]
-  [Harmonies] [Choir] [Harmonized Chorus]
-
-动态：
-  [High Energy] [Low Energy] [Building Energy] [Explosive]
-  [Emotional Climax] [Gradual swell] [Orchestral swell]
-  [Quiet arrangement] [Falling tension] [Slow Down]
-
-性别：
-  [Female Vocals] [Male Vocals]
-
-氛围：
-  [Melancholic] [Euphoric] [Nostalgic] [Aggressive]
-  [Dreamy] [Intimate] [Dark Atmosphere]
-
-音效（SFX）：
-  [Vinyl Crackle] [Rain] [Applause] [Static] [Thunder]
-
-在 Style 字段和歌词中**同时**放置标签以强化效果。
-每个段落最多保持 5-8 个标签——太多会让 AI 混乱。
-不要自相矛盾（同一段落内 [Calm] + [Aggressive]）。
-
-### Custom Mode（自定义模式）
-- 正式创作时始终使用 Custom Mode（分离 Style 与 Lyrics）
-- 歌词字段限制：约 3,000 字符（约 40-60 行）
-- 务必添加结构标签——没有标签时 Suno 会默认生成
-  没有情感弧线的平铺主歌/副歌/主歌
-
----
-
-## 7. 为 AI 歌手设计的音韵技巧
-
-AI 歌手不是在阅读——它们是在发音。帮助它们：
-
-**音标拼写**：
-- 按**发音**拼写单词："through" -> "thru"
-- 专有名词失败率最高——提前测试
-- "Nous" -> "Noose"（强制正确发音）
-- 用连字符引导音节："Re-search"、"bio-engineering"
-
-**演唱控制**：
-- 全大写 = 更响亮、更有力
-- 元音延伸："lo-o-o-ove" = 持续/花腔
-- 省略号："I... need... you" = 戏剧性停顿
-- 连字符拉伸："ne-e-ed" = 情感延伸
-
-**始终**：
-- 拼出数字："24/7" -> "twenty four seven"
-- 缩写加空格："AI" -> "A I" 或 "A-I"
-- 先用 30 秒短片测试专有名词/不常见词
-- 一旦生成，发音就固定了——在生成**之前**在歌词中修正
-
----
-
-## 8. 工作流程
-
-1. 先写概念/hook——情感核心是什么？
-2. 如果是改编，先绘制原曲结构（音节、押韵、重音）
-3. 生成原材料——在结构化之前自由头脑风暴
-4. 将歌词填入结构
-5. 大声朗读/演唱——发现绊嘴处，修正韵律
-6. 构建 Suno 风格描述——描绘动态旅程
-7. 在歌词中添加 metatag 以指导表演
-8. 至少生成 3-5 个变体——把它们当作录音 take
-9. 选出最佳版本，用 Extend/Continue 在有潜力的段落上继续构建
-10. 如果意外出现了好东西，保留它
-
-预期：每 3-5 次生成才有 1 个好结果。修改是正常的。
-在延伸时风格可能漂移——延伸时重新声明流派/情绪。
-
----
-
-## 9. 经验总结
-
-- 在 Style 字段中描述动态**弧线**比单纯列举流派重要得多。
-  "低语→咆哮→低语"给了 Suno 一张表演地图。
-- 在戏仿中保留部分原词增加了辨识度和情感分量——
-  听众能感受到原曲的幽灵。
-- 歌曲中的桥段是你可以转化意象的地方。
-  用你主题的隐喻替换原曲的具体指涉，
-  同时保留其情感功能（反思、转变、启示）。
-- 在 hook/标签中用单音节词替换是在改变含义的同时
-  保持节奏最干净的方式。
-- Style 字段中强有力的人声人设描述比任何单个 metatag
-  都能产生更大的差异。
-- 不要对规则过于执着。如果一行打破了韵律但冲击力更强，
-  就保留它。感受才是关键。技艺服务于艺术，而不是反过来。
----
-
-## 10. 本地 / 开源音乐生成
-
-如果想在本地用 GPU 生成音乐而不是使用 Suno，有两个可选 skill
-覆盖此场景（依赖较重，默认不安装）：
-
-- **heartmula** — 从歌词 + 标签生成带人声的完整歌曲
-  （开源 Suno 替代品，需 8-16GB 显存）：
-  `hermes skills install official/creative/heartmula`
-- **audiocraft** — Meta 的 MusicGen（文本转纯音乐）和
-  AudioGen（音效生成）：
-  `hermes skills install official/creative/audiocraft-audio-generation`
-
-本 skill 中的歌词写作与提示词技巧同样适用于 heartmula —
-它的输入格式是带方括号结构标签的歌词，加上逗号分隔的风格标签。