@clawplays/ospec-cli 0.1.1

package/dist/services/templates/ProjectTemplateBuilder.js

@@ -0,0 +1,1897 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectTemplateBuilder = void 0;
+const constants_1 = require("../../core/constants");
+const TemplateBuilderBase_1 = require("./TemplateBuilderBase");
+class ProjectTemplateBuilder extends TemplateBuilderBase_1.TemplateBuilderBase {
+    constructor(inputs) {
+        super();
+        this.inputs = inputs;
+    }
+    generateProjectReadmeTemplate(fallbackName, mode, input) {
+        const context = this.getProjectContext(fallbackName, mode, input);
+        if (this.isEnglish(context.documentLanguage)) {
+            return `# ${context.projectName}
+
+> Generated by OSpec CLI
+
+## OSpec Bootstrap
+
+This repository has been initialized with OSpec in \`${mode}\` mode.
+
+## Summary
+
+${context.summary}
+
+## Project Knowledge
+
+- Root skill: \`SKILL.md\`
+- Docs hub: \`docs/SKILL.md\`
+- Source map: \`src/SKILL.md\`
+- Test guide: \`tests/SKILL.md\`
+- Index: \`SKILL.index.json\`
+
+## Execution
+
+Active changes live under \`changes/active/<change>\`.
+`;
+        }
+        return `# ${context.projectName}
+
+> 由 OSpec CLI 初始化生成
+
+## OSpec Bootstrap
+
+当前仓库已按 \`${mode}\` 模式完成 OSpec 初始化。
+
+## 项目简介
+
+${context.summary}
+
+## 项目知识层
+
+- 根技能文档：\`SKILL.md\`
+- 文档中心：\`docs/SKILL.md\`
+- 源码地图：\`src/SKILL.md\`
+- 测试说明：\`tests/SKILL.md\`
+- 语义索引：\`SKILL.index.json\`
+
+## 执行层
+
+Active change 位于 \`changes/active/<change>\`。
+`;
+    }
+    generateRootSkillTemplate(fallbackName, mode, input) {
+        const context = this.getProjectContext(fallbackName, mode, input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# ${context.projectName}
+
+> Layer: project root
+
+## Project Overview
+
+- **Project**: ${context.projectName}
+- **Mode**: ${mode}
+- **Status**: OSpec initialized
+- **Summary**: ${context.summary}
+
+## Tech Stack
+
+${this.formatList(context.techStack, 'TBD')}
+
+## Architecture
+
+${context.architecture}
+
+## Navigation
+
+- Docs hub: [docs/SKILL.md](docs/SKILL.md)
+- Source map: [src/SKILL.md](src/SKILL.md)
+- Test guide: [tests/SKILL.md](tests/SKILL.md)
+- AI guide: [for-ai/ai-guide.md](for-ai/ai-guide.md)
+
+## Plugin Gates
+
+- Read \`.skillrc\` before advancing an active change.
+- If Stitch is enabled and the current change activates \`stitch_design_review\`, inspect \`changes/active/<change>/artifacts/stitch/approval.json\`.
+- When Stitch approval is missing or its status is not \`approved\`, treat the change as blocked until design review is complete.`
+            : `# ${context.projectName}
+
+> 层级：第 1 层（项目根文档）
+
+## 项目概述
+
+- **项目名称**：${context.projectName}
+- **模式**：${mode}
+- **状态**：已完成 OSpec 初始化
+- **简介**：${context.summary}
+
+## 技术栈
+
+${this.formatList(context.techStack, '待补充')}
+
+## 项目架构
+
+${context.architecture}
+
+## 目录导航
+
+- 文档中心：[docs/SKILL.md](docs/SKILL.md)
+- 源码地图：[src/SKILL.md](src/SKILL.md)
+- 测试入口：[tests/SKILL.md](tests/SKILL.md)
+- AI 指南：[for-ai/ai-guide.md](for-ai/ai-guide.md)
+
+## 插件阻断
+
+- 开始推进 active change 前先读取 \`.skillrc\`。
+- 如果项目启用了 Stitch，且当前 change 激活了 \`stitch_design_review\`，先检查 \`changes/active/<change>/artifacts/stitch/approval.json\`。
+- 当 Stitch 审批缺失或状态不是 \`approved\` 时，视为 change 仍被阻断，先完成设计审核再继续。`;
+        return this.withFrontmatter({
+            name: context.projectName,
+            title: this.copy(context.documentLanguage, context.projectName, `${context.projectName} Project`),
+            tags: ['ospec', 'project', mode],
+        }, body);
+    }
+    generateDocsSkillTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Documentation Hub
+
+> Layer: docs index
+
+## Navigation
+
+- Project overview: [project/overview.md](project/overview.md)
+- Bootstrap summary: [project/bootstrap-summary.md](project/bootstrap-summary.md)
+- Tech stack: [project/tech-stack.md](project/tech-stack.md)
+- Architecture: [project/architecture.md](project/architecture.md)
+- Module map: [project/module-map.md](project/module-map.md)
+- API overview: [project/api-overview.md](project/api-overview.md)
+- Design docs: [design/README.md](design/README.md)
+- Planning docs: [planning/README.md](planning/README.md)
+- API docs: [api/README.md](api/README.md)`
+            : `# 文档中心
+
+> 层级：第 2 层（项目文档索引）
+
+## 文档导航
+
+- 项目概览：[project/overview.md](project/overview.md)
+- 初始化摘要：[project/bootstrap-summary.md](project/bootstrap-summary.md)
+- 技术栈：[project/tech-stack.md](project/tech-stack.md)
+- 架构说明：[project/architecture.md](project/architecture.md)
+- 模块地图：[project/module-map.md](project/module-map.md)
+- API 总览：[project/api-overview.md](project/api-overview.md)
+- 设计文档目录：[design/README.md](design/README.md)
+- 计划文档目录：[planning/README.md](planning/README.md)
+- API 文档目录：[api/README.md](api/README.md)`;
+        return this.withFrontmatter({
+            name: 'docs',
+            title: this.copy(context.documentLanguage, `${context.projectName} 文档中心`, `${context.projectName} Docs Hub`),
+            tags: ['docs', 'project', 'planning', 'api'],
+        }, body);
+    }
+    generateSrcSkillTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const moduleLinks = this.formatLinkedList(context.modulePlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path.replace(`${constants_1.DIR_NAMES.SRC}/`, ''),
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Source Map
+
+> Layer: source index
+
+## Navigation
+
+- Core layer: [core/SKILL.md](core/SKILL.md)
+- Module layer: \`src/modules/<module>/SKILL.md\`
+
+## Modules
+
+${moduleLinks}`
+            : `# 源码地图
+
+> 层级：第 2 层（源码索引）
+
+## 目录导航
+
+- 核心层：[core/SKILL.md](core/SKILL.md)
+- 模块层：\`src/modules/<module>/SKILL.md\`
+
+## 模块说明
+
+${moduleLinks}`;
+        return this.withFrontmatter({
+            name: 'src',
+            title: this.copy(context.documentLanguage, `${context.projectName} 源码地图`, `${context.projectName} Source Map`),
+            tags: ['src', 'modules', 'architecture'],
+        }, body);
+    }
+    generateCoreSkillTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Core Layer
+
+> Layer: core module
+> Parent: [src/SKILL.md](../SKILL.md)
+
+## Module Overview
+
+- **Role**: shared runtime and infrastructure capabilities
+- **Path**: src/core/
+- **Dependencies**: TBD
+
+## API Docs
+
+- Project API overview: [../../docs/project/api-overview.md](../../docs/project/api-overview.md)`
+            : `# Core 核心层
+
+> 层级：第 3 层（核心模块）
+> 上层：[src/SKILL.md](../SKILL.md)
+
+## 模块概述
+
+- **职责**：承载项目级公共能力
+- **位置**：src/core/
+- **依赖**：待补充
+
+## API 文档
+
+- 项目 API 总览：[../../docs/project/api-overview.md](../../docs/project/api-overview.md)`;
+        return this.withFrontmatter({
+            name: 'core',
+            title: this.copy(context.documentLanguage, `${context.projectName} 核心层`, `${context.projectName} Core Layer`),
+            tags: ['core', 'runtime', 'infrastructure'],
+        }, body);
+    }
+    generateTestsSkillTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Test Guide
+
+## Test Strategy
+
+- Unit tests: TBD
+- Integration tests: TBD
+- End-to-end tests: TBD`
+            : `# 测试说明
+
+## 测试策略
+
+- 单元测试：待补充
+- 集成测试：待补充
+- 端到端测试：待补充`;
+        return this.withFrontmatter({
+            name: 'tests',
+            title: this.copy(context.documentLanguage, `${context.projectName} 测试说明`, `${context.projectName} Test Guide`),
+            tags: ['tests', 'quality', 'verification'],
+        }, body);
+    }
+    generateProjectOverviewTemplate(fallbackName, mode, input) {
+        const context = this.getProjectContext(fallbackName, mode, input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Project Overview
+
+## Background
+
+\`${context.projectName}\` has been initialized by OSpec CLI in \`${mode}\` mode.
+
+## Summary
+
+${context.summary}
+
+## Current Goals
+
+- Complete the project knowledge layer
+- Use [bootstrap-summary.md](bootstrap-summary.md) as the recorded bootstrap output
+- Establish layered skill files
+- Manage delivery through the change workflow`
+            : `# 项目概览
+
+## 背景
+
+\`${context.projectName}\` 已通过 OSpec CLI 初始化，当前模式为 \`${mode}\`。
+
+## 项目简介
+
+${context.summary}
+
+## 当前目标
+
+- 补齐项目知识层
+- 以 [bootstrap-summary.md](bootstrap-summary.md) 记录初始化结果与脚手架输出
+- 建立分层 SKILL 体系
+- 使用 change workflow 管理需求交付`;
+        return this.withFrontmatter({
+            name: 'project-overview',
+            title: this.copy(context.documentLanguage, `${context.projectName} 项目概览`, `${context.projectName} Project Overview`),
+            tags: ['project', 'overview', 'bootstrap'],
+        }, body);
+    }
+    generateTechStackTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Tech Stack
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Stack List
+
+${this.formatList(context.techStack, 'TBD')}`
+            : `# 技术栈
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 技术栈清单
+
+${this.formatList(context.techStack, '待补充')}`;
+        return this.withFrontmatter({
+            name: 'tech-stack',
+            title: this.copy(context.documentLanguage, `${context.projectName} 技术栈`, `${context.projectName} Tech Stack`),
+            tags: ['project', 'tech-stack', 'architecture'],
+        }, body);
+    }
+    generateArchitectureTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Architecture
+
+## System Architecture
+
+- **Project**: ${context.projectName}
+- **Current phase**: OSpec knowledge skeleton initialized
+
+${context.architecture}
+
+## Layers
+
+- Project Knowledge
+- Layered Skills
+- Execution
+- GUI`
+            : `# 架构说明
+
+## 整体架构
+
+- **项目**：${context.projectName}
+- **当前阶段**：已建立 OSpec 项目知识骨架
+
+${context.architecture}
+
+## 分层说明
+
+- Project Knowledge
+- Layered Skills
+- Execution
+- GUI`;
+        return this.withFrontmatter({
+            name: 'architecture',
+            title: this.copy(context.documentLanguage, `${context.projectName} 架构说明`, `${context.projectName} Architecture`),
+            tags: ['project', 'architecture', 'layers'],
+        }, body);
+    }
+    generateModuleMapTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const modules = this.formatLinkedList(context.modulePlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Module Map
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Modules
+
+${modules}`
+            : `# 模块地图
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 模块列表
+
+${modules}`;
+        return this.withFrontmatter({
+            name: 'module-map',
+            title: this.copy(context.documentLanguage, `${context.projectName} 模块地图`, `${context.projectName} Module Map`),
+            tags: ['project', 'modules', 'map'],
+        }, body);
+    }
+    generateApiOverviewTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const apiAreas = this.formatLinkedList(context.apiAreaPlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const moduleApis = this.formatLinkedList(context.moduleApiPlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# API Overview
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## API Areas
+
+${apiAreas}
+
+## Module API Docs
+
+${moduleApis}`
+            : `# API 总览
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## API 边界
+
+${apiAreas}
+
+## 模块 API 文档
+
+${moduleApis}`;
+        return this.withFrontmatter({
+            name: 'api-overview',
+            title: this.copy(context.documentLanguage, `${context.projectName} API 总览`, `${context.projectName} API Overview`),
+            tags: ['project', 'api', 'overview'],
+        }, body);
+    }
+    generateDesignDocsTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const designDocs = this.formatLinkedList(context.designDocPlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Design Docs
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Planned Design Docs
+
+${designDocs}`
+            : `# 设计文档规划
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 需要沉淀的设计文档
+
+${designDocs}`;
+        return this.withFrontmatter({
+            name: 'design-docs',
+            title: this.copy(context.documentLanguage, `${context.projectName} 设计文档`, `${context.projectName} Design Docs`),
+            tags: ['docs', 'design', 'planning'],
+        }, body);
+    }
+    generatePlanningDocsTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const planningDocs = this.formatLinkedList(context.planningDocPlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# Planning Docs
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Planning Documents
+
+${planningDocs}`
+            : `# 开发计划文档
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 计划文档需求
+
+${planningDocs}`;
+        return this.withFrontmatter({
+            name: 'planning-docs',
+            title: this.copy(context.documentLanguage, `${context.projectName} 计划文档`, `${context.projectName} Planning Docs`),
+            tags: ['docs', 'planning', 'milestone'],
+        }, body);
+    }
+    generateApiDocsTemplate(fallbackName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const apiDocs = this.formatLinkedList(context.apiAreaPlans.map(plan => ({
+            displayName: plan.displayName,
+            path: plan.path,
+        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const body = this.isEnglish(context.documentLanguage)
+            ? `# API Docs Directory
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Planned API Docs
+
+${apiDocs}`
+            : `# API 文档目录说明
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## API 文档规划
+
+${apiDocs}`;
+        return this.withFrontmatter({
+            name: 'api-docs',
+            title: this.copy(context.documentLanguage, `${context.projectName} API 文档`, `${context.projectName} API Docs`),
+            tags: ['docs', 'api', 'reference'],
+        }, body);
+    }
+    generateModuleSkillTemplate(fallbackName, moduleName, input, moduleSlug) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const slug = moduleSlug || this.slugify(moduleName) || 'module';
+        const matchedModuleApiDoc = context.moduleApiPlans.find(plan => plan.name === `module-${slug}`);
+        const matchedApiDocs = context.apiAreaPlans.filter(plan => plan.name.includes(slug) ||
+            plan.displayName.includes(moduleName) ||
+            moduleName.includes(plan.displayName.replace(/\s+api$/i, '')));
+        const refs = [
+            ...(matchedModuleApiDoc
+                ? [{ title: `${moduleName} module api`, path: matchedModuleApiDoc.path }]
+                : []),
+            ...matchedApiDocs.map(plan => ({ title: plan.displayName, path: plan.path })),
+        ];
+        const presetBody = this.getPresetModuleSkillBody(context, moduleName, slug, refs);
+        const body = presetBody ?? (this.isEnglish(context.documentLanguage)
+            ? `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Overview
+
+- **Project**: ${context.projectName}
+- **Module**: ${moduleName}
+- **Path**: src/modules/${slug}
+
+## Responsibilities
+
+- Own ${moduleName} domain behavior
+- Connect project design and implementation in this module
+- Maintain module boundaries, dependencies, and tests
+
+## API Docs
+
+${this.formatReferenceList(refs, 'TBD')}
+
+## Dependencies
+
+- Upstream: \`src/core/\`, project configuration, shared infrastructure
+- Peer collaboration: keep clear boundaries with other \`src/modules/*\`
+- Downstream impact: update API docs, change docs, and tests when behavior changes
+
+## Testing Requirements
+
+- Unit tests: cover core business rules and edge cases
+- Integration tests: cover module interactions with APIs, data, and services
+- Regression checks: align change verification when interfaces change
+
+## Related Docs
+
+- Module map: [../../../docs/project/module-map.md](../../../docs/project/module-map.md)
+- API overview: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)`
+            : `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块概述
+
+- **项目**：${context.projectName}
+- **模块名**：${moduleName}
+- **路径**：src/modules/${slug}
+
+## 主要职责
+
+- 承载 ${moduleName} 相关业务能力
+- 衔接项目级设计与当前模块实现
+- 维护模块边界、依赖与测试要求
+
+## API 文档
+
+${this.formatReferenceList(refs, '待补充')}
+
+## 依赖关系
+
+- 上游依赖：\`src/core/\`、项目级配置、共享基础设施
+- 同层协作：与其他 \`src/modules/*\` 保持清晰边界，通过文档和接口约定协作
+- 下游影响：实现变更后需回看关联 API 文档、执行层 change 文档和测试说明
+
+## 测试要求
+
+- 单元测试：覆盖 ${moduleName} 模块核心业务规则和边界分支
+- 集成测试：覆盖该模块与 API / 数据层 / 外部服务的集成路径
+- 回归验证：当模块接口或行为变化时，同步更新 change 验证与相关文档
+
+## 关联文档
+
+- 项目模块地图：[../../../docs/project/module-map.md](../../../docs/project/module-map.md)
+- API 总览：[../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
+- 模块源码入口：当前目录`);
+        return this.withFrontmatter({
+            name: slug,
+            title: this.copy(context.documentLanguage, `${context.projectName} ${moduleName} 模块`, `${context.projectName} ${moduleName} Module`),
+            tags: ['module', slug, 'domain'],
+        }, body);
+    }
+    generateApiAreaDocTemplate(fallbackName, apiAreaName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const presetBody = this.getPresetApiAreaDocBody(context, apiAreaName);
+        const body = presetBody ?? (this.isEnglish(context.documentLanguage)
+            ? `# ${apiAreaName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Boundary
+
+- Own ${apiAreaName} interfaces and contracts
+- Document entrypoints, auth rules, error codes, and data models
+
+## Checklist
+
+- [ ] Routes
+- [ ] Request / response payloads
+- [ ] Permissions and security rules
+- [ ] Tests and acceptance requirements`
+            : `# ${apiAreaName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 边界说明
+
+- 负责 ${apiAreaName} 相关接口能力
+- 待补充请求入口、鉴权规则、错误码和数据模型
+
+## 待补充清单
+
+- [ ] 路由列表
+- [ ] 请求/响应结构
+- [ ] 权限与安全要求
+- [ ] 测试与验收要求`);
+        return this.withFrontmatter({
+            name: this.slugify(apiAreaName) || 'api-area',
+            title: this.copy(context.documentLanguage, `${apiAreaName} API 文档`, `${apiAreaName} API Doc`),
+            tags: ['api', 'reference', 'module'],
+        }, body);
+    }
+    generateModuleApiDocTemplate(fallbackName, moduleName, input, moduleSlug) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const slug = moduleSlug || this.slugify(moduleName) || 'module';
+        const presetBody = this.getPresetModuleApiDocBody(context, moduleName, slug);
+        const body = presetBody ?? (this.isEnglish(context.documentLanguage)
+            ? `# ${moduleName} Module API
+
+## Project
+
+- **Project**: ${context.projectName}
+- **Module**: ${moduleName}
+- **Module path**: src/modules/${slug}
+
+## Public Interface
+
+- Document the services, events, commands, or APIs exposed by this module
+
+## Dependencies
+
+- Upstream: TBD
+- Downstream consumers: TBD
+- Shared dependencies: TBD
+
+## Testing Requirements
+
+- Unit tests: core logic and edge cases
+- Integration tests: cross-module / API / data dependencies
+- Regression checks: update change verification when interfaces change`
+            : `# ${moduleName} Module API
+
+## 项目
+
+- **项目名称**：${context.projectName}
+- **模块名**：${moduleName}
+- **模块路径**：src/modules/${slug}
+
+## 对外接口
+
+- 待补充该模块暴露的服务、事件、命令或接口
+
+## 依赖关系
+
+- 上游依赖：待补充
+- 下游调用方：待补充
+- 共享依赖：待补充
+
+## 测试要求
+
+- 单元测试：核心逻辑和边界条件
+- 集成测试：跨模块 / API / 数据依赖
+- 回归验证：接口变更后同步更新 change 验证`);
+        return this.withFrontmatter({
+            name: `module-${slug}`,
+            title: this.copy(context.documentLanguage, `${moduleName} 模块 API`, `${moduleName} Module API`),
+            tags: ['api', 'module', slug],
+        }, body);
+    }
+    generateDesignDocTemplate(fallbackName, docName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const presetBody = this.getPresetDesignDocBody(context, docName);
+        const body = presetBody ?? (this.isEnglish(context.documentLanguage)
+            ? `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Design Goals
+
+- Explain the background and goal of ${docName}
+- Record boundaries, constraints, and tradeoffs
+
+## To Be Completed
+
+- Background
+- Proposal
+- Risks
+- Verification`
+            : `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 设计目标
+
+- 说明 ${docName} 的设计背景和目标
+- 记录方案边界、关键约束和取舍
+
+## 待补充内容
+
+- 背景
+- 方案
+- 风险
+- 验证方式`);
+        return this.withFrontmatter({
+            name: this.slugify(docName) || 'design-doc',
+            title: this.copy(context.documentLanguage, `${docName} 设计文档`, `${docName} Design Doc`),
+            tags: ['design', 'architecture', 'decision'],
+        }, body);
+    }
+    generatePlanningDocTemplate(fallbackName, docName, input) {
+        const context = this.getProjectContext(fallbackName, 'standard', input);
+        const presetBody = this.getPresetPlanningDocBody(context, docName);
+        const body = presetBody ?? (this.isEnglish(context.documentLanguage)
+            ? `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Planning Goal
+
+- Describe the phase goal and delivery boundary for ${docName}
+
+## To Be Completed
+
+- Milestones
+- Task breakdown
+- Risks and dependencies
+- Acceptance cadence`
+            : `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 规划目标
+
+- 说明 ${docName} 对应的阶段目标和交付边界
+
+## 待补充内容
+
+- 里程碑
+- 任务拆解
+- 风险与依赖
+- 验收节奏`);
+        return this.withFrontmatter({
+            name: this.slugify(docName) || 'planning-doc',
+            title: this.copy(context.documentLanguage, `${docName} 计划文档`, `${docName} Planning Doc`),
+            tags: ['planning', 'delivery', 'milestone'],
+        }, body);
+    }
+    generateAiGuideTemplate(input) {
+        const language = input?.documentLanguage === 'en-US' ? 'en-US' : 'zh-CN';
+        return this.withFrontmatter({
+            name: 'ai-guide',
+            title: this.copy(language, 'AI 开发指南', 'AI Guide'),
+            tags: ['ai', 'guide', 'workflow'],
+        }, this.copy(language, `# AI 开发指南
+
+## 工作顺序
+
+1. 优先读取 \`SKILL.index.json\`。
+2. 修改代码前先读取相关 \`SKILL.md\`。
+3. 当前执行工作以 \`changes/active/<change>\` 为准。
+4. 如果项目启用了 Stitch 且当前 change 激活了 \`stitch_design_review\`，先检查 \`artifacts/stitch/approval.json\`，未 \`approved\` 前不要把 change 视为可继续实现或可归档。
+5. 如果涉及 Stitch 安装、provider 切换、doctor 修复、MCP 或认证配置，优先读取仓库内 Stitch 规范；若缺失规范文档，则使用内建基线：Gemini 用 \`%USERPROFILE%/.gemini/settings.json\` 的 \`mcpServers.stitch.httpUrl\` 与 \`headers.X-Goog-Api-Key\`，Codex 用 \`%USERPROFILE%/.codex/config.toml\` 的 \`[mcp_servers.stitch]\`、\`type = "http"\`、\`url = "https://stitch.googleapis.com/mcp"\` 与 \`X-Goog-Api-Key\`。
+6. 如果内建 Codex provider 只读调用正常但 Stitch 写操作卡住，优先检查是否真正走了 \`codex exec --dangerously-bypass-approvals-and-sandbox\`；如果项目覆写了自定义 Codex runner，则该 runner 也必须显式带上这个参数。
+7. 发生重要变更后同步更新技能文档并重建索引。`, `# AI Guide
+
+## Working Order
+
+1. Read \`SKILL.index.json\` when available.
+2. Read the relevant \`SKILL.md\` files before editing code.
+3. Use \`changes/active/<change>\` as the execution layer.
+4. If Stitch is enabled and the current change activates \`stitch_design_review\`, inspect \`artifacts/stitch/approval.json\` first and do not treat the change as ready to continue or archive until it is \`approved\`.
+5. If Stitch installation, provider switching, doctor remediation, MCP setup, or auth setup is involved, read the repo-local Stitch spec first; if the repo does not contain that spec, use the built-in baselines instead: Gemini uses \`%USERPROFILE%/.gemini/settings.json\` with \`mcpServers.stitch.httpUrl\` and \`headers.X-Goog-Api-Key\`, and Codex uses \`%USERPROFILE%/.codex/config.toml\` with \`[mcp_servers.stitch]\`, \`type = "http"\`, \`url = "https://stitch.googleapis.com/mcp"\`, and \`X-Goog-Api-Key\`.
+6. If the built-in Codex provider succeeds on read-only calls but Stitch write operations stall, first verify the run actually uses \`codex exec --dangerously-bypass-approvals-and-sandbox\`; if the project overrides a custom Codex runner, that runner must also pass the same flag explicitly.
+7. Update skill documents and rebuild the index after meaningful changes.`));
+    }
+    generateExecutionProtocolTemplate(input) {
+        const language = input?.documentLanguage === 'en-US' ? 'en-US' : 'zh-CN';
+        return this.withFrontmatter({
+            name: 'execution-protocol',
+            title: this.copy(language, '执行协议', 'Execution Protocol'),
+            tags: ['execution', 'protocol', 'workflow'],
+        }, this.copy(language, `# 执行协议
+
+## 真正来源
+
+- \`.skillrc\`
+- \`changes/active/<change>/proposal.md\`
+- \`changes/active/<change>/tasks.md\`
+- \`changes/active/<change>/state.json\`
+- \`changes/active/<change>/verification.md\`
+
+## 规则
+
+项目级文档和分层技能文档用于承载长期知识。
+active change 文档用于承载当前实现工作。
+
+## 插件阻断
+
+- 先读取 \`.skillrc.plugins\`，判断是否存在启用中的阻断插件。
+- 如果当前 change 在 \`tasks.md\` 或 \`verification.md\` 中激活了 \`stitch_design_review\`，先检查 \`artifacts/stitch/approval.json\`。
+- 当 \`approval.json.status\` 不是 \`approved\` 时，不要把 change 视为可继续实现、可验证完成或可归档。
+- 如果涉及 Stitch provider、MCP 或认证配置，优先读取仓库内 Stitch 规范；若缺失规范文档，则使用内建基线：Gemini 用 \`%USERPROFILE%/.gemini/settings.json\` 的 \`mcpServers.stitch.httpUrl\` 与 \`headers.X-Goog-Api-Key\`，Codex 用 \`%USERPROFILE%/.codex/config.toml\` 的 \`[mcp_servers.stitch]\`、\`type = "http"\`、\`url = "https://stitch.googleapis.com/mcp"\` 与 \`X-Goog-Api-Key\`。
+- 如果内建 Codex provider 只读调用正常但 Stitch 写操作卡住，优先检查是否真正走了 \`codex exec --dangerously-bypass-approvals-and-sandbox\`；如果项目覆写了自定义 Codex runner，则该 runner 也必须显式带上这个参数。
+- 记录人工审批时，优先使用 \`ospec plugins approve stitch <change-path>\` 或 \`ospec plugins reject stitch <change-path>\`。`, `# Execution Protocol
+
+## Source of Truth
+
+- \`.skillrc\`
+- \`changes/active/<change>/proposal.md\`
+- \`changes/active/<change>/tasks.md\`
+- \`changes/active/<change>/state.json\`
+- \`changes/active/<change>/verification.md\`
+
+## Rule
+
+Use project-level docs and layered skill files for long-lived knowledge.
+Use active changes for current implementation work.
+
+## Plugin Gates
+
+- Read \`.skillrc.plugins\` first to detect enabled blocking plugins.
+- If the current change activates \`stitch_design_review\` in \`tasks.md\` or \`verification.md\`, inspect \`artifacts/stitch/approval.json\` before advancing the change.
+- When \`approval.json.status\` is not \`approved\`, do not treat the change as ready for continued implementation, completion claims, or archive readiness.
+- If Stitch provider, MCP, or auth config is involved, read the repo-local Stitch spec first; if the repo does not contain that spec, use the built-in baselines instead: Gemini uses \`%USERPROFILE%/.gemini/settings.json\` with \`mcpServers.stitch.httpUrl\` and \`headers.X-Goog-Api-Key\`, and Codex uses \`%USERPROFILE%/.codex/config.toml\` with \`[mcp_servers.stitch]\`, \`type = "http"\`, \`url = "https://stitch.googleapis.com/mcp"\`, and \`X-Goog-Api-Key\`.
+- If the built-in Codex provider succeeds on read-only calls but Stitch write operations stall, first verify the run actually uses \`codex exec --dangerously-bypass-approvals-and-sandbox\`; if the project overrides a custom Codex runner, that runner must also pass the same flag explicitly.
+- When recording manual review decisions, prefer \`ospec plugins approve stitch <change-path>\` or \`ospec plugins reject stitch <change-path>\`.`));
+    }
+    generateBuildIndexScriptTemplate() {
+        return `#!/usr/bin/env node
+
+const fs = require('fs-extra');
+const path = require('path');
+const yaml = require('js-yaml');
+
+const rootDir = process.cwd();
+const indexPath = path.join(rootDir, 'SKILL.index.json');
+const modules = {};
+const tagIndex = {};
+
+async function scan(dir) {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (['node_modules', 'dist', '.git', 'changes', 'for-ai'].includes(entry.name)) {
+        continue;
+      }
+      await scan(fullPath);
+      continue;
+    }
+
+    if (entry.name !== 'SKILL.md') {
+      continue;
+    }
+
+    const content = await fs.readFile(fullPath, 'utf8');
+    const relativePath = path.relative(rootDir, fullPath).replace(/\\\\/g, '/');
+    const frontmatterMatch = content.match(/^---\\n([\\s\\S]*?)\\n---/);
+    if (!frontmatterMatch) {
+      continue;
+    }
+
+    const frontmatter = yaml.load(frontmatterMatch[1]) || {};
+    const moduleName = frontmatter.name || relativePath;
+    const tags = Array.isArray(frontmatter.tags) ? frontmatter.tags : [];
+    const sections = {};
+    const headingRegex = /^(#{1,6})\\s+(.+?)$/gm;
+    let match;
+
+    while ((match = headingRegex.exec(content)) !== null) {
+      sections[match[2]] = {
+        level: match[1].length,
+        title: match[2],
+        start: match.index,
+        end: match.index + match[0].length,
+      };
+    }
+
+    modules[moduleName] = {
+      file: relativePath,
+      title: frontmatter.title || moduleName,
+      tags,
+      sections,
+    };
+
+    for (const tag of tags) {
+      if (!tagIndex[tag]) {
+        tagIndex[tag] = [];
+      }
+      tagIndex[tag].push(moduleName);
+    }
+  }
+}
+
+scan(rootDir)
+  .then(async () => {
+    const index = {
+      version: '1.0',
+      generated: new Date().toISOString(),
+      git_commit: null,
+      active_changes: [],
+      stats: {
+        totalFiles: Object.keys(modules).length,
+        totalModules: Object.keys(modules).length,
+        totalSections: Object.values(modules).reduce((count, module) => count + Object.keys(module.sections).length, 0),
+      },
+      modules,
+      tagIndex,
+    };
+
+    await fs.writeFile(indexPath, JSON.stringify(index, null, 2));
+    console.log('Index rebuilt:', indexPath);
+  })
+  .catch(error => {
+    console.error(error);
+    process.exit(1);
+  });
+`;
+    }
+    getProjectContext(fallbackName, mode, input) {
+        return this.inputs.normalizeProjectBootstrapInput(input, fallbackName, mode);
+    }
+    getPresetModuleSkillBody(context, moduleName, slug, refs) {
+        if (context.projectPresetId !== 'official-site') {
+            return null;
+        }
+        const moduleKey = slug.toLowerCase();
+        const docsLink = this.formatReferenceList(refs, this.copy(context.documentLanguage, '待补充', 'TBD'));
+        const relatedDocs = this.isEnglish(context.documentLanguage)
+            ? `- Module map: [../../../docs/project/module-map.md](../../../docs/project/module-map.md)
+- API overview: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
+- Bootstrap summary: [../../../docs/project/bootstrap-summary.md](../../../docs/project/bootstrap-summary.md)`
+            : `- 项目模块地图：[../../../docs/project/module-map.md](../../../docs/project/module-map.md)
+- API 总览：[../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
+- 初始化摘要：[../../../docs/project/bootstrap-summary.md](../../../docs/project/bootstrap-summary.md)`;
+        const templates = {
+            web: {
+                zh: `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块定位
+
+- 负责官网首页、全局导航和关键 CTA 的首屏体验
+- 串联 docs、blog、admin、login 等主入口
+- 承担品牌展示、信息分发和主站级布局约束
+
+## 主要职责
+
+- 维护首页、导航、页脚与站点级布局
+- 暴露首页到 docs/blog/admin/login 的稳定跳转关系
+- 与 content 模块协作，消费首屏展示所需的内容摘要
+
+## API 文档
+
+${docsLink}
+
+## 交付边界
+
+- 首页 Hero、功能区、入口区块和页脚属于 web 模块
+- 站点级路由编排、导航配置和营销内容组合属于 web 模块
+- 具体文档内容、博客内容、后台内容工作流不在此模块内部实现
+
+## 测试要求
+
+- 单元测试：导航配置、首页区块配置、入口卡片等静态装配逻辑
+- 集成测试：首页到 docs/blog/admin/login 的关键跳转与路由装配
+- 回归验证：主导航或首页结构调整后同步验证官网 MVP change
+
+## 关联文档
+
+${relatedDocs}`,
+                en: `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Positioning
+
+- Own the homepage, global navigation, and primary CTA experience
+- Connect docs, blog, admin, and login entry points
+- Hold brand presentation, information hierarchy, and site-wide layout constraints
+
+## Responsibilities
+
+- Maintain the homepage, navigation, footer, and global shell
+- Expose stable links from the homepage into docs, blog, admin, and login
+- Consume content summaries from the content module for marketing surfaces
+
+## API Docs
+
+${docsLink}
+
+## Delivery Boundaries
+
+- Hero, feature sections, entry cards, and footer belong to the web module
+- Site routing composition, navigation config, and marketing assembly belong here
+- Detailed docs/blog content and admin workflows do not live inside this module
+
+## Testing Requirements
+
+- Unit tests: navigation config, homepage section assembly, CTA cards
+- Integration tests: critical routing across home, docs, blog, admin, and login
+- Regression checks: validate the official-site MVP change after navigation updates
+
+## Related Docs
+
+${relatedDocs}`,
+            },
+            docs: {
+                zh: `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块定位
+
+- 负责文档中心的信息架构、目录层级与阅读入口
+- 承接从首页进入 docs 的主路径
+- 与 content 模块协作，定义文档内容的展示形态
+
+## 主要职责
+
+- 维护文档首页、文档侧边栏、分类入口和阅读页骨架
+- 定义文档版本、栏目、目录层级的呈现结构
+- 约束搜索、上一篇/下一篇、返回导航等阅读辅助能力
+
+## API 文档
+
+${docsLink}
+
+## 交付边界
+
+- 文档目录结构、阅读布局和导航关系由 docs 模块负责
+- 原始文档实体、发布状态和内容获取策略由 content 模块负责
+- 后台内容编辑能力由 admin 模块负责
+
+## 测试要求
+
+- 单元测试：目录映射、文档导航、阅读辅助逻辑
+- 集成测试：首页进入 docs、文档列表到文档详情的主链路
+- 回归验证：文档信息架构调整后同步验证导航与内容落点
+
+## 关联文档
+
+${relatedDocs}`,
+                en: `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Positioning
+
+- Own the docs-center information architecture, hierarchy, and reading entry points
+- Carry the primary route from the homepage into docs
+- Work with the content module to shape how documentation content is presented
+
+## Responsibilities
+
+- Maintain the docs home, sidebar, category entry points, and reading-page shell
+- Define the structure for versions, sections, and content hierarchy
+- Constrain search, prev/next navigation, and reading-assistance behavior
+
+## API Docs
+
+${docsLink}
+
+## Delivery Boundaries
+
+- Docs layout, reading shell, and navigation structure belong to this module
+- Source document entities and publication state belong to the content module
+- Admin editing flows belong to the admin module
+
+## Testing Requirements
+
+- Unit tests: hierarchy mapping, sidebar navigation, reading helpers
+- Integration tests: homepage-to-docs entry and docs-list-to-doc-detail flow
+- Regression checks: revalidate navigation and content placement after IA changes
+
+## Related Docs
+
+${relatedDocs}`,
+            },
+            content: {
+                zh: `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块定位
+
+- 负责官网内容模型、内容读取边界和发布状态
+- 为 web、docs、blog 与 admin 模块提供统一内容来源
+- 约束文档、博客、更新日志等内容实体的一致性
+
+## 主要职责
+
+- 定义 docs、blog、changelog、site settings 等核心内容实体
+- 管理草稿、已发布、预览等内容状态
+- 提供内容摘要、详情和列表所需的装配逻辑
+
+## API 文档
+
+${docsLink}
+
+## 交付边界
+
+- 内容实体、字段约束、slug、发布日期和标签等属于 content 模块
+- 页面视觉布局不在此模块内部完成
+- 后台编辑界面与审批流在 admin 模块中承接
+
+## 测试要求
+
+- 单元测试：内容模型映射、状态转换、列表/详情装配
+- 集成测试：docs/blog/changelog 的读取与预览链路
+- 回归验证：内容字段或状态机调整后同步验证页面消费方
+
+## 关联文档
+
+${relatedDocs}`,
+                en: `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Positioning
+
+- Own the official-site content model, delivery boundaries, and publication state
+- Serve as the shared content source for web, docs, blog, and admin surfaces
+- Keep documentation, blog, and changelog entities consistent
+
+## Responsibilities
+
+- Define docs, blog, changelog, and site-setting entities
+- Manage draft, published, and preview states
+- Provide the assembly logic behind content lists, summaries, and detail views
+
+## API Docs
+
+${docsLink}
+
+## Delivery Boundaries
+
+- Entities, field constraints, slugs, publish dates, and tags belong here
+- Visual page composition does not belong inside this module
+- Admin editing and approval flows are handled by the admin module
+
+## Testing Requirements
+
+- Unit tests: model mapping, state transitions, list/detail assembly
+- Integration tests: docs/blog/changelog delivery and preview flow
+- Regression checks: validate all consuming surfaces after schema changes
+
+## Related Docs
+
+${relatedDocs}`,
+            },
+            admin: {
+                zh: `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块定位
+
+- 负责官网内容管理后台、运营入口和内容发布操作台
+- 承接内容编辑、预览、发布与回滚相关工作流
+- 与 auth 模块协作，确保后台访问边界清晰
+
+## 主要职责
+
+- 维护后台首页、内容列表、内容编辑、发布操作入口
+- 定义后台所需的角色权限边界和操作日志关注点
+- 承接内容审核、发布、撤回和预览流程
+
+## API 文档
+
+${docsLink}
+
+## 交付边界
+
+- admin 模块只负责后台工作流与管理入口，不负责公开站点渲染
+- 内容实体本身由 content 模块负责
+- 登录、会话与鉴权校验由 auth 模块负责
+
+## 测试要求
+
+- 单元测试：后台菜单、内容状态动作、操作约束
+- 集成测试：登录后进入后台、编辑内容、预览和发布链路
+- 回归验证：权限边界与内容状态切换需要与 auth/content 同步验证
+
+## 关联文档
+
+${relatedDocs}`,
+                en: `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Positioning
+
+- Own the admin workspace, operator entry points, and publishing console
+- Carry editing, preview, publish, and rollback workflows
+- Work with the auth module to keep admin access boundaries explicit
+
+## Responsibilities
+
+- Maintain the admin home, content list, editor flow, and publish actions
+- Define role-sensitive boundaries and operator-facing audit concerns
+- Handle review, publish, rollback, and preview steps
+
+## API Docs
+
+${docsLink}
+
+## Delivery Boundaries
+
+- This module owns the admin workflow and management surface, not public rendering
+- Content entities themselves belong to the content module
+- Login/session enforcement belongs to the auth module
+
+## Testing Requirements
+
+- Unit tests: menu config, content-state actions, admin guard behavior
+- Integration tests: login-to-admin, edit-to-preview, and publish flow
+- Regression checks: validate auth/content boundaries after workflow changes
+
+## Related Docs
+
+${relatedDocs}`,
+            },
+            auth: {
+                zh: `# ${moduleName} 模块
+
+> 层级：第 3 层（业务模块文档）
+> 上层：[src/SKILL.md](../../SKILL.md)
+
+## 模块定位
+
+- 负责官网登录、会话状态和后台访问保护
+- 为 admin 模块提供权限门禁，为 web 模块提供登录入口
+- 统一处理用户身份、重定向与会话校验
+
+## 主要职责
+
+- 登录页、退出登录、会话恢复和路由守卫
+- 后台入口鉴权、未登录跳转和基础角色判断
+- 与 auth api 协作，落地会话创建、读取和销毁
+
+## API 文档
+
+${docsLink}
+
+## 交付边界
+
+- 登录流程、会话状态、守卫逻辑属于 auth 模块
+- 用户内容资料和运营内容不在此模块内部维护
+- 更复杂的 RBAC 与多组织模型不属于官网初始化范围
+
+## 测试要求
+
+- 单元测试：会话状态、守卫逻辑、登录跳转
+- 集成测试：login -> admin、会话失效 -> 重定向、退出登录链路
+- 回归验证：权限边界变化后同步验证 admin 页面可达性
+
+## 关联文档
+
+${relatedDocs}`,
+                en: `# ${moduleName}
+
+> Layer: module document
+> Parent: [src/SKILL.md](../../SKILL.md)
+
+## Module Positioning
+
+- Own login, session state, and admin access protection
+- Provide admin gating for the admin module and login entry points for the web module
+- Centralize identity, redirects, and session validation
+
+## Responsibilities
+
+- Login/logout flows, session restore, and route guards
+- Admin access checks, unauthenticated redirects, and basic role handling
+- Integrate with the auth API for session create/read/destroy flows
+
+## API Docs
+
+${docsLink}
+
+## Delivery Boundaries
+
+- Login flow, session state, and guard logic belong to this module
+- User profile content and editorial content do not belong here
+- Advanced RBAC or multi-tenant models are out of scope for bootstrap
+
+## Testing Requirements
+
+- Unit tests: session state, guard logic, redirect behavior
+- Integration tests: login-to-admin, expired-session redirect, logout flow
+- Regression checks: revalidate admin reachability after auth-boundary changes
+
+## Related Docs
+
+${relatedDocs}`,
+            },
+        };
+        const template = templates[moduleKey];
+        if (!template) {
+            return null;
+        }
+        return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
+    }
+    getPresetApiAreaDocBody(context, apiAreaName) {
+        if (context.projectPresetId !== 'official-site') {
+            return null;
+        }
+        const key = apiAreaName.trim().toLowerCase();
+        const templates = {
+            'content api': {
+                zh: `# ${apiAreaName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 边界说明
+
+- 提供 docs、blog、changelog、站点配置等内容读取能力
+- 区分公开读取、预览读取和后台内容操作的接口边界
+- 维护 slug、发布时间、标签、草稿态等内容语义
+
+## 建议接口分组
+
+- 内容列表：docs / blog / changelog 列表与筛选
+- 内容详情：按 slug 获取详情、相邻内容、关联内容
+- 预览接口：供 admin 模块预览草稿内容
+- 站点配置：导航、页脚、公告位等站点级内容
+
+## 待补充清单
+
+- [ ] 路由列表
+- [ ] 请求/响应结构
+- [ ] 预览权限与缓存策略
+- [ ] 测试与验收要求`,
+                en: `# ${apiAreaName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Boundary
+
+- Provide content delivery for docs, blog, changelog, and site settings
+- Separate public delivery, preview delivery, and admin-side content operations
+- Own slugs, publication dates, tags, and draft/published semantics
+
+## Suggested Interface Groups
+
+- Content lists: docs/blog/changelog list and filtering
+- Content detail: fetch by slug with adjacent/related content
+- Preview interfaces: allow admin previews for draft content
+- Site settings: navigation, footer, and announcement content
+
+## Checklist
+
+- [ ] Routes
+- [ ] Request / response payloads
+- [ ] Preview permissions and cache strategy
+- [ ] Tests and acceptance requirements`,
+            },
+            'auth api': {
+                zh: `# ${apiAreaName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 边界说明
+
+- 提供登录、会话读取、退出登录与后台访问鉴权能力
+- 为 admin 页面和登录页提供统一的身份状态接口
+- 约束未登录跳转、会话失效与基础角色判定
+
+## 建议接口分组
+
+- 登录接口：用户名/邮箱 + 密码或其他登录方式
+- 会话接口：当前会话读取、刷新、失效处理
+- 退出接口：会话销毁、清理与跳转
+- 后台守卫：校验是否允许进入 admin 相关页面
+
+## 待补充清单
+
+- [ ] 路由列表
+- [ ] 请求/响应结构
+- [ ] Cookie / token 策略
+- [ ] 测试与验收要求`,
+                en: `# ${apiAreaName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Boundary
+
+- Provide login, session read, logout, and admin-access enforcement
+- Expose a shared identity surface for admin pages and login flows
+- Define unauthenticated redirects, session expiry handling, and basic role checks
+
+## Suggested Interface Groups
+
+- Login: username/email and credential entry
+- Session: read, refresh, and expiry handling
+- Logout: session destroy and redirect behavior
+- Admin guards: verify whether admin access is allowed
+
+## Checklist
+
+- [ ] Routes
+- [ ] Request / response payloads
+- [ ] Cookie / token strategy
+- [ ] Tests and acceptance requirements`,
+            },
+            'admin api': {
+                zh: `# ${apiAreaName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 边界说明
+
+- 提供内容管理后台所需的编辑、发布、回滚和预览操作接口
+- 衔接 admin 模块的操作台与 content 模块的内容模型
+- 记录后台动作的权限边界和审核要求
+
+## 建议接口分组
+
+- 内容管理：创建、更新、删除、归档内容
+- 状态流转：草稿、送审、发布、撤回
+- 预览入口：生成预览链接和预览上下文
+- 操作审计：关键操作日志、操作者信息、发布时间
+
+## 待补充清单
+
+- [ ] 路由列表
+- [ ] 请求/响应结构
+- [ ] 权限与审核规则
+- [ ] 测试与验收要求`,
+                en: `# ${apiAreaName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Boundary
+
+- Provide the edit, publish, rollback, and preview actions needed by the admin workspace
+- Connect the admin workspace to the content model owned by the content module
+- Define permission boundaries and approval expectations for operator actions
+
+## Suggested Interface Groups
+
+- Content management: create, update, delete, and archive content
+- State transitions: draft, review, publish, and unpublish
+- Preview entry: create preview links and preview context
+- Audit trail: operator identity, timestamps, and action logs
+
+## Checklist
+
+- [ ] Routes
+- [ ] Request / response payloads
+- [ ] Permissions and review rules
+- [ ] Tests and acceptance requirements`,
+            },
+        };
+        const template = templates[key];
+        if (!template) {
+            return null;
+        }
+        return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
+    }
+    getPresetModuleApiDocBody(context, moduleName, slug) {
+        if (context.projectPresetId !== 'official-site') {
+            return null;
+        }
+        const docs = {
+            web: {
+                zh: `# ${moduleName} Module API
+
+## 项目
+
+- **项目名称**：${context.projectName}
+- **模块名**：${moduleName}
+- **模块路径**：src/modules/${slug}
+
+## 对外接口
+
+- 导航配置：站点主导航、页脚导航、首页入口卡片
+- 首页编排：Hero、能力介绍、内容入口、CTA 区块装配
+- 页面装配：首页对 docs/blog/admin/login 的路由出口
+
+## 依赖关系
+
+- 上游依赖：content 模块提供内容摘要，auth 模块提供登录态入口信息
+- 下游调用方：app/page.tsx、全局布局、站点导航组件
+- 共享依赖：路由常量、站点配置、内容摘要类型
+
+## 测试要求
+
+- 单元测试：导航配置、首页区块装配
+- 集成测试：首页到 docs/blog/admin/login 的跳转
+- 回归验证：站点入口调整后校验官网 MVP 主链路`,
+                en: `# ${moduleName} Module API
+
+## Project
+
+- **Project**: ${context.projectName}
+- **Module**: ${moduleName}
+- **Module path**: src/modules/${slug}
+
+## Public Interface
+
+- Navigation config: primary nav, footer nav, homepage entry cards
+- Homepage composition: hero, capability sections, content entry blocks, CTA assembly
+- Route composition: public exit points into docs, blog, admin, and login
+
+## Dependencies
+
+- Upstream: content summaries from the content module, auth entry signals from auth
+- Downstream consumers: app/page.tsx, global shell, navigation components
+- Shared dependencies: route constants, site config, content summary types
+
+## Testing Requirements
+
+- Unit tests: navigation config and homepage section assembly
+- Integration tests: home-to-docs/blog/admin/login routing
+- Regression checks: validate the official-site MVP flow after shell updates`,
+            },
+        };
+        const template = docs[slug.toLowerCase()];
+        if (!template) {
+            return null;
+        }
+        return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
+    }
+    getPresetDesignDocBody(context, docName) {
+        if (context.projectPresetId !== 'official-site') {
+            return null;
+        }
+        const key = docName.trim().toLowerCase();
+        const isChinese = !this.isEnglish(context.documentLanguage);
+        if (['ui information architecture', '界面信息架构'].includes(key)) {
+            return isChinese
+                ? `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 设计目标
+
+- 明确官网首页、docs、blog、admin、login 五个主入口的页面关系
+- 明确首页到各内容面的导航层级和返回路径
+- 保证营销展示、文档阅读、后台运营三种体验的边界清晰
+
+## 核心页面
+
+- 首页：品牌表达、核心能力、主入口导航
+- docs：文档中心首页、分类页、文档阅读页
+- blog：博客/更新日志列表与详情
+- admin：内容管理后台首页、内容列表、编辑与发布入口
+- login：登录与会话恢复入口
+
+## 待验证问题
+
+- 顶部导航与侧边导航如何避免重复信息
+- docs/blog/admin 三个入口的优先级如何表达
+- 未登录访问 admin 时的跳转与返回路径如何设计`
+                : `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Design Goals
+
+- Define the relationship across home, docs, blog, admin, and login
+- Clarify the navigation hierarchy from the homepage into each content surface
+- Keep marketing, reading, and admin experiences clearly separated
+
+## Core Surfaces
+
+- Home: brand expression, key capabilities, primary entry navigation
+- Docs: docs home, category pages, reading pages
+- Blog: changelog/blog list and detail views
+- Admin: dashboard, content list, editor, and publish entry
+- Login: login and session-restore entry
+
+## Open Validation Questions
+
+- How should top navigation and sidebar navigation avoid duplicate signals?
+- How should docs/blog/admin priority be communicated from the homepage?
+- What should the admin redirect and return path look like for unauthenticated users?`;
+        }
+        if (['content model', '内容模型'].includes(key)) {
+            return isChinese
+                ? `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 设计目标
+
+- 统一官网 docs、blog、changelog 与站点配置的内容实体
+- 明确草稿、预览、已发布等状态语义
+- 为后台内容管理与公开站点消费提供稳定字段约束
+
+## 核心实体
+
+- DocPage：文档页面、目录、版本、slug
+- BlogPost：博客/更新日志文章、摘要、发布时间、标签
+- SiteConfig：导航、页脚、公告位、首页重点内容
+- Author / Tag：作者与标签等复用内容
+
+## 关键约束
+
+- 所有公开内容都必须具备 slug、状态、最后更新时间
+- 预览内容不能被公开缓存
+- docs 与 blog 虽可共用字段，但必须保留独立内容类型`
+                : `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Design Goals
+
+- Unify docs, blog, changelog, and site-setting entities for the official site
+- Define draft, preview, and published semantics
+- Provide stable field constraints for both admin workflows and public rendering
+
+## Core Entities
+
+- DocPage: document page, hierarchy, version, slug
+- BlogPost: blog/changelog post, summary, publish date, tags
+- SiteConfig: navigation, footer, announcement slots, homepage highlights
+- Author / Tag: reusable author and taxonomy entities
+
+## Key Constraints
+
+- Every public content entity must have slug, status, and last-updated metadata
+- Preview content must never be publicly cached
+- Docs and blog may share fields, but must remain separate content types`;
+        }
+        if (['cms workflow', 'cms 工作流'].includes(key)) {
+            return isChinese
+                ? `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 设计目标
+
+- 规范后台内容从创建到发布的最小可演示流程
+- 明确编辑、预览、送审、发布、撤回之间的状态转换
+- 保证后台动作与公开站点的内容可见性一致
+
+## 工作流阶段
+
+- 草稿：编辑中，仅后台可见
+- 预览：生成预览上下文，供内部确认
+- 待发布：内容已冻结，等待操作人确认
+- 已发布：公开站点可见
+- 已撤回：公开站点不可见，但保留历史记录
+
+## 验证重点
+
+- 后台操作是否正确驱动 content 状态变化
+- 预览内容是否与公开内容严格隔离
+- 发布和撤回后首页、docs、blog 是否同步更新`
+                : `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Design Goals
+
+- Define the smallest demonstrable editorial flow from creation to publish
+- Make the transitions between edit, preview, review, publish, and rollback explicit
+- Keep admin actions and public-site visibility consistent
+
+## Workflow Stages
+
+- Draft: editable and admin-only
+- Preview: generates internal preview context
+- Ready to publish: content is frozen and awaiting operator confirmation
+- Published: publicly visible
+- Unpublished / rolled back: hidden from the public site with history retained
+
+## Validation Focus
+
+- Whether admin actions correctly drive content-state transitions
+- Whether preview content remains isolated from public delivery
+- Whether home/docs/blog refresh consistently after publish and rollback`;
+        }
+        return null;
+    }
+    getPresetPlanningDocBody(context, docName) {
+        if (context.projectPresetId !== 'official-site') {
+            return null;
+        }
+        const key = docName.trim().toLowerCase();
+        const isChinese = !this.isEnglish(context.documentLanguage);
+        if (['delivery plan', '交付计划'].includes(key)) {
+            return isChinese
+                ? `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 规划目标
+
+- 先完成官网 MVP 的页面骨架、内容链路和后台入口
+- 再补齐内容工作流、鉴权与上线准备
+
+## 建议里程碑
+
+- M1：首页、docs、blog、admin、login 五个入口可达
+- M2：content 模型与 content api 成型，docs/blog 能读取内容
+- M3：admin 工作台支持预览、发布与回滚的最小链路
+- M4：上线检查清单完成，进入发布准备
+
+## 风险与依赖
+
+- 内容模型与页面结构若先后失配，会导致前后端重复返工
+- admin 与 auth 边界若过晚定义，会影响后台主链路联调
+- SEO、分析、部署等上线项不能拖到最后才补`
+                : `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Planning Goal
+
+- Deliver the official-site MVP shell, content flow, and admin entry first
+- Then harden content workflow, auth, and launch readiness
+
+## Suggested Milestones
+
+- M1: home, docs, blog, admin, and login entry points are all reachable
+- M2: content model and content API are in place for docs/blog delivery
+- M3: admin supports the minimum preview/publish/rollback loop
+- M4: launch checklist is complete and release prep begins
+
+## Risks and Dependencies
+
+- If content modeling and page structure drift apart, rework will multiply
+- If admin/auth boundaries are delayed, the operator flow will stall
+- SEO, analytics, and deployment tasks cannot be postponed to the very end`;
+        }
+        if (['launch checklist', '上线检查清单'].includes(key)) {
+            return isChinese
+                ? `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 检查目标
+
+- 在官网发布前统一检查内容、导航、后台、鉴权和基础运维准备
+
+## 上线前检查项
+
+- [ ] 首页、docs、blog、admin、login 五个入口均可访问
+- [ ] docs/blog 的内容来源、slug 和 SEO 基础字段已检查
+- [ ] admin 登录、会话恢复、退出登录链路可用
+- [ ] 预览内容不会被公开访问或缓存
+- [ ] 关键页面具备基础埋点、错误页和空态处理
+- [ ] 发布与回滚流程经过至少一轮 smoke 验证`
+                : `# ${docName}
+
+## Project
+
+- **Project**: ${context.projectName}
+
+## Checklist Goal
+
+- Align content, navigation, admin, auth, and operational readiness before launch
+
+## Pre-launch Checks
+
+- [ ] Home, docs, blog, admin, and login entry points are reachable
+- [ ] docs/blog content source, slug rules, and base SEO fields are reviewed
+- [ ] admin login, session restore, and logout flows work correctly
+- [ ] Preview content is never publicly reachable or cached
+- [ ] Key pages have baseline analytics, empty states, and error handling
+- [ ] Publish and rollback have passed at least one smoke validation round`;
+        }
+        return null;
+    }
+    slugify(value) {
+        return value
+            .toLowerCase()
+            .replace(/\.md$/i, '')
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-+|-+$/g, '');
+    }
+}
+exports.ProjectTemplateBuilder = ProjectTemplateBuilder;
+//# sourceMappingURL=ProjectTemplateBuilder.js.map