Tags
AI
视频介绍
资源地址
备注
创建 Skill:每周学习周报
你现在要帮我在当前 AI 工具中创建一个可复用的 skill 文件夹,而不是直接帮我生成这一次周报。
这个 skill 的目标是:扫描 Obsidian 仓库中本周的采集、主题、产出和日记证据,生成一份「本周学习报告」,帮助用户看见本周知识系统真正长出了什么、哪些主题在变强、哪些内容可以发展成表达。它不是仓库统计报表,也不是把历史素材硬凑成本周成果。
请按下面流程创建真实的 skill 文件夹和文件。
一、创建前向我收集配置
先一次性问我下面这些问题。每个问题都有默认值;如果我没有回答某一项,就使用默认值继续。
- 这个 skill 文件夹叫什么名字?
- 默认:
weekly-learning-report - 说明:这是 AI 工具里用于触发的 skill 名称,不是 Obsidian 仓库名。
- 你的 Obsidian 仓库叫什么,仓库路径在哪里?
- 默认仓库名:
Shiki's Obsidian Starter - 默认路径策略:先让 AI 在常见 Obsidian 目录中查找同名仓库;找不到时再向用户询问路径。
- Mac 找路径方法:右键点击仓库文件夹,按住 Option 键,选择「拷贝……的路径名称」。
- Windows 找路径方法:打开仓库文件夹,点击顶部地址栏,复制显示的路径。
- 你希望报告从哪些文件夹提取内容?
- 默认纳入:
01. 采集 Grasp:本周采集、整理或更新的素材02. 归类 Arrange:本周新建、修改或被本周素材关联到的主题03. 表达 Present:本周新建、修改或正在推进的表达 / 产出04. 日记 Journal/01. 日记:本周日记中的学习、工作、反思相关内容- 你可以直接罗列文件夹路径,例如:
Inbox、Projects、Journal/Daily、Writing。 - 说明:不要默认扫描整个仓库。只扫描用户列出的文件夹;本周相关但在其他文件夹的内容,只有被这些文件夹里的本周笔记链接到时,才作为背景材料。
- 这些文件夹分别代表什么类型?
- 默认类型:
01. 采集 Grasp= 素材 / 采集02. 归类 Arrange= 主题 / 归类03. 表达 Present= 产出 / 表达04. 日记 Journal/01. 日记= 日记- 如果你没有这种分类,也可以说:哪些是输入材料,哪些是项目 / 主题,哪些是输出 / 写作,哪些是日记。
- 这个信息会影响报告结构,不只是文件夹名字。
- 你是否写周记?如果写,请说明周记位置、命名方式、模板和写入区块。
- 默认:写周记。
- 默认周记文件夹:
04. 日记 Journal/02. 周记 - 默认命名方式:ISO 周,
YYYY-Www,例如2026-W20 - 默认日期字段:
journal-date - 默认日期值:本周周一日期
- 默认周记模板:
模版 Template/05. 周记模版.md - 默认标题:
### 本周学习报告 - 默认写入规则:如果区块存在,就只更新该区块;如果不存在,就插入到
### 本周复盘前面;如果找不到### 本周复盘,追加到周记末尾。 - 默认使用边界标记:
<!-- weekly-learning-report:start --><!-- weekly-learning-report:end --> - 如果你不写周记,默认只在对话中生成报告,不写文件。
- 如果你没有周记模板,但允许写入周记,AI 会在需要时创建最小周记。
- 如果不希望 AI 新建周记,请说明:只预览,不新建。
- 如何判断哪些内容属于「本周」?
- 默认:使用 ISO 周,周一到周日。
- 严格本周证据:文件名日期、
创建时间、journal-date、周记文件名落在本周范围内。 - 修改时间证据:文件系统修改时间落在本周范围内,但报告中必须标注“按修改时间纳入”。
- 关联延伸证据:本周笔记链接到的旧主题 / 旧素材只能作为背景,不算本周新增。
- 日记是否纳入学习报告?
- 默认:纳入,但只读取周内日记的属性字段和明确的学习 / 工作 / 反思相关区块。
- Starter 默认字段:
今日机会、今日反思、今日感恩 - 如果日记包含隐私内容,可以选择不纳入,或只纳入指定标题下的内容。
- 生成报告后是否允许写入周记?
- 默认:先预览,用户确认后写入。
- 可选:只在对话中生成,不写文件。
- 可选:确认后如果周记不存在,就用模板新建;如果模板不存在,就创建最小周记。
请提醒用户:不需要粘贴任何 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_FOLDER、TOPIC_FOLDER、OUTPUT_FOLDER、DAILY_FOLDER 是 Starter 默认结构的便捷映射。如果用户提供的是完全自定义文件夹,就以 REPORT_SOURCE_FOLDERS 和 REPORT_SOURCE_TYPES 为准,不强迫用户拥有这四类文件夹。配置变量分类:
- A 类,固定不问:先建立本周证据包;严格本周证据优先;旧材料只能作为背景;证据不足时必须说证据不足;写入前必须预览;只更新周记里的报告标记区块;不覆盖整篇周记。
- B 类,简单偏好:skill 名称、文件夹类型映射、是否纳入日记、写入模式、报告区块标题。
- C 类,需要查找或操作:仓库路径、报告来源文件夹、周记文件夹、周记模板路径。
- D 类,敏感凭证:默认没有。不要让用户粘贴任何密钥、token、cookie 或密码。
三、创建文件结构
创建下面的文件夹和文件:
如果当前 AI 工具要求 skill 放在固定目录,请遵守该工具的 skill 安装规则;否则在当前工作区创建这个文件夹。
四、SKILL.md Frontmatter
把下面 frontmatter 写入
SKILL.md 顶部。写入前替换所有 {{变量名}}:五、写入 SKILL.md 正文
写入前,把第三节、第四节、以及下方正文
## Configuration 章节中所有 {{变量名}} 占位符,统一替换为第二节整理出的实际值。替换完成后,正文中不应存在任何剩余的 {{}} 占位符。将以下内容写入
SKILL.md:六、创建后检查并测试
创建完成后,做这些检查:
- 确认
{{SKILL_FOLDER_NAME}}/SKILL.md存在。
- 检查
SKILL.md中没有残留{{或}}占位符。
- 检查没有残留任何安装者之外的私人绝对路径,例如
/Users/<name>/...、C:\\Users\\<name>\\...。
- 检查没有要求用户粘贴 token、cookie、API key 或密码明文。
- 检查默认逻辑没有绑定用户个人仓库路径,只保留可配置的 Starter 默认结构。
- 检查正文明确要求先生成本周证据包,再生成报告。
- 检查正文明确要求写入前预览确认。
- 检查正文明确要求只更新周记里的报告标记区块,不覆盖整篇周记。
然后给用户一条功能验证请求:
期望行为:
- AI 计算当前 ISO 周和日期范围。
- AI 找到目标周记路径。
- AI 区分严格本周证据、修改时间证据和关联延伸背景。
- AI 不把旧素材硬写成本周成果。
- AI 在证据不足时明确说明。
- AI 只预览报告,不写文件。
最后告诉用户:
- skill 文件夹位置。
- 创建了哪些文件。
- 以后可以用什么话触发,例如「帮我生成本周学习报告并写入周记」。