用途:在 Obsidian 兼容的 Markdown 中创建和管理行为规格 wiki,按功能区域记录系统做什么(spec)与如何构建(plan),并支持按需加载。
主要能力:采用 Johnny Decimal 两位小数编号(NN.NN);提供 playbook 规范条目(每个为 SKILL.md),项目可在 docs/playbook/ 同编号覆盖,查找时本地优先、技能兜底;支持开放问题格式(🙋♂️/🤖/✅)与块 ID;通过 tk 与 tinychange 跟踪变更;提供 wiki 发现顺序(docs/、docs/wiki/、wiki/、tk list --tag plan);定义目录结构(README、AGENTS.md、changelog.md、playbook、reference、features 等);plan 可放在功能目录或标记 plan 的 ticket 中。
使用方式:先读 docs/AGENTS.md(如有 docs/playbook/README.md 也读);识别 features/ 或 workstreams/ 结构;若只给 ID(如 20.01),转为 20-01 并查找 docs/playbook/**/20-01-*/SKILL.md,无本地文件则读技能目录下同名文件并照做;变更时打开或引用 tk ticket,更新 spec/plan 与代码,用 tinychange -I new -k <kind> -m "t-XXXX: message" -a AUTHOR 添加 changelog 条目并链接 ticket 与功能 ID。
适用场景:创建规格、记录功能、维护 wiki、执行 playbook 中的 git/rebase/merge、重构、架构、测试、代理行为等流程。
限制:rebase 须显式 [R] 确认,merge 须显式 [M] 确认且仅在明确要求时执行;changelog 不得手工编辑;AGENTS.md 始终为指向 AGENTS.md 的符号链接;参考文件按需读取,不预加载。其他细节暂未提供。