Obsidian Bases 数据视图技能
帮助代理创建和维护 Obsidian 的数据库式笔记视图。
技能主要描述在本地 Obsidian vault 中创建和编辑 .base 文件,未见恶意行为、凭据窃取或数据外传;但要求写入文件并在 Obsidian 中测试,没有明确的用户确认、备份、回滚、权限边界或敏感数据处理说明,因此扣分。
工作流、Schema、过滤器、公式和故障排查内容基本一致,且给出缺失属性、YAML 引号和 Duration 等错误提示;但未提供测试套件、CI、版本兼容范围或实际复现证据,静态评估不超过 10 分,因此扣分。
触发条件明确,覆盖 .base、视图、过滤器和公式等常见场景,并说明 map 视图需要 Maps 社区插件;但非适用范围、Obsidian 版本要求、输入输出边界和语言支持未充分声明,扣分。核心能力不依赖海外在线服务。
文档结构清晰,包含安装上下文、Schema、参考文件、示例和 Troubleshooting;仓库提供 MIT 许可证,但目标技能缺少明确版本、变更记录、维护责任和更新路径,且部分依赖与兼容性假设未集中说明,因此扣分。
内容能够覆盖创建 Bases 文件、定义过滤器、公式、视图和常见修复,示例具有直接参考价值;但没有静态可验证的实际渲染结果或执行证据,复杂场景仍需人工校验,按静态上限评为 7 并扣分。
目标文件包含可审计的结构化说明、示例和指向 Obsidian 官方文档的引用;但没有提交测试、CI 覆盖或第三方执行证据,且无法在本次静态审查中独立复现,因此仅给有限分数。
- 这是仅基于源文件的静态审查,未执行 Obsidian、YAML 解析或示例验证。
- 写入 vault 前应明确用户确认、备份和回滚策略。
- 应确认目标 Obsidian 版本、Bases 功能可用性及 Maps 社区插件依赖;公式和过滤器示例仍需在实际环境中复核。
这个 Skill 能做什么,适合哪些场景?
该技能专门处理 Obsidian Bases 的 `.base` 文件,用 YAML 定义筛选器、公式、属性、视图和汇总。它支持表格、卡片、列表和地图视图,并提供日期计算、条件逻辑及常用属性访问方式。技能还说明了 YAML 引号、公式类型和空值检查等常见错误。它适合希望在 Obsidian 中建立任务、阅读清单或每日笔记索引的用户。
创建包含有效 YAML 的 .base 文件;按标签、文件夹、属性或日期筛选笔记;定义可复用的计算公式;配置表格、卡片、列表或地图视图及显示顺序;设置分组、结果数量限制和汇总公式;检查 YAML、属性和公式引用,并指导用户在 Obsidian 中验证视图渲染。
- Obsidian 用户想把带有任务标签和状态属性的笔记整理成可分组、可汇总的任务表。
- 读者想按书籍或文章标签建立带作者、页数和阅读状态的阅读清单或卡片库。
- 用户想索引“Daily Notes”文件夹中的日期笔记,并显示星期、字数估算和修改时间。
- 用户需要用日期、标签、文件夹或属性组合筛选笔记,并在多个视图中复用同一范围。
这个 Skill 有哪些优点和局限?
- 覆盖 `.base` 文件从创建、筛选、公式到视图验证的完整工作流。
- 提供表格、卡片、列表和地图等多种视图配置示例。
- 详细说明 Duration、日期计算、空值保护和 YAML 引号等易错点。
- 采用 YAML 和开放格式,便于在 Obsidian 中直接检查和编辑。
- 技能只针对 Obsidian Bases,不涵盖仓库中的 Markdown、JSON Canvas、Obsidian CLI 或网页提取能力。
- 视图最终需要在 Obsidian 中测试;地图视图还依赖 Maps 社区插件。
- 来源未说明自动化测试套件、版本兼容范围或错误恢复机制。
如何安装这个 Skill?
该技能属于 kepano/obsidian-skills 的 5 个技能组成的仓库。可通过插件市场执行 /plugin marketplace add kepano/obsidian-skills,再执行 /plugin install obsidian@obsidian-skills;也可执行 npx skills add https://github.com/kepano/obsidian-skills。手动安装时,将仓库中的 skills/ 目录复制到 Codex 技能路径(通常为 ~/.codex/skills);Claude Code 可将仓库内容放入 Obsidian vault 根目录的 /.claude 文件夹。
如何使用这个 Skill?
在已安装该技能的代理中输入例如:Create a .base file for my Obsidian task notes, filter for active tasks, calculate days until due, and show a grouped table by status. 代理应在 vault 中创建 .base 文件,随后检查 YAML、公式和属性引用,并建议在 Obsidian 中打开文件确认视图是否正常。地图视图还需要纬度/经度属性和 Maps 社区插件。