1实现原理 · 为什么它能做到

纯知识注入型技能：SKILL.md 把 Obsidian Bases 的完整 YAML schema 与语义写进模型上下文，模型据此产出合法 .base 文件——目录内无脚本、无 CLI、无网络资源参与。

skills/obsidian-bases/SKILL.md

This skill enables skills-compatible agents to create and edit valid Obsidian Bases (`.base` files) including views, filters, formulas, and all related configurations.

这里在做什么：一句话给出技能边界（创建/编辑 .base），实现完全靠文本规范而非代码。

先定义文件性质与承载形式：Bases 是 YAML，可独立成 .base 文件，也可内嵌 Markdown 代码块。

skills/obsidian-bases/SKILL.md

Obsidian Bases are YAML-based files that define dynamic views of notes in an Obsidian vault.

这里在做什么：让模型先建立「Bases = YAML 声明」的模型，再进入具体字段。

给出可复制的完整 schema 骨架（filters/formulas/properties/summaries/views 五段），并说明全局过滤器作用于所有视图。

skills/obsidian-bases/SKILL.md

# Global filters apply to ALL views in the base

这里在做什么：用注释标出作用域语义，避免模型把 filters 误当视图级。

过滤语法为递归 and/or/not 结构，可全局或按视图施加。

skills/obsidian-bases/SKILL.md

Filters narrow down results. They can be applied globally or per-view.

这里在做什么：确立过滤器的两个作用域与可嵌套特性。

公式语言从 properties 取值计算，统一在 formulas 段定义后可跨视图复用。

skills/obsidian-bases/SKILL.md

Formulas compute values from properties. Defined in the `formulas` section.

这里在做什么：把公式定位成可复用的派生属性。

this 关键字随上下文改变指代对象（主区=base 文件本身，嵌入=嵌入文件，侧栏=主区活动文件）。

skills/obsidian-bases/SKILL.md

In main content area: refers to the base file itself

这里在做什么：消解 this 的多义性，这是 Bases 公式里最容易出错的语义点。

视图类型四种：table/cards/list/map；map 视图依赖经纬度属性与 Maps 社区插件。

skills/obsidian-bases/SKILL.md

Requires latitude/longitude properties and the Maps community plugin.

这里在做什么：标注 map 视图的外部前提，防止模型无脑生成不可用视图。

交付形态支持嵌入 Markdown：既可整份 base 嵌入，也可只嵌某个视图。

skills/obsidian-bases/SKILL.md

Embed in Markdown files:

这里在做什么：衔接 Bases 与普通笔记的使用方式，给出 ![MyBase.base#View Name] 语法。

2核心能力

01完整 .base YAML schema：filters/formulas/properties/summaries/views 五段及各自字段

02递归过滤语法：单条件、and/or/not 嵌套与视图级 filters

03公式语法：算术、条件、字符串格式化、日期运算与复杂表达式

04九类函数库参考：全局/日期/字符串/数字/列表/文件/链接/对象/正则

05四种视图类型（table/cards/list/map）及其 limit/groupBy/order/summaries 配置

06默认汇总公式表（Average/Min/Max/Sum/Median/Stddev 等 15 项）与自定义 summaries

07嵌入 Markdown：整份嵌入或指定视图嵌入

08YAML 引号规则与常见过滤模式（按标签/文件夹/日期范围/属性值/组合条件）

4管控建议与判定依据

建议配套管控措施

面向 Agent

可自动加载

面向管理者

登记来源与版本

判定依据（文件路径与关键语句摘要）

SKILL.md: 纯提示词指令与规则文本，无脚本执行与外部影响

审计说明： 纯指令型：SKILL.md 全文为 markdown 规范与 yaml 示例，§3 扫描确认无脚本执行、无网络请求、无凭证读取、无写盘、无危险旗标。目录仅 SKILL.md 一个文件。。注意 .base 语法随 Obsidian 版本演进，技能未标适用版本，示例可能滞后。

5第二遍独立确认

[ok] 文件面核对（是否有未列脚本/资产） — §1 清单仅 skills/obsidian-bases/SKILL.md 一个文件（16442 字节 / 619 行），无 scripts/references/assets；bundle 未标「已截断」，无需额外 read。
[ok] 外部资源条目复核 — §3 的 4 条 URL 全为文末 References 段的 help.obsidian.md 文档链接（syntax/functions/views/formulas），非运行时调用，故 external_deps 判空。
[ok] 安全结论反例搜索 — §3 显示凭证/外部程序/写盘/网络请求/危险旗标/沙箱均无命中；全文为文本，无代码执行面。
[ok] 能力清单是否夸大 — description 声称的 views/filters/formulas/summaries 均可在 §2 找到对应章节与示例；技能只产出 YAML，不生成渲染结果，无越界承诺。
[ok] 档位判定复核 — 按 §4 口径，纯指令型且无任何脚本/网络/写盘 → 🟢 green 成立。