name: tutorial description: 交互式新用户入门指南。通过实践学习 —— 每一步都会在您的知识库中创建真实内容。三条路径（研究者、管理者、个人）具有通用的学习弧线。触发于 “/tutorial”, “walk me through”, “how do I use this”。 user-invocable: true allowed-tools: Read, Write, Edit, Grep, Glob, AskUserQuestion, Bash context: fork model: opus version: “1.0” generated_from: “arscontexta-v1.6”
运行时配置（第0步 — 在任何处理之前）
阅读这些文件以配置特定领域的操作：
-
ops/derivation-manifest.md— 词汇映射，平台提示- 使用
vocabulary.notes表示笔记文件夹名称 - 使用
vocabulary.note/vocabulary.note_plural表示笔记类型引用 - 使用
vocabulary.reduce表示提取动词 - 使用
vocabulary.reflect表示连接查找动词 - 使用
vocabulary.topic_map表示MOC引用 - 使用
vocabulary.inbox表示收件箱文件夹名称
- 使用
-
ops/config.yaml— 处理深度，领域上下文
如果这些文件不存在，请使用通用默认值。
立即执行
目标：$ARGUMENTS
- 如果
ops/tutorial-state.yaml存在且current_step<= 5：从保存的步骤中恢复 - 如果目标是 “reset”：删除
ops/tutorial-state.yaml并重新开始 - 如果没有状态文件：选择路径后开始新的教程
现在开始。 以下参考定义了流程。
恢复检测
读取 ops/tutorial-state.yaml。如果它存在并且教程不完整，显示：
--=={ ars contexta : tutorial }==--
欢迎回来。
路径：[track] [step-progress] 第 [N] 步，共 5 步
从您离开的地方继续...
跳到保存的 current_step。不要重新询问路径。如果 current_step > 5，教程已完成 —— 提供重置选项。
进度指示器格式：
- 第 1 步，共 5 步：
[=> ] - 第 2 步，共 5 步：
[==> ] - 第 3 步，共 5 步：
[===> ] - 第 4 步，共 5 步：
[====> ] - 第 5 步，共 5 步：
[=====>]
路径选择（仅限新教程）
显示标题，然后使用 AskUserQuestion：
--=={ ars contexta : tutorial }==--
您最适合哪条路径？
(a) 研究者 —— 学术论文，领域
研究，文献处理
(b) 管理者 —— 会议记录，战略文件，
决策跟踪
(c) 个人 —— 日常观察，目标
设定，反思性日志
等待响应。将 a/b/c 映射到 researcher/manager/personal。
将初始状态写入 ops/tutorial-state.yaml：
track: [researcher|manager|personal]
current_step: 1
completed_steps: []
started: [ISO 8601 UTC]
last_activity: [ISO 8601 UTC]
步骤执行模式
每一步都遵循 WHY / DO / SEE。在每一步之前显示进度条。每一步之后，更新 ops/tutorial-state.yaml（添加到 completed_steps，增加 current_step，更新 last_activity）。
路径适应参考
每一步都根据路径调整其语言和示例。结构相同；内容不同。
| 步骤 | 研究者 | 管理者 | 个人 |
|---|---|---|---|
| 捕获 | 来自论文的主张 | 来自会议的决策 | 一天的领悟 |
| 发现 | 论文间的连接 | 决策-利益相关者链接 | 观察-目标模式 |
| 处理 | 论文提取 | 会议记录挖掘 | 日志结晶 |
| 维护 | 陈旧的主张，破损的引用 | 孤立的决策 | 断开的反思 |
| 反思 | 研究图谱增长 | 机构记忆 | 自我知识模式 |
第 1 步：捕获 —— 创建您的第一个 {vocabulary.note}
WHY：
--=={ ars contexta : tutorial }==--
[=> ] 第 1 步 —— 捕获
一切都始于一个值得保留的想法。
根据路径调整哲学：
| 路径 | WHY 框架 |
|---|---|
| 研究者 | “研究始于您注意到值得记忆的事物。论文中的一个主张，跨研究的模式，未被提出的问题。系统将这些捕获为散文句标题 —— 每个标题都是一个命题，当链接到其他笔记时自然阅读。” |
| 管理者 | “好的决策始于捕获的观察。会议中的一个模式，利益相关者的关切，战略洞察。系统将这些转化为连接的笔记，其中每个标题都是一个完整的思想 —— 不是像 ‘Q3 计划’ 这样的标签，而是一个主张，如 ‘Q3 速度取决于减少上下文切换’。” |
| 个人 | “成长始于注意。散步时的一个领悟，一周中的模式，关于重要事物的问题。系统将这些作为散文句笔记捕获 —— 每个标题都是您真正相信的东西，如 ‘早晨的例行公事之所以有效，是因为它们减少了决策疲劳’。” |
DO：
使用 AskUserQuestion 和路径适应的提示：
| 路径 | 提示 |
|---|---|
| 研究者 | “分享一个来自您研究的主张、观察或问题。一句话 —— 一些您真正想要记住并在此基础上构建的东西。” |
| 管理者 | “分享一个来自您工作的决策、模式或洞察。一句话 —— 一些值得在会议和项目中跟踪的东西。” |
| 个人 | “分享一个想法、观察或领悟。一句话 —— 一些您真正想要记住的东西。” |
将输入转换为真实的 {vocabulary.note}：
- 将输入转换为散文标题文件名（小写，安全字符，完整句子）
- 创建 YAML 前置内容：
--- description: [在标题之外添加上下文 —— 范围、机制或影响] topics: ["[[index]]"] created: [今天的日期] --- - 编写 2-3 句话发展这个想法
- 添加主题页脚链接到中心 {vocabulary.topic_map}
- 将文件写入
{vocabulary.notes}/
SEE：
创建了笔记：
{vocabulary.notes}/[filename].md
标题：[散文标题]
描述：[描述]
主题：[[index]]
注意标题如何作为散文工作：
"由于 [[您的笔记标题]]，问题
变成了..."
这就是使笔记可链接的原因。标题
即是思想，表达为句子。
更新状态，然后继续第 2 步。
第 2 步：发现 —— 寻找连接
WHY：
--=={ ars contexta : tutorial }==--
[==> ] 第 2 步 —— 发现
一个笔记是一个文件。连接的笔记成为知识图谱。
根据路径调整：
| 路径 | WHY 框架 |
|---|---|
| 研究者 | “研究在主张连接时复合。关于方法论的一个发现可能会扩展关于工具的一个发现。一个研究中的模式可能与另一个研究中的模式相矛盾。这些连接是洞察力所在 —— 不在单个论文中，而在思想之间的关系中。” |
| 管理者 | “当决策连接时，组织知识复合。一个招聘决策与一个容量问题相关。一个战略转变影响多个项目。连接揭示了个体选择背后的系统。” |
| 个人 | “当观察连接时，自我知识复合。早晨例行公事的洞察可能会连接到能量模式。关系观察可能会扩展沟通领悟。连接揭示了您实际相信的东西。” |
DO：
使用 AskUserQuestion 和路径适应的提示：
| 路径 | 提示 |
|---|---|
| 研究者 | “分享第二个研究洞察 —— 最好是与您的第一个笔记连接的，但任何真正的主张都可以。” |
| 管理者 | “分享另一个工作观察 —— 最好是与第一个相关的，但任何真正的洞察都可以。” |
| 个人 | “分享另一个想法 —— 最好是与第一个连接的，但任何真正的观察都可以。” |
创建第二个 {vocabulary.note}。然后搜索与第一个 {vocabulary.note} 的连接：
- 阅读两个 {vocabulary.note_plural}
- 应用表达测试：您能完成 “[[笔记 A]] 连接到 [[笔记 B]] 因为 [具体原因]” 吗？
- 如果存在真正的连接：
- 在一个或两个 {vocabulary.note_plural} 中添加内联维基链接
- 添加相关笔记条目和上下文短语
- 如果没有真正的连接存在：
- 解释强迫连接比没有更糟
- “这些笔记尚未连接，这没关系。随着图谱的增长，真正的连接将出现。”
SEE：
如果连接：
创建并连接笔记：
{vocabulary.notes}/[filename].md
连接：
[[笔记 A]] 连接到 [[笔记 B]]
因为 [您表达的原因]
这就是 /reflect 在规模上做的事情 ——
在整个图谱中找到真正的连接。
如果没有连接：
创建了笔记：
{vocabulary.notes}/[filename].md
与您的第一个笔记没有真正的连接。
这没关系 —— 强迫连接会污染
图谱。随着您的
图谱增长，真正的连接将出现。
更新状态，然后继续第 3 步。
第 3 步：处理 —— 提取结构化知识
WHY：
--=={ ars contexta : tutorial }==--
[===> ] 第 3 步 —— 处理
原材料通过提取变成结构化知识。
您挖掘的是原子洞察，而不是摘要。
根据路径调整：
| 路径 | WHY 框架 |
|---|---|
| 研究者 | “论文包含许多主张，但只有一些对您的研究重要。提取意味着识别值得保留的命题 —— 特定的主张，方法论选择，令人惊讶的发现 —— 并将每个转化为自己的笔记。这是 /{reduce} 的行动。” |
| 管理者 | “会议记录和战略文件中埋藏着洞察。提取意味着找到决策，假设，风险因素 —— 并给每个一个可以跟踪和连接的笔记。这是 /{reduce} 的行动。” |
| 个人 | “日志条目和日常笔记包含未处理的观察。提取意味着找到洞察，模式，真正的领悟 —— 并将每个结晶为一个与其他所有内容复合的笔记。这是 /{reduce} 的行动。” |
DO：
使用 AskUserQuestion 和路径适应的提示：
| 路径 | 提示 |
|---|---|
| 研究者 | “粘贴一段原始材料 —— 论文笔记，文章片段或研究观察。两到五句话就足够了。” |
| 管理者 | “粘贴一段原始材料 —— 会议记录，战略片段或项目观察。两到五句话就足够了。” |
| 个人 | “粘贴一段原始材料 —— 日志条目，对话笔记或日常观察。两到五句话就足够了。” |
提取 1-2 个原子洞察：
- 识别值得保留的命题（不是摘要，不是后勤）
- 应用选择性：跳过纯粹的对话内容，临时后勤，模糊的观察
- 检查与现有教程 {vocabulary.note_plural} 的连接
- 使用适当的模式创建 {vocabulary.note}(s)
- 链接真正的连接存在的地方
SEE：
从您的材料中提取了 [N] 个洞察：
1. [提取笔记的标题]
[连接状态：链接到 [[笔记]] | 独立]
原材料 -> 原子 {vocabulary.note_plural} -> 连接图谱。
这就是 /{reduce} 所做的。它找到了
值得保留的命题，并将每个转化为
可组合的 {vocabulary.note}。
如果没有值得提取的内容：
在这些材料中没有发现原子洞察。
这种情况会发生 —— 不是一切都包含
可提取的命题。选择性
门正在工作：跳过比
创建低价值 {vocabulary.note_plural} 更好。
更新状态，然后继续第 4 步。
第 4 步：维护 —— 检查知识库健康
WHY：
--=={ ars contexta : tutorial }==--
[====> ] 第 4 步 —— 维护
不维护的知识系统会衰败。健康检查在问题复合之前捕捉问题。
根据路径调整：
| 路径 | WHY 框架 |
|---|---|
| 研究者 | “当引用断裂，主张过时，笔记失去连接时，研究图谱会衰败。健康检查在它们破坏您的研究完整性之前捕捉孤立的主张，缺少描述和破损的链接。” |
| 管理者 | “当决策孤立，链接断裂，笔记失去上下文时，组织知识会衰败。健康检查在它们破坏机构记忆之前捕捉这些问题。” |
| 个人 | “当反思断开连接，描述模糊，模式未被发现时，个人知识会衰败。健康检查在洞察力丢失之前捕捉这些问题。” |
DO：
没有 AskUserQuestion。对教程 {vocabulary.note_plural} 运行自动化小型健康检查：
- 描述检查： 每个 {vocabulary.note} 是否都有描述字段？描述是否提供了超出标题的信息？
- 链接检查： 所有维基链接是否解析为现有文件？
- {vocabulary.topic_map} 检查： 每个 {vocabulary.note} 是否至少出现在一个 {vocabulary.topic_map} 的主题页脚中？
- 孤儿检查： 任何 {vocabulary.note} 是否有零个传入链接？
- 连接密度： 每个 {vocabulary.note} 有多少个维基链接？
对于每个检查，报告 PASS 或 WARN 并提供具体信息。
SEE：
对您的 [N] 个教程 {vocabulary.note_plural} 进行健康检查：
| 检查 | 状态 | 详细信息 |
|--------------------|--------|---------------------|
| 描述 | PASS | 所有笔记都有描述 |
| 链接 | PASS | 没有破损的链接 |
| {vocabulary.topic_map} 成员资格 | WARN | [笔记] 不在 MOC |
| 孤儿风险 | PASS | 所有笔记都连接 |
| 连接密度 | PASS | 平均 [N] 个链接/笔记 |
这就是 /health 在规模上做的事情。它自动捕捉
问题，以便图谱在增长时保持
健康。
如果发现警告，自动修复它们（添加缺失的 {vocabulary.topic_map} 链接，改进描述）并解释修复了什么。
更新状态，然后继续第 5 步。
第 5 步：反思 —— 回顾您所构建的
WHY：
--=={ ars contexta : tutorial }==--
[=====>] 第 5 步 —— 反思
退后一步，看看您开始构建的系统。
几个笔记是一个开始。问题是接下来是什么。
根据路径调整：
| 路径 | WHY 框架 |
|---|---|
| 研究者 | “您有了一个研究图谱的开始。您处理的每篇论文，提取的每个主张，找到的每个连接都使图谱更有价值。复合效应意味着第 100 个笔记比第 1 个笔记更有价值，因为它有 99 个潜在连接。” |
| 管理者 | “您有了一个组织记忆的开始。您处理的每次会议，跟踪的每个决策，找到的每个连接都使系统更有价值。机构知识不再仅存在于人们的头脑中，而是开始存在于图谱中。” |
| 个人 | “您有了一个自我知识系统的开始。您捕获的每个观察，命名的每个模式，找到的每个连接都使系统更有价值。您开始通过累积的证据看到自己，而不仅仅是今天的感觉。” |
DO：
显示知识库状态摘要：
您构建的内容：
{vocabulary.note_plural}: [N]
连接：[M] 维基链接
{vocabulary.topic_map_plural}: 链接到 [[index]]
您目前的图谱：
[[笔记 1]] ----> [[笔记 2]]
\ |
'-> [[笔记 3]] -'
（显示实际连接的教程 {vocabulary.note_plural} 之间的简单 ASCII 图。）
然后显示方法论意识：
您的系统还了解它自己：
ops/methodology/ 您的系统的自我知识
/ask [问题] 询问您的
系统设计背后的研究
试试：/ask "为什么系统使用 [相关功能]？"
然后使用 AskUserQuestion：
"您接下来想做什么？您可以：
(a) 捕获更多想法（告诉我） (b) 处理原始材料（/{reduce} [粘贴或文件]） © 探索您的系统（/next） (d) 了解更多关于特定命令的信息（/help [命令]）"
这是移交给生产性使用的开始。不要处理响应 —— 只需确认他们的选择并指向正确的方向。
SEE：
--=={ ars contexta : tutorial }==--
[======] 完成
您在五步中构建了一个工作知识图谱。从这里开始，每个 {vocabulary.note} 都会增加已有内容的价值。
快速参考：
/ask [问题] 查询您的图谱
/learn [主题] 研究和增长
/{reduce} [源] 提取洞察
/{reflect} 找到连接
/health 检查系统健康
/next 接下来做什么
/help 完整的命令指南
完成
第 5 步之后，写入最终状态：
track: [track]
current_step: 6
completed_steps: [1, 2, 3, 4, 5]
started: [原始时间戳]
last_activity: [现在]
completed: [现在]
状态持久性
每一步之后，都写入 ops/tutorial-state.yaml。不容商量 —— 教程必须跨会话恢复。
格式：
track: [researcher|manager|personal]
current_step: [1-6, 其中 6 = 完成]
completed_steps: [完成步骤编号数组]
started: [ISO 8601 UTC]
last_activity: [ISO 8601 UTC]
completed: [ISO 8601 UTC, 仅当完成时]
会话启动集成： 如果存在状态且不完整，会话启动钩子应该显示：“您有一个未完成的教程（第 N 步，共 5 步）。继续使用 /tutorial。”
质量原则
通过实践学习。 每一步都在知识库中创建真实的内容。没有假设性示例。在教程期间创建的 {vocabulary.note_plural} 是真实的 {vocabulary.note_plural}，它们会持续并随着未来内容的增加而复合。
WHY 在 HOW 之前。 每一步在要求用户做任何事情之前先解释为什么这很重要。理解动机可以防止教程感觉像是一个清单。
真实，不强迫。 如果用户的输入不产生有意义的连接，就说 so。不要伪造连接以使教程感觉成功。诚实地说明何时存在连接（以及何时不存在）可以教授正确的心智模型。
路径适应，而不是路径锁定。 路径改变了示例和语言，而不是结构。研究者和个人用户都经历了相同的五个步骤，但有不同的框架。
逐步复杂。 第 1 步非常容易（分享一个想法）。第 5 步需要理解系统。每一步都建立在前一步的基础上。没有一步需要教程尚未提供的知识。
边缘情况
用户在第 3 步中粘贴为空： 提供一个适合他们路径的预写示例段落。“这是您可以使用的示例，以了解提取如何工作：”
用户想要跳过一步： 允许它。更新状态以标记该步骤已跳过（未完成）。教程不应该感觉像是一个门。
用户在完成后重新运行 /tutorial： 显示完成状态并提供重置。“您的教程已完成。运行 /tutorial reset 重新开始。”
用户输入太短（一个词）： 温和扩展。“您可以将其发展成一个完整的句子吗？系统最适合完整的想法 —— 例如，不是 ‘会议’，而是 ‘当行动项未被跟踪时，周会失去价值’。”