taroify T Wiki
把当前项目的源码和文档编译为可提交、可追溯、适合人和 agent 阅读的本地 Wiki。
定位
- 把当前目录或用户给定路径解析为项目路径。
- 优先用
git rev-parse --show-toplevel定位仓库根；不在 Git 仓库时，把项目路径本身作为根。 - 把本 skill 所在目录记为
this_skill_dir。 - 只识别
{repo}/docs/wiki/.t-wiki.json；不要读取其他位置的同名配置。 - 不加载或调用其他 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 分开报告结构健康与内容准确性，不用一个结论替代另一个。