Opencode-Howto: Skill for OpenCode

Lesson Quiz

这是一个针对单个 OpenCode lesson 的完整互动测验 skill，用于检查用户对某一课的理解程度。

Instructions

Step 1: 确认 lesson

如果用户提供了参数，就映射到 lesson 目录：

• 01 / slash-commands / commands → 01-slash-commands
• 02 / memory → 02-memory
• 03 / skills → 03-skills
• 04 / subagents / agents → 04-subagents
• 05 / mcp → 05-mcp
• 06 / hooks → 06-hooks
• 07 / plugins → 07-plugins
• 08 / checkpoints → 08-checkpoints
• 09 / advanced-features / advanced → 09-advanced-features
• 10 / cli → 10-cli

如果用户没提供参数，使用 AskUserQuestion 分 2-3 轮让用户选择 lesson。

---

Step 2: 读取 lesson 与题库

先读取：

• <lesson-directory>/README.md
• references/question-bank.md

优先使用题库中该 lesson 的预置题。
如果题库不足 8 题，可根据 lesson README 补充生成，但必须保持与 lesson 内容一致。

---

Step 3: 询问测验时机

用 AskUserQuestion 询问用户当前是在：

1. Before (pre-test)
2. During (progress check)
3. After (mastery check)

不同 timing 会影响结果解读。

---

Step 4: 出题

• 每次固定 8 题
• 每轮 2 题，共 4 轮
• 混合概念题和实践题
• 每题使用 AskUserQuestion，提供 3-4 个选项

每题必须包含这些信息：

• category
• question
• options
• correct
• explanation
• review

记录用户答案，最后统一评分。

---

Step 5: 评分与结果输出

每题答对记 1 分，总分 8 分。

等级：

• 8：Mastered
• 6-7：Proficient
• 4-5：Developing
• 2-3：Beginning
• 0-1：Not yet

输出格式必须包含：

## Lesson Quiz Results: [Lesson Name]

**Score: N/8** — [Grade]
**Quiz timing**: [Before / During / After]
**Question breakdown**: N conceptual correct, N practical correct

### Per-Question Results
| # | Category | Question (short) | Your Answer | Result |

### Incorrect Answers — Review These
**Q[N]: [Question]**
- Your answer:
- Correct answer:
- Explanation:
- Review:

### Timing-specific message
[根据 pre-test / progress check / mastery check 给不同反馈]

### Recommended Next Steps
- [继续下一课 / 回看哪一节 / 重测 / 深入解释]

---

Step 6: 根据 timing 解释结果

If pre-test

• 把成绩解释为“学习前基线”
• 强调用户接下来应重点关注哪些主题

If during

• 把成绩解释为“阶段性进度检查”
• 明确哪些点已经掌握、哪些点要补

If after

• 把成绩解释为“lesson mastery check”
• 如果分数高，建议进入下一课
• 如果分数一般，列出明确回看点