用途:为工程团队或开源项目维护文档生命周期,规定各目录的写作与流转约定,让模板和文件夹说明保持清晰。它是技能包层面的指引,平台 /open-knowledge 技能(读/写/预览/链接/依据规则)仍管辖所有 markdown 操作,本技能只在其上叠加生命周期约定。
主要流程与目录:proposals/ 存放进行中的 RFC 式设计提案,状态 draft→fcp→accepted/rejected,结构为 Motivation / Design / Drawbacks / Alternatives / Unresolved questions,每个提案一个文件(0001-feature-name.md),被接受后转为 decisions/ 中的记录。decisions/ 是冻结的架构决策记录(MADR / Nygard 结构),状态 proposed/accepted/deprecated/superseded,文件名为 NNNN-title.md,新决策可经 Supersedes: 链接旧记录。specs/ 是由已接受提案派生的实现规格,建议采用 github/spec-kit 结构,每个规格一个文件夹 specs/NNN-name/,含 spec.md、plan.md、tasks.md,并引用父提案。postmortems/ 为无责事故复盘,每个事故一个文件(YYYY-MM-DD-name.md),结构 Summary / Timeline / Root cause / What went well / Action items。guides/ 存放操作指南、入门文档和 runbook(Diátaxis how-to),附 last_verified 以便定期审查陈旧内容。
使用方式:文档创建用 write({ document: { path, template: "<name>" } });模板仅含结构(标题与前导元数据脚手架),各节用途见上述说明。五个工作流各有对应技能,只在需要时加载:/frame-a-proposal(设计并论证变更)、/write-a-spec(把已接受提案细化为可实现的规格)、/record-a-decision(记录决策的背景与后果)、/write-a-postmortem(事故复盘)、/review-a-design(对现有提案、规格或决策做健全性检验)。
限制:资料未提供收费、平台支持范围、安装命令及具体实现细节。