用途:这是一套面向 Obsidian 插件全生命周期的工程化技能,覆盖开发、调试、审查、测试与发布。用户当前指令与项目 AGENTS 优先于本技能;本技能不等于 Obsidian 官方政策。审查/诊断默认只读,开发才做实现与验证,只有授权发布时才推送、合并或修改社区页面。
主要能力:先检查实际仓库、分支、dirty 状态、目标测试库、已安装版本、项目脚本与当前 SDK 类型,避免用另一库或缓存版本当作当前证据。坚持原生 API 优先,插件运行时不依赖开发机路径或调试全局 app,面向移动端不打包 Node/Electron。修复前先复现问题,沿用户动作、命令/事件、状态转换、副作用、UI 反馈、清理恢复定位根因,在现有架构内做最小实现,明确单一数据源、持久化时机、失败恢复与卸载清理。按改动运行 lint/typecheck/测试/build,再安装到指定测试库重载,用脚本化真实用户操作验证,模拟测试与实机结果分开记录。
使用方式:验证入口命令保持原样,例如 python3 scripts/audit_release.py /path/to/plugin --tag 1.2.3 --max-asset-bytes 5000000 --scan-tips;python3 scripts/check_public_release.py /path/to/plugin --repo owner/repo --version 1.2.3 --attempts 6;python3 scripts/host_eval.py --vault <qa-vault> --reload <plugin-id> --file check.js --screenshot /tmp/shot.png;python3 -m unittest discover -s tests -p 'test_.py';rg -n 'setTooltip|setAttribute(["'"']title|\btitle\s:|aria-label' plugin-src src styles.css。本地审计脚本只读、输出 JSON 与非零失败码;check_public_release.py 匿名下载根级资产并与本地产物逐字节比较;host_eval.py 在指定库以完整权限执行检查脚本,仅限 QA 库。授权发布按 feature branch/PR、checks、最终候选 SHA 官方 Preview Scan、Draft Release 与安装验收的流程推进。
适用场景:新插件或重大能力的前置调研与评估、诊断与回归修复、设置 GUI、学习型阅读器、字体与媒体、摘录与来源、宿主与性能、数据可靠性、外部集成,以及乔木系列插件家族协议等。
限制:本地审计不证明官方审核、依赖安全或移动兼容;公开回读只证明当次匿名下载,不证明目录同步或真机运行;host_eval 只证明该桌面库、该版本上的本次操作;5 MB 为项目经验预算,不声称官方永久限制。无法验证的部分应直接标记,禁止声称自动上架成功。