菜单
用于维护 Obsidian LLM Wiki 的「结构层」——确定性重写 Home 总览树、各一级目录 README、00-Index 分区页的「受管块」，并产出结构体检报告。触发语：/wiki-struct（check / apply / init）、「刷新 Home 树」、「更新 README 目录」、「整理结构层」。只重写 marker 包裹的受管块，绝不改内容笔记原文；内容策展 → wiki-curate。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when running a spec's execution tail — presents the 执行方式 selector, dispatches the chosen engine (task-swarm / superpowers / specode-native TDD), then runs acceptance and the distill prompt. Trigger /specode:execute <slug> manually at any time once tasks.md exists, or invoked by name (specode:execute) via the Skill tool by the spec / continue skills.
Use when running specode's requirements phase — project analysis + code location + clarification, then writing requirements.md. Produces <specsRoot>/<slug>/requirements.md (with the project_root frontmatter contract) plus the location pointers handed to the design phase. Invoked by name (specode:intake) via the Skill tool by the specode orchestration SKILL; not a user-triggered command.
Use when creating a new spec-driven workflow — the /specode:spec entry that walks requirements → design → tasks → 执行方式 → execute → acceptance, autonomously calling superpowers skills for the heavy lifting with a first-class specode-native fallback, and filing 4 fixed artifacts (requirements.md / design.md / tasks.md / implementation-log.md) under the user document directory. Trigger /specode:spec <request>, or 进入 spec 模式 with a new requirement.
Use when resuming an existing spec by slug — the /specode:continue entry that reads the fixed docs, reports a progress brief (inferred phase + checkbox progress), then stops and waits for the user; it never auto-resumes. Trigger /specode:continue <slug>.
Use when distilling a finished specode spec into atomic, locate-oriented markdown knowledge points — writes cases/ + navigation/ + MEMORY.md into the project's own <project_root>/knowledge-base/ (md-only, no auto-injection), optionally copied to an Obsidian vault. Trigger ONLY /specode:distill <slug>, never auto-run by the main specode flow.
Use when listing all specs under the specs root — the /specode:list entry that shows every spec slug with its inferred phase, for looking up slugs or an overview; it does not resume. Trigger /specode:list.
| name | wiki-struct |
| description | 用于维护 Obsidian LLM Wiki 的「结构层」——确定性重写 Home 总览树、各一级目录 README、00-Index 分区页的「受管块」，并产出结构体检报告。触发语：/wiki-struct（check / apply / init）、「刷新 Home 树」、「更新 README 目录」、「整理结构层」。只重写 marker 包裹的受管块，绝不改内容笔记原文；内容策展 → wiki-curate。 |
配置说明：vault 的结构配置存在家目录注册表
~/.config/obsidian-wiki/configs/<库名>.json（按 active 库解析；未注册则回退库内<vault>/.wiki/config.json）。schema 见本插件根config.example.json。脚本仍通过--vault "<vault 根路径>"指定 vault，结构由注册表/回退提供。脚本定位：脚本装在本 skill 的
scripts/目录下。用本 skill 的 base directory 把相对路径scripts/<脚本名>.py拼成绝对路径来跑（不解析环境变量、不 find 缓存）。
把"结构层"从手工维护变成可重跑、确定性、内容安全的再生成。设计与约定见本插件根 DESIGN.md（位于 skills/wiki-orchestrate/ 旁的套件文档）。
结构文件里自动内容放在 marker 之间，本 skill 只重写 marker 之间，marker 外人工内容一字不动：
<!-- wiki-struct:tree start -->
…（自动生成的树 / 文件清单）…
<!-- wiki-struct:tree end -->
三类结构文件：00-Index/Home.md（全库 callout 树）、15 个一级目录 README.md（本目录文件清单）、15 个 00-Index/<目录>.md 分区页（本目录文档清单树）。详见 references/managed-blocks.md。
| 命令 | 行为 |
|---|---|
/wiki-struct（= check） | 跑 python3 scripts/struct_gen.py check，读 00-Index/_system/struct-report.md，汇报概览 + 最该处理项。不写结构文件 |
/wiki-struct apply [--scope home|readmes|partitions|all] | 备份 → struct_gen.py apply → 坏链复核 → 写 wiki-log。改前确认 |
/wiki-struct init | 为缺 marker 的结构文件插入受管区（逐文件 AskUserQuestion 确认位置），见下 |
/wiki-struct help | 显示本表 |
未给子命令按 check 处理。
python3 scripts/struct_gen.py check --vault "<vault>".00-Index/_system/struct-report.md。原则：受管块只新插入、绝不包裹/替换人工策展清单。
对报告里"缺 marker"的每个结构文件：
## 目录树 下的 callout 树本就是上轮自动生成、无人工策展 → 可就地包裹这段（marker 包到 callout 树两端）。07-Ideas/README 的项目表、01-Concepts 分区页的 ### 架构设计 分组）→ 不碰它们，改为新插入一个受管块小节 ## 目录树（自动维护），位置默认在文件末尾的"关联"段之前、或 ## 用途 之后。<!-- wiki-struct:tree start --> 空行 <!-- wiki-struct:tree end -->（新插入时块内先留空，由 apply 填充；就地包裹时不改段内内容）。apply 填充。tar -czf ~/Library/Caches/wiki-struct-backup-<ts>.tgz 受影响的结构文件。python3 scripts/struct_gen.py apply [--scope ...] --vault "<vault>"。00-Index/_system/wiki-log.md：
- YYYY-MM-DD HH:MM wiki-struct apply (scope: <scope>, changed: <n>)07-Ideas/、10-Work/、SpecIn/、03-Memo/ 下除 README 外的 .md 都是内容笔记，不动）。03-Memo/、10-Work/权限申请·系统、99-Inbox/账号·激活）受管块只含文件名级链接（生成器本就不读正文，天然满足）。ls "/Volumes/External HD" 失败）→ 报错停。本 skill 是结构层。同套件还有：wiki-curate（方法论伞 + 内容向 ingest/curate/lint + 写作规范/红线/模板 doctrine）、wiki-orchestrate（统一编排）。各管一摊：结构 → wiki-struct，内容策展与方法论 → wiki-curate。（spec-distill 知识沉淀已于 v2.0.0 剥离，迁往 specode 的 /specode:distill。）
DESIGN.md（套件根）：完整设计与验收标准references/managed-blocks.md：marker 语法、三类受管块定义、init 迁移规则references/dir-config.md：目录配置表、渲染规则、敏感目录、新增目录怎么改