|最后更新: Invalid Date
Tags
AI
视频介绍
资源地址
备注

创建 Skill:每周学习周报

你现在要帮我在当前 AI 工具中创建一个可复用的 skill 文件夹,而不是直接帮我生成这一次周报。
这个 skill 的目标是:扫描 Obsidian 仓库中本周的采集、主题、产出和日记证据,生成一份「本周学习报告」,帮助用户看见本周知识系统真正长出了什么、哪些主题在变强、哪些内容可以发展成表达。它不是仓库统计报表,也不是把历史素材硬凑成本周成果。
请按下面流程创建真实的 skill 文件夹和文件。

一、创建前向我收集配置

先一次性问我下面这些问题。每个问题都有默认值;如果我没有回答某一项,就使用默认值继续。
  1. 这个 skill 文件夹叫什么名字?
      • 默认:weekly-learning-report
      • 说明:这是 AI 工具里用于触发的 skill 名称,不是 Obsidian 仓库名。
  1. 你的 Obsidian 仓库叫什么,仓库路径在哪里?
      • 默认仓库名:Shiki's Obsidian Starter
      • 默认路径策略:先让 AI 在常见 Obsidian 目录中查找同名仓库;找不到时再向用户询问路径。
      • Mac 找路径方法:右键点击仓库文件夹,按住 Option 键,选择「拷贝……的路径名称」。
      • Windows 找路径方法:打开仓库文件夹,点击顶部地址栏,复制显示的路径。
  1. 你希望报告从哪些文件夹提取内容?
      • 默认纳入:
        • 01. 采集 Grasp:本周采集、整理或更新的素材
        • 02. 归类 Arrange:本周新建、修改或被本周素材关联到的主题
        • 03. 表达 Present:本周新建、修改或正在推进的表达 / 产出
        • 04. 日记 Journal/01. 日记:本周日记中的学习、工作、反思相关内容
      • 你可以直接罗列文件夹路径,例如:InboxProjectsJournal/DailyWriting
      • 说明:不要默认扫描整个仓库。只扫描用户列出的文件夹;本周相关但在其他文件夹的内容,只有被这些文件夹里的本周笔记链接到时,才作为背景材料。
  1. 这些文件夹分别代表什么类型?
      • 默认类型:
        • 01. 采集 Grasp = 素材 / 采集
        • 02. 归类 Arrange = 主题 / 归类
        • 03. 表达 Present = 产出 / 表达
        • 04. 日记 Journal/01. 日记 = 日记
      • 如果你没有这种分类,也可以说:哪些是输入材料,哪些是项目 / 主题,哪些是输出 / 写作,哪些是日记。
      • 这个信息会影响报告结构,不只是文件夹名字。
  1. 你是否写周记?如果写,请说明周记位置、命名方式、模板和写入区块。
      • 默认:写周记。
      • 默认周记文件夹:04. 日记 Journal/02. 周记
      • 默认命名方式:ISO 周,YYYY-Www,例如 2026-W20
      • 默认日期字段:journal-date
      • 默认日期值:本周周一日期
      • 默认周记模板:模版 Template/05. 周记模版.md
      • 默认标题:### 本周学习报告
      • 默认写入规则:如果区块存在,就只更新该区块;如果不存在,就插入到 ### 本周复盘 前面;如果找不到 ### 本周复盘,追加到周记末尾。
      • 默认使用边界标记: <!-- weekly-learning-report:start --><!-- weekly-learning-report:end -->
      • 如果你不写周记,默认只在对话中生成报告,不写文件。
      • 如果你没有周记模板,但允许写入周记,AI 会在需要时创建最小周记。
      • 如果不希望 AI 新建周记,请说明:只预览,不新建。
  1. 如何判断哪些内容属于「本周」?
      • 默认:使用 ISO 周,周一到周日。
      • 严格本周证据:文件名日期、创建时间journal-date、周记文件名落在本周范围内。
      • 修改时间证据:文件系统修改时间落在本周范围内,但报告中必须标注“按修改时间纳入”。
      • 关联延伸证据:本周笔记链接到的旧主题 / 旧素材只能作为背景,不算本周新增。
  1. 日记是否纳入学习报告?
      • 默认:纳入,但只读取周内日记的属性字段和明确的学习 / 工作 / 反思相关区块。
      • Starter 默认字段:今日机会今日反思今日感恩
      • 如果日记包含隐私内容,可以选择不纳入,或只纳入指定标题下的内容。
  1. 生成报告后是否允许写入周记?
      • 默认:先预览,用户确认后写入。
      • 可选:只在对话中生成,不写文件。
      • 可选:确认后如果周记不存在,就用模板新建;如果模板不存在,就创建最小周记。
请提醒用户:不需要粘贴任何 API key、token、cookie 或账号密码。这个 skill 默认只操作本地 Markdown 笔记。

二、收到回答后,先整理配置映射

收到用户回答后,先整理下面的配置映射,再创建文件。
必须使用大写 snake case 变量名:
  • SKILL_FOLDER_NAME
  • VAULT_NAME
  • VAULT_PATH
  • REPORT_SOURCE_FOLDERS
  • REPORT_SOURCE_TYPES
  • SOURCE_FOLDER
  • TOPIC_FOLDER
  • OUTPUT_FOLDER
  • DAILY_FOLDER
  • WEEKLY_FOLDER
  • WEEKLY_NOTE_NAMING
  • WEEKLY_TEMPLATE_PATH
  • WEEKLY_DATE_FIELD
  • REPORT_SECTION_HEADING
  • REPORT_START_MARKER
  • REPORT_END_MARKER
  • INSERT_BEFORE_HEADING
  • WEEK_RULE
  • STRICT_EVIDENCE_FIELDS
  • INCLUDE_FILE_MTIME
  • INCLUDE_DAILY_NOTES
  • DAILY_FIELDS
  • WRITE_MODE
默认映射:
  • SKILL_FOLDER_NAME: weekly-learning-report
  • VAULT_NAME: Shiki's Obsidian Starter
  • VAULT_PATH: AUTO_DETECT_BY_VAULT_NAME
  • REPORT_SOURCE_FOLDERS: 01. 采集 Grasp, 02. 归类 Arrange, 03. 表达 Present, 04. 日记 Journal/01. 日记
  • REPORT_SOURCE_TYPES: source, topic, output, daily
  • SOURCE_FOLDER: 01. 采集 Grasp
  • TOPIC_FOLDER: 02. 归类 Arrange
  • OUTPUT_FOLDER: 03. 表达 Present
  • DAILY_FOLDER: 04. 日记 Journal/01. 日记
  • WEEKLY_FOLDER: 04. 日记 Journal/02. 周记
  • WEEKLY_NOTE_NAMING: ISO_WEEK_YYYY_Www
  • WEEKLY_TEMPLATE_PATH: 模版 Template/05. 周记模版.md
  • WEEKLY_DATE_FIELD: journal-date
  • REPORT_SECTION_HEADING: ### 本周学习报告
  • REPORT_START_MARKER: <!-- weekly-learning-report:start -->
  • REPORT_END_MARKER: <!-- weekly-learning-report:end -->
  • INSERT_BEFORE_HEADING: ### 本周复盘
  • WEEK_RULE: ISO_WEEK_MONDAY_TO_SUNDAY
  • STRICT_EVIDENCE_FIELDS: 创建时间, journal-date, file name date, weekly note name
  • INCLUDE_FILE_MTIME: true_with_label
  • INCLUDE_DAILY_NOTES: true_limited
  • DAILY_FIELDS: 今日机会, 今日反思, 今日感恩
  • WRITE_MODE: preview_then_write_to_weekly_note
说明:SOURCE_FOLDERTOPIC_FOLDEROUTPUT_FOLDERDAILY_FOLDER 是 Starter 默认结构的便捷映射。如果用户提供的是完全自定义文件夹,就以 REPORT_SOURCE_FOLDERSREPORT_SOURCE_TYPES 为准,不强迫用户拥有这四类文件夹。
配置变量分类:
  • A 类,固定不问:先建立本周证据包;严格本周证据优先;旧材料只能作为背景;证据不足时必须说证据不足;写入前必须预览;只更新周记里的报告标记区块;不覆盖整篇周记。
  • B 类,简单偏好:skill 名称、文件夹类型映射、是否纳入日记、写入模式、报告区块标题。
  • C 类,需要查找或操作:仓库路径、报告来源文件夹、周记文件夹、周记模板路径。
  • D 类,敏感凭证:默认没有。不要让用户粘贴任何密钥、token、cookie 或密码。

三、创建文件结构

创建下面的文件夹和文件:
如果当前 AI 工具要求 skill 放在固定目录,请遵守该工具的 skill 安装规则;否则在当前工作区创建这个文件夹。

四、SKILL.md Frontmatter

把下面 frontmatter 写入 SKILL.md 顶部。写入前替换所有 {{变量名}}

五、写入 SKILL.md 正文

写入前,把第三节、第四节、以及下方正文 ## Configuration 章节中所有 {{变量名}} 占位符,统一替换为第二节整理出的实际值。替换完成后,正文中不应存在任何剩余的 {{}} 占位符。
将以下内容写入 SKILL.md

六、创建后检查并测试

创建完成后,做这些检查:
  1. 确认 {{SKILL_FOLDER_NAME}}/SKILL.md 存在。
  1. 检查 SKILL.md 中没有残留 {{}} 占位符。
  1. 检查没有残留任何安装者之外的私人绝对路径,例如 /Users/<name>/...C:\\Users\\<name>\\...
  1. 检查没有要求用户粘贴 token、cookie、API key 或密码明文。
  1. 检查默认逻辑没有绑定用户个人仓库路径,只保留可配置的 Starter 默认结构。
  1. 检查正文明确要求先生成本周证据包,再生成报告。
  1. 检查正文明确要求写入前预览确认。
  1. 检查正文明确要求只更新周记里的报告标记区块,不覆盖整篇周记。
然后给用户一条功能验证请求:
期望行为:
  • AI 计算当前 ISO 周和日期范围。
  • AI 找到目标周记路径。
  • AI 区分严格本周证据、修改时间证据和关联延伸背景。
  • AI 不把旧素材硬写成本周成果。
  • AI 在证据不足时明确说明。
  • AI 只预览报告,不写文件。
最后告诉用户:
  • skill 文件夹位置。
  • 创建了哪些文件。
  • 以后可以用什么话触发,例如「帮我生成本周学习报告并写入周记」。
Loading...