用途:按 project-documentation-template 模板引导或调整项目文档结构,产出与模板一致的生命周期文档。
主要能力:两种模式。初始化模式针对无 docs/ 或 docs/ 为空的空项目,按小/中/大三种规模复制模板子集并填充占位符,可创建 VERSION 文件,中大型按 spec/artifact-contract.md 创建如 docs/design-decisions/、docs/calibration/、docs/process-management/project-board/backlog/ 与 decisions/ 等目录。调整模式针对已有至少一个有效 .md 文档的项目,以模板为目标扫描现有 docs/,输出重命名、移动、合并及未填占位符、失效链接、版本不一致等建议清单,经用户确认后就地应用,可重复运行逐步整理。
使用方式:用户可指定 scale(small|medium|large)与 --mode=initialize 或 --mode=adjust,未指定则按 docs/ 状态自动判定。初始化时从 TEMPLATE_BASE_URL(https://raw.githubusercontent.com/nesnilnehc/project-documentation-template/main/)获取模板,取不到时提示提供本地克隆路径或稍后重试,不继续使用缺失模板。
限制:命名严格 kebab-case,ADR 文件为 YYYYMMDD-slug-title.md;日期用 YYYY-MM-DD,版本用 SemVer;不得留下未替换占位符或断链;调整模式须先获用户确认;未经请求不创建空目录或额外模板文件。不负责 README(用 generate-standard-readme)、AGENTS.md(用 write-agents-entry)、SKILL.md(用 refine-skill-design)及超出占位符的领域内容。具体收费、价格与平台支持暂未提供。