workspace-topology
Installation
SKILL.md
Workspace Topology
管仓库的形状:代码在哪、文档在哪。不管代码内容,不管文档内容。
三种形状:
| 形状 | 代码 | 文档 | 代码归本仓所有 |
|---|---|---|---|
inline(缺省) |
仓库根 | <仓库根>/docs/ |
是 |
shell |
各 git 子模块下 | <仓库根>/docs/ |
是 |
linked |
本机目录引用,仓内仓外皆可 | <仓库根>/docs/ |
否 |
文档根三种形状下都是 docs/,这是固定不变量,不设配置字段。变的只有代码在哪、归谁。
shell 服务两类零污染场景:维护开源项目(自己的文档不能进上游仓)、自有项目待公开。
linked 服务「代码根不属于本仓」的场景:多仓联调、按需组合的临时工作区、只想让文档仓记住相关代码在哪。用什么手段组织(worktree / clone / symlink / 就是个目录)由用户决定,本 skill 只认不造。