chore: memory-sync — 归档 obsidian 社区对标审查决策 + 引用计数刷新

Phase 3 节段合并:远端 decisions.md 中"obsidian skill 集对标社区基准的审查 + 优化(2026-06-12)"
Section 自动合并到本地(远端独有 → 追加到末尾,无 remote-diverge)。

Phase 5 memory-update:
- decisions.md frontmatter commit 38beecbfad7335
- project_overview.md 更新 obsidian 行:9 技能 → 10 技能,标注社区对标基准

Phase 6 memory-lint:
- 文件级引用 AUTO-FIX:decisions.md 1→3(达到 SYNTHESIS_THRESHOLD=3,列为核心枢纽节点)
- MEMORY.md 引用列同步:decisions=3 / project_overview=1 / feedback_plugin_dev=1 / lint_report=0
- NEED-HUMAN: 0
- section 级跨文件引用仍 < 3,无 synthesis 升级候选

Phase 7-9:CLAUDE.md 元数据更新(commit hash + 决策项 11→12 + obsidian 10 技能)。
This commit is contained in:
SkyJourney
2026-06-12 20:04:26 +08:00
parent fad7335ba8
commit bd960dbddd
5 changed files with 52 additions and 18 deletions
+27 -1
View File
@@ -3,7 +3,7 @@ name: 架构决策
description: Marketplace 设计中的关键技术决策及其原因
type: project
last_updated: 2026-06-12
commit: 38beecb
commit: fad7335
---
# 关键架构决策
@@ -136,3 +136,29 @@ commit: 38beecb
**Why**Claude Code 插件规范中 SKILL.md frontmatter 只定义了 `name``description``version` 字段不在规范内,silently ignored,且与 plugin.json 层面的版本管理重复。已从所有 huanxi skill 文件中移除。
**How to apply**:新建 SKILL.md 时只写这两个字段。`description` 字段写用户实际口语触发词(第三人称描述),不要用"当需要…时触发"的内部视角表达。
---
## obsidian skill 集对标社区基准的审查 + 优化(2026-06-12
**结论**:基于公开社区调研结果(kepano/obsidian-skills 31.8k★、AgriciDaniel/claude-obsidian 15 技能、qhuang20/obsidian-skills、pablo-mano/Obsidian-CLI-skill),对本地 9 技能完成全量审查并执行方案 B(中等扩展):
1. **P1 描述去冗余**8 个子技能 description 末尾"检测到 .obsidian/ 时与核心技能同步激活"全部删除——Claude Code 路由器按关键词独立打分,没有"伴随激活"机制,此声明纯占预算。
2. **P5 obsidian-plugins 缩范围**:从"控制面板"宽泛定位收敛到"环境层(插件/主题/CSS/Templates/快捷键/命令)",加"首次配置 vault 批量装常用插件"高频场景。
3. **P6 obsidian-workflow-pkm 加引导**description 显式声明"多步骤复合需求优先匹配本技能,单一原子操作走子技能",让"清理 inbox"等短指令更易命中编排层。
4. **P3 核心 obsidian 补 OFM 语法速查**:在第 4 章末尾增"Obsidian Flavored Markdown 语法速查"小节,覆盖 wikilinks/embeds/callouts/block refs/highlight/math 全表 + 写入时高频陷阱。
5. **P4 workflow-pkm 补 Workflow 8 Web Clip → Permanent**:单篇网页剪藏轻量流,引用 defuddleObsidian 团队官方 web→md 清洗工具)+ WebFetch 兜底,明确与 Workflow 7(批量文献)的边界。
6. **P2 新增 obsidian-canvas skill**JSON Canvas 1.0 schema 速查 + 16 hex ID 生成 + 直接 Read/Write JSON 路线(社区共识:obsidian-cli 不原生支持 .canvas 写入)+ 安全 SOP 4 选项对照表(A git stash / B .bak / C 原子写 / D File Recovery)。
**Why**
- 社区呈现两条路线:kepano「按文件格式分技能」(5 技能/精)、AgriciDaniel「按方法论分技能」(15 技能/全)。我们的「按工作域分技能」(9→10 技能)取中间路线,保留跨插件感知和职责互斥声明的独特优势。
- 8 处"伴随激活"提示是隐蔽设计错误——它假设了 Claude Code 路由器看不懂的联动语义,是单次审查中最大的描述质量收益点(每技能省 ~28 字符预算给真触发词)。
- canvas 是 Obsidian 开放格式且独立于 Markdown 体系,社区标杆都作为独立 skill 维护;不加 canvas 等于把"视觉知识图"这类高频场景拱手让人。
**How to apply**
- 新增 skill 时,description 末尾**不要写"检测到 X 时与 Y 同步激活"**——Claude Code 路由按关键词独立打分。
- 触发词列表用 `触发词:A、B、C` 显式列;`不用于:X(技能名)` 显式互斥;这种结构提升路由准确率。
- 涉及 vault 内格式(.canvas/.base/.md)的能力,**默认独立成 skill**——不要塞进核心 obsidian。
- 学习模式契机:obsidian-canvas 的"AI 大批量写入回滚策略"4 选项对照表留给团队/用户决策,AI 不强制做掉,默认采用 C+D 作为决策前兜底。
**See Also**[[feedback_plugin_dev.md#签名变更全量扫描]]、kepano/obsidian-skills、AgriciDaniel/claude-obsidian