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