better-dsh 0.2.4 → 0.2.5

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-here-now.md

@@ -0,0 +1,231 @@
+---
+title: "Here.Now — 将静态站点发布到 {slug}"
+sidebar_label: "Here.Now"
+description: "将静态站点发布到 {slug}"
+---
+
+{/* 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. */}
+
+# Here.Now
+
+将静态站点发布到 {slug}.here.now，并将私有文件存储在云端 Drive 中，供 agent 间交接使用。
+
+## Skill 元数据
+
+| | |
+|---|---|
+| 来源 | 可选 — 通过 `hermes skills install official/productivity/here-now` 安装 |
+| 路径 | `optional-skills/productivity/here-now` |
+| 版本 | `1.15.3` |
+| 作者 | here.now |
+| 许可证 | MIT |
+| 平台 | macos, linux |
+| 标签 | `here.now`, `herenow`, `publish`, `deploy`, `hosting`, `static-site`, `web`, `share`, `URL`, `drive`, `storage` |
+
+## 参考：完整 SKILL.md
+
+:::info
+以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 skill 激活时 agent 所看到的指令内容。
+:::
+
+# here.now
+
+here.now 让 agent 能够发布网站并将私有文件存储在云端 Drive 中。
+
+here.now 适用于两类任务：
+
+- **Sites（站点）**：在 `{slug}.here.now` 发布网站和文件。
+- **Drives（驱动器）**：在云端文件夹中存储 agent 私有文件。
+
+## 当前文档
+
+**在回答有关 here.now 功能、特性或工作流的问题之前，请先阅读当前文档：**
+
+→ **https://here.now/docs**
+
+在以下情况下阅读文档：
+
+- 对话中首次出现与 here.now 相关的交互时
+- 用户询问如何操作时
+- 用户询问哪些功能可用、受支持或被推荐时
+- 在告知用户某功能不受支持之前
+
+需要参考当前文档的主题（不能仅依赖本地 skill 文本）：
+
+- Drive 及 Drive 共享
+- 自定义域名
+- 付款与付款门控
+- 分叉（forking）
+- 代理路由（proxy routes）与服务变量
+- 句柄（handles）与链接
+- 限制与配额
+- SPA 路由
+- 错误处理与修复
+- 功能可用性
+
+**如果文档与实时 API 行为不一致，以实时 API 行为为准。**
+
+如果文档获取失败或超时，继续使用本地 skill 和实时 API/脚本输出。对于活跃操作，优先以实时 API 行为为准。
+
+## 依赖要求
+
+- 必需的二进制文件：`curl`、`file`、`jq`
+- 可选环境变量：`$HERENOW_API_KEY`
+- 可选 Drive token 变量：`$HERENOW_DRIVE_TOKEN`
+- 可选凭据文件：`~/.herenow/credentials`
+- Skill 辅助脚本路径：
+  - `${HERMES_SKILL_DIR}/scripts/publish.sh` 用于发布站点
+  - `${HERMES_SKILL_DIR}/scripts/drive.sh` 用于私有 Drive 存储
+
+## 创建站点
+
+```bash
+PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
+bash "$PUBLISH" {file-or-dir} --client hermes
+```
+
+输出实时 URL（例如 `https://bright-canvas-a7k2.here.now/`）。
+
+底层流程分三步：创建/更新 -> 上传文件 -> 最终确认。站点在最终确认成功之前不会上线。
+
+不使用 API key 时，将创建一个 **匿名站点**，24 小时后过期。
+保存 API key 后，站点将永久保留。
+
+**文件结构：** 对于 HTML 站点，请将 `index.html` 放在发布目录的根目录下，而非子目录中。目录内容将成为站点根目录。例如，发布 `my-site/`，其中存在 `my-site/index.html` — 不要发布包含 `my-site/` 的父目录。
+
+也可以发布不含 HTML 的原始文件。单个文件会获得丰富的自动预览器（支持图片、PDF、视频、音频）。多个文件会自动生成带文件夹导航和图片画廊的目录列表。
+
+## 更新已有站点
+
+```bash
+PUBLISH="${HERMES_SKILL_DIR}/scripts/publish.sh"
+bash "$PUBLISH" {file-or-dir} --slug {slug} --client hermes
+```
+
+更新匿名站点时，脚本会自动从 `.herenow/state.json` 加载 `claimToken`。传入 `--claim-token {token}` 可覆盖此值。
+
+已认证的更新需要保存的 API key。
+
+## 使用 Drive
+
+当用户需要为 agent 文件提供私有云存储时，使用 Drive：文档、上下文、记忆、计划、资产、媒体、研究、代码，以及任何需要持久化但不作为网站发布的内容。
+
+每个已登录账户都有一个名为 `My Drive` 的默认 Drive。
+
+```bash
+DRIVE="${HERMES_SKILL_DIR}/scripts/drive.sh"
+bash "$DRIVE" default
+bash "$DRIVE" ls "My Drive"
+bash "$DRIVE" put "My Drive" notes/today.md --from ./notes/today.md
+bash "$DRIVE" cat "My Drive" notes/today.md
+bash "$DRIVE" share "My Drive" --perms write --prefix notes/ --ttl 7d
+```
+
+使用有范围限制的 Drive token 进行 agent 间交接。如果收到 `herenow_drive` 共享块，将其 `token` 作为 `Authorization: Bearer <token>` 用于 `api_base`，存在 `pathPrefix` 时须遵守，写入时保留 ETag。`pathPrefix` 为 `null` 表示完整 Drive 访问权限。如果 skill 可用，优先使用 `drive.sh`；否则直接调用列出的 API 操作。
+
+## API key 存储
+
+发布脚本按以下来源读取 API key（先匹配先用）：
+
+1. `--api-key {key}` 标志（仅用于 CI/脚本场景 — 交互式使用时请避免）
+2. `$HERENOW_API_KEY` 环境变量
+3. `~/.herenow/credentials` 文件（推荐 agent 使用）
+
+要存储 key，将其写入凭据文件：
+
+```bash
+mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
+```
+
+**重要**：收到 API key 后，立即保存 — 自行运行上述命令。不要让用户手动运行。在交互式会话中避免通过 CLI 标志（如 `--api-key`）传递 key；凭据文件是首选存储方式。
+
+切勿将凭据或本地状态文件（`~/.herenow/credentials`、`.herenow/state.json`）提交到源代码控制。
+
+## 获取 API key
+
+从匿名（24 小时）升级为永久站点：
+
+1. 向用户询问其电子邮件地址。
+2. 请求一次性登录码：
+
+```bash
+curl -sS https://here.now/api/auth/agent/request-code \
+  -H "content-type: application/json" \
+  -d '{"email": "user@example.com"}'
+```
+
+3. 告知用户："请查收来自 here.now 的登录码邮件，并将其粘贴到此处。"
+4. 验证登录码并获取 API key：
+
+```bash
+curl -sS https://here.now/api/auth/agent/verify-code \
+  -H "content-type: application/json" \
+  -d '{"email":"user@example.com","code":"ABCD-2345"}'
+```
+
+5. 自行保存返回的 `apiKey`（不要让用户操作）：
+
+```bash
+mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials
+```
+
+## 状态文件
+
+每次站点创建/更新后，脚本会将内容写入工作目录下的 `.herenow/state.json`：
+
+```json
+{
+  "publishes": {
+    "bright-canvas-a7k2": {
+      "siteUrl": "https://bright-canvas-a7k2.here.now/",
+      "claimToken": "abc123",
+      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
+      "expiresAt": "2026-02-18T01:00:00.000Z"
+    }
+  }
+}
+```
+
+在创建或更新站点之前，可以检查此文件以查找之前的 slug。
+将 `.herenow/state.json` 视为内部缓存。
+切勿将此本地文件路径作为 URL 呈现，也不要将其作为认证模式、过期时间或 claim URL 的可信来源。
+
+## 向用户说明的内容
+
+对于已发布的站点：
+
+- 始终分享当前脚本运行输出的 `siteUrl`。
+- 读取并遵循脚本 stderr 中的 `publish_result.*` 行以确定认证模式。
+- 当 `publish_result.auth_mode=authenticated` 时：告知用户站点是**永久的**，已保存到其账户。无需 claim URL。
+- 当 `publish_result.auth_mode=anonymous` 时：告知用户站点将在 **24 小时后过期**。分享 claim URL（如果 `publish_result.claim_url` 非空且以 `https://` 开头），以便用户永久保留。提醒用户 claim token 仅返回一次，无法找回。
+- 切勿让用户查看 `.herenow/state.json` 以获取 claim URL 或认证状态。
+
+对于 Drive：
+
+- 不要将 Drive 文件描述为公开 URL。
+- 告知用户 Drive 内容是私有的，除非通过有范围限制的 token 共享。
+- 与其他 agent 共享访问权限时，优先使用具有窄 `pathPrefix` 和短 TTL 的有范围 token。
+
+## publish.sh 选项
+
+| 标志 | 说明 |
+| ---------------------- | -------------------------------------------- |
+| `--slug {slug}` | 更新已有站点而非创建新站点 |
+| `--claim-token {token}` | 覆盖匿名更新的 claim token |
+| `--title {text}` | 预览器标题（非 HTML 站点） |
+| `--description {text}` | 预览器描述 |
+| `--ttl {seconds}` | 设置过期时间（仅限已认证用户） |
+| `--client {name}` | 用于归因的 agent 名称（如 `hermes`） |
+| `--base-url {url}` | API 基础 URL（默认：`https://here.now`） |
+| `--allow-nonherenow-base-url` | 允许向非默认 `--base-url` 发送认证信息 |
+| `--api-key {key}` | API key 覆盖（优先使用凭据文件） |
+| `--spa` | 启用 SPA 路由（对未知路径返回 index.html） |
+| `--forkable` | 允许他人分叉此站点 |
+
+## publish.sh 之外的功能
+
+Drive 操作请使用 `drive.sh` 或 Drive API。对于更广泛的账户和站点管理 — 删除、元数据、密码、付款、域名、句柄、链接、变量、代理路由、分叉、复制等 — 请参阅当前文档：
+
+→ **https://here.now/docs**
+
+完整文档：https://here.now/docs

package/docs/80_upstream-docs-and-skills/hermes-dev-skill/src/i18n/zh-Hans/user-guide/skills/optional/productivity/productivity-memento-flashcards.md

@@ -0,0 +1,336 @@
+---
+title: "Memento Flashcards — 间隔重复闪卡系统"
+sidebar_label: "Memento Flashcards"
+description: "间隔重复闪卡系统"
+---
+
+{/* 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. */}
+
+# Memento Flashcards
+
+间隔重复（Spaced-repetition）闪卡系统。可从事实或文本创建卡片，通过自由文本回答与闪卡对话并由 agent 评分，从 YouTube 字幕生成测验，以自适应调度复习到期卡片，以及以 CSV 格式导出/导入卡组。
+
+## Skill 元数据
+
+| | |
+|---|---|
+| 来源 | 可选 — 使用 `hermes skills install official/productivity/memento-flashcards` 安装 |
+| 路径 | `optional-skills/productivity/memento-flashcards` |
+| 版本 | `1.0.0` |
+| 作者 | Memento AI |
+| 许可证 | MIT |
+| 平台 | macos, linux |
+| 标签 | `Education`, `Flashcards`, `Spaced Repetition`, `Learning`, `Quiz`, `YouTube` |
+
+## 参考：完整 SKILL.md
+
+:::info
+以下是 Hermes 在触发此 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。
+:::
+
+# Memento Flashcards — 间隔重复闪卡 Skill
+
+## 概述
+
+Memento 为你提供一个本地、基于文件的闪卡系统，具备间隔重复调度功能。
+用户可以通过自由文本回答与闪卡互动，由 agent 在安排下次复习前对回答进行评分。
+在以下情况下使用此 skill：
+
+- **记住一个事实** — 将任意陈述转化为问答闪卡
+- **间隔重复学习** — 以自适应间隔和 agent 评分的自由文本回答复习到期卡片
+- **从 YouTube 视频生成测验** — 获取字幕并生成 5 道测验题
+- **管理卡组** — 将卡片整理成集合，导出/导入 CSV
+
+所有卡片数据存储在单个 JSON 文件中。无需外部 API 密钥 — 由你（agent）直接生成闪卡内容和测验题。
+
+Memento Flashcards 的用户响应风格：
+- 仅使用纯文本。回复用户时不使用 Markdown 格式。
+- 复习和测验反馈保持简短、中立。避免额外的称赞、鼓励或冗长解释。
+
+## 使用时机
+
+在用户希望执行以下操作时使用此 skill：
+- 将事实保存为闪卡以供后续复习
+- 以间隔重复方式复习到期卡片
+- 从 YouTube 视频字幕生成测验
+- 导入、导出、查看或删除闪卡数据
+
+不要将此 skill 用于通用问答、编程帮助或非记忆类任务。
+
+## 快速参考
+
+| 用户意图 | 操作 |
+|---|---|
+| "记住 X" / "将此保存为闪卡" | 生成问答卡片，调用 `memento_cards.py add` |
+| 发送事实但未提及闪卡 | 询问"要将此保存为 Memento 闪卡吗？" — 仅在确认后创建 |
+| "创建一张闪卡" | 询问问题、答案、集合；调用 `memento_cards.py add` |
+| "复习我的卡片" | 调用 `memento_cards.py due`，逐张呈现卡片 |
+| "用 [YouTube URL] 测验我" | 调用 `youtube_quiz.py fetch VIDEO_ID`，生成 5 道题，调用 `memento_cards.py add-quiz` |
+| "导出我的卡片" | 调用 `memento_cards.py export --output PATH` |
+| "从 CSV 导入卡片" | 调用 `memento_cards.py import --file PATH --collection NAME` |
+| "显示我的统计" | 调用 `memento_cards.py stats` |
+| "删除一张卡片" | 调用 `memento_cards.py delete --id ID` |
+| "删除一个集合" | 调用 `memento_cards.py delete-collection --collection NAME` |
+
+## 卡片存储
+
+卡片存储在以下路径的 JSON 文件中：
+
+```
+~/.hermes/skills/productivity/memento-flashcards/data/cards.json
+```
+
+**切勿直接编辑此文件。** 始终使用 `memento_cards.py` 子命令。该脚本通过原子写入（先写入临时文件，再重命名）来防止数据损坏。
+
+该文件在首次使用时自动创建。
+
+## 操作流程
+
+### 从事实创建卡片
+
+### 激活规则
+
+并非每个事实陈述都应成为闪卡。使用以下三级检查：
+
+1. **明确意图** — 用户提到"memento"、"flashcard"、"记住这个"、"保存这张卡片"、"添加一张卡片"或类似明确请求闪卡的措辞 → **直接创建卡片**，无需确认。
+2. **隐含意图** — 用户发送事实陈述但未提及闪卡（例如"光速是 299,792 km/s"）→ **先询问**："要将此保存为 Memento 闪卡吗？"仅在用户确认后创建卡片。
+3. **无意图** — 消息是编程任务、问题、指令、普通对话，或明显不是需要记忆的事实 → **完全不激活此 skill**。让其他 skill 或默认行为处理。
+
+当激活被确认（第 1 级直接确认，第 2 级经用户确认后），生成闪卡：
+
+**第 1 步：** 将陈述转化为问答对。内部使用以下格式：
+
+```
+Turn the factual statement into a front-back pair.
+Return exactly two lines:
+Q: <question text>
+A: <answer text>
+
+Statement: "{statement}"
+```
+
+规则：
+- 问题应测试对关键事实的回忆
+- 答案应简洁直接
+
+**第 2 步：** 调用脚本存储卡片：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py add \
+  --question "What year did World War 2 end?" \
+  --answer "1945" \
+  --collection "History"
+```
+
+如果用户未指定集合，使用 `"General"` 作为默认值。
+
+脚本输出 JSON 确认已创建的卡片。
+
+### 手动创建卡片
+
+当用户明确要求创建闪卡时，询问：
+1. 问题（卡片正面）
+2. 答案（卡片背面）
+3. 集合名称（可选 — 默认为 `"General"`）
+
+然后如上所示调用 `memento_cards.py add`。
+
+### 复习到期卡片
+
+当用户想要复习时，获取所有到期卡片：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py due
+```
+
+返回 `next_review_at <= now` 的卡片 JSON 数组。如需集合过滤：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py due --collection "History"
+```
+
+**复习流程（自由文本评分）：**
+
+以下是你必须遵循的确切交互模式示例。用户回答后，你评分，告知正确答案，然后对卡片评级。
+
+**交互示例：**
+
+> **Agent：** 柏林墙是哪年倒塌的？
+>
+> **用户：** 1991
+>
+> **Agent：** 不太对。柏林墙倒塌于 1989 年。下次复习是明天。
+> *（agent 调用：memento_cards.py rate --id ABC --rating hard --user-answer "1991"）*
+>
+> 下一题：第一个登上月球的人是谁？
+
+**规则：**
+
+1. 只显示问题。等待用户回答。
+2. 收到回答后，将其与预期答案对比并评分：
+   - **correct（正确）** → 用户答对了关键事实（即使措辞不同）
+   - **partial（部分正确）** → 方向正确但缺少核心细节
+   - **incorrect（错误）** → 答错或偏题
+3. **你必须告知用户正确答案及其表现。** 保持简短、纯文本。使用以下格式：
+   - correct：「正确。答案：&#123;answer&#125;。下次复习在 7 天后。」
+   - partial：「接近了。答案：&#123;answer&#125;。&#123;缺少的内容&#125;。下次复习在 3 天后。」
+   - incorrect：「不太对。答案：&#123;answer&#125;。下次复习是明天。」
+4. 然后调用评级命令：correct→easy，partial→good，incorrect→hard。
+5. 然后显示下一题。
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py rate \
+  --id CARD_ID --rating easy --user-answer "what the user said"
+```
+
+**绝不跳过第 3 步。** 用户必须在进入下一题前始终看到正确答案和反馈。
+
+如果没有到期卡片，告知用户："现在没有到期的复习卡片。稍后再来查看！"
+
+**退休覆盖：** 用户随时可以说"退休这张卡片"以将其永久从复习中移除。为此使用 `--rating retire`。
+
+### 间隔重复算法
+
+评级决定下次复习间隔：
+
+| 评级 | 间隔 | ease_streak | 状态变化 |
+|---|---|---|---|
+| **hard** | +1 天 | 重置为 0 | 保持 learning |
+| **good** | +3 天 | 重置为 0 | 保持 learning |
+| **easy** | +7 天 | +1 | 若 ease_streak >= 3 → retired |
+| **retire** | 永久 | 重置为 0 | → retired |
+
+- **learning**：卡片在活跃轮换中
+- **retired**：卡片不再出现在复习中（用户已掌握或手动退休）
+- 连续三次"easy"评级自动退休卡片
+
+### YouTube 测验生成
+
+当用户发送 YouTube URL 并想要测验时：
+
+**第 1 步：** 从 URL 中提取视频 ID（例如从 `https://www.youtube.com/watch?v=dQw4w9WgXcQ` 中提取 `dQw4w9WgXcQ`）。
+
+**第 2 步：** 获取字幕：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/youtube_quiz.py fetch VIDEO_ID
+```
+
+返回 `{"title": "...", "transcript": "..."}` 或错误信息。
+
+如果脚本报告 `missing_dependency`，告知用户安装：
+```bash
+pip install youtube-transcript-api
+```
+
+**第 3 步：** 从字幕生成 5 道测验题。使用以下规则：
+
+```
+You are creating a 5-question quiz for a podcast episode.
+Return ONLY a JSON array with exactly 5 objects.
+Each object must contain keys 'question' and 'answer'.
+
+Selection criteria:
+- Prioritize important, surprising, or foundational facts.
+- Skip filler, obvious details, and facts that require heavy context.
+- Never return true/false questions.
+- Never ask only for a date.
+
+Question rules:
+- Each question must test exactly one discrete fact.
+- Use clear, unambiguous wording.
+- Prefer What, Who, How many, Which.
+- Avoid open-ended Describe or Explain prompts.
+
+Answer rules:
+- Each answer must be under 240 characters.
+- Lead with the answer itself, not preamble.
+- Add only minimal clarifying detail if needed.
+```
+
+使用字幕的前 15,000 个字符作为上下文。由你自己（作为 LLM）生成问题。
+
+**第 4 步：** 验证输出是否为有效 JSON，且恰好包含 5 个条目，每个条目具有非空的 `question` 和 `answer` 字符串。如果验证失败，重试一次。
+
+**第 5 步：** 存储测验卡片：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py add-quiz \
+  --video-id "VIDEO_ID" \
+  --questions '[{"question":"...","answer":"..."},...]' \
+  --collection "Quiz - Episode Title"
+```
+
+脚本通过 `video_id` 去重 — 如果该视频的卡片已存在，则跳过创建并报告现有卡片。
+
+**第 6 步：** 使用相同的自由文本评分流程逐题呈现：
+1. 显示"第 1/5 题：..."并等待用户回答。切勿包含答案或任何关于揭示答案的提示。
+2. 等待用户用自己的话回答
+3. 使用评分 prompt（见"复习到期卡片"部分）对回答评分
+4. **重要：你必须先回复用户反馈，再做任何其他操作。** 显示评级、正确答案以及卡片下次到期时间。不要静默跳到下一题。保持简短、纯文本。示例："不太对。答案：&#123;answer&#125;。下次复习是明天。"
+5. **显示反馈后**，调用评级命令，然后在同一消息中显示下一题：
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py rate \
+  --id CARD_ID --rating easy --user-answer "what the user said"
+```
+6. 重复。每个回答在进入下一题前必须收到可见反馈。
+
+### 导出/导入 CSV
+
+**导出：**
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py export \
+  --output ~/flashcards.csv
+```
+
+生成 3 列 CSV：`question,answer,collection`（无标题行）。
+
+**导入：**
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py import \
+  --file ~/flashcards.csv \
+  --collection "Imported"
+```
+
+读取包含以下列的 CSV：question、answer，以及可选的 collection（第 3 列）。如果缺少 collection 列，使用 `--collection` 参数值。
+
+### 统计
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py stats
+```
+
+返回包含以下字段的 JSON：
+- `total`：卡片总数
+- `learning`：活跃轮换中的卡片
+- `retired`：已掌握的卡片
+- `due_now`：当前到期待复习的卡片
+- `collections`：按集合名称的细分统计
+
+## 注意事项
+
+- **切勿直接编辑 `cards.json`** — 始终使用脚本子命令以避免数据损坏
+- **字幕获取失败** — 部分 YouTube 视频没有英文字幕或字幕已禁用；告知用户并建议换一个视频
+- **可选依赖** — `youtube_quiz.py` 需要 `youtube-transcript-api`；如果缺失，告知用户运行 `pip install youtube-transcript-api`
+- **大量导入** — 包含数千行的 CSV 导入可正常工作，但 JSON 输出可能较冗长；为用户总结结果
+- **视频 ID 提取** — 同时支持 `youtube.com/watch?v=ID` 和 `youtu.be/ID` 两种 URL 格式
+
+## 验证
+
+直接验证辅助脚本：
+
+```bash
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py stats
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py add --question "Capital of France?" --answer "Paris" --collection "General"
+python3 ~/.hermes/skills/productivity/memento-flashcards/scripts/memento_cards.py due
+```
+
+如果从仓库检出进行测试，运行：
+
+```bash
+pytest tests/skills/test_memento_cards.py tests/skills/test_youtube_quiz.py -q
+```
+
+Agent 级别验证：
+- 开始一次复习，确认反馈为纯文本、简短，且在进入下一张卡片前始终包含正确答案
+- 运行 YouTube 测验流程，确认每个回答在进入下一题前收到可见反馈