# T Wiki

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

- Skill: `taroify/t-wiki` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add taroify/t-wiki`
- Raw SKILL.md: https://api.skillmd.com/api/skills/taroify/t-wiki/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: taroify (https://skillmd.com/u/taroify)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/taroify/t-wiki

---


# 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、阶段状态或插件脚本。

## 路由

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

```text
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
```

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

```bash
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 分开报告结构健康与内容准确性，不用一个结论替代另一个。