t-wiki

name	t-wiki
description	为任意代码仓库或 Markdown 知识库初始化、编译、增量刷新和使用本地 docs/wiki 知识层。用于用户要求创建或维护 T Wiki、把仓库资料编译成可追溯的 Markdown/Obsidian Wiki、执行 query/search/lint/audit、检查 stale/coverage/source-map，或把单个源文件 ingest 到 Wiki；独立运行，不依赖阶段状态、共享 core、插件 hook 或其他 wiki skill。

T Wiki

把当前项目的源码和文档编译为可提交、可追溯、适合人和 agent 阅读的本地 Wiki。

定位

1. 把当前目录或用户给定路径解析为项目路径。
2. 优先用 git rev-parse --show-toplevel 定位仓库根；不在 Git 仓库时，把项目路径本身作为根。
3. 把本 skill 所在目录记为 this_skill_dir。
4. 只识别 {repo}/docs/wiki/.t-wiki.json；不要读取其他位置的同名配置。
5. 不加载或调用其他 workflow skill、core contract、阶段状态或插件脚本。

路由

按用户意图只读取对应规则：

init                         -> references/wiki-init.md
compile / refresh / 无参数    -> references/wiki-contract.md + references/compile-phases.md
query                        -> references/wiki-query.md
search                       -> references/wiki-search.md
lint                         -> references/wiki-lint.md
audit                        -> references/wiki-audit.md
ingest {path}                -> references/wiki-ingest.md

需要枚举候选源时，优先运行：

python3 this_skill_dir/scripts/wiki-inventory.py \
  --root <repo> \
  --config <repo>/docs/wiki/.t-wiki.json \
  --pretty

脚本不可执行时才手动枚举，并把 inventory_confidence 降为 medium 或 low。

参数

• 无参数：增量编译。
• --full：重新枚举并全量编译。
• --topic {slug}：只重编指定 topic，但仍重新枚举完整候选源。
• --dry-run：预览候选源、变化和计划写集，不写文件。
• --no-audit：编译后跳过本 skill 的 audit 修复闭环。
• --codebase / --knowledge / --deep：用于 init。
• --quiet：用于 ingest，跳过强调点确认。

边界

• 配置固定写入 docs/wiki/.t-wiki.json；输出目录默认 docs/wiki/。
• 除 init 写配置外，只写配置声明的 output。
• 不修改源文件、业务代码、AGENTS.md、CLAUDE.md 或仓库工作流配置。
• purpose_file 必须相对 output；文件缺失不阻断。
• compile 默认按 references/wiki-audit.md 执行质量检查；只在 compile 内修复 Wiki 产物，最多 2 轮。
• --dry-run、--no-audit 不执行 audit 修复。
• query、search、lint、独立 audit 默认只读。
• ingest 只吸收指定文件；保留其他 inventory state，不伪装成 full refresh。
• 遇到不确定、冲突或低覆盖事实时标注风险并保留来源，不补造结论。

输出

• 默认使用中文；路径、代码标识、slug、frontmatter key 和 coverage tag 保持原文。
• compile 报告 topic/concept 变化、候选源与 evidence 数量、机器索引、audit 状态、输出目录和下一步。
• query 给出 topic、section 和 claim 来源；search 给出 coverage、freshness、命中原因和路径。
• lint/audit 分开报告结构健康与内容准确性，不用一个结论替代另一个。