用途:使用 project-documentation-template 结构引导或调整项目文档,产出一致的结构化生命周期文档。分两种模式:初始化(空项目,复制模板子集并填充占位符)与调整(非空项目,以模板为目标,提出重命名/移动/合并建议,经用户确认后就地应用)。支持可重复运行。
主要能力:按规模(小/中/大)选择文档子集;填充占位符;统一路径为严格 kebab-case(目录与 .md 文件名);ADR 遵循 YYYYMMDD-slug-title.md 并维护索引;创建 VERSION 文件;校验占位符、链接与表格对齐;生成 ADR、更新版本信息。调整模式输出推荐列表(路径/命名问题、可对齐文档、未填充占位符、损坏链接、版本问题)后才应用。
用法:先选模式(用户指定 --mode=initialize 或 --mode=adjust,否则 docs/ 缺失或为空则初始化,否则调整);初始化时确定规模并从模板获取文件、填充元数据、创建 VERSION;调整时扫描 docs/、对比模板、列出建议、请求确认后应用。
适用场景:需要与企业模板一致的结构化文档,或现有文档需要向该结构对齐。
限制:不生成 README(用 generate-standard-readme)、不创建 AGENTS.md 条目(用 generate-agent-entry)、不做技能文档(用 refine-skill-design);占位符超出模板的内容由用户提供;调整模式未经确认不得改动;除非用户要求,不创建空目录或模板文件;模板获取失败时应让用户提供本地克隆或重试。