@clawplays/ospec-cli 0.3.2 → 0.3.4

package/dist/services/templates/ProjectTemplateBuilder.js

@@ -10,8 +10,30 @@ class ProjectTemplateBuilder extends TemplateBuilderBase_1.TemplateBuilderBase {
     }
     generateProjectReadmeTemplate(fallbackName, mode, input) {
         const context = this.getProjectContext(fallbackName, mode, input);
-        if (this.isEnglish(context.documentLanguage)) {
-            return `# ${context.projectName}
+        return this.copy(context.documentLanguage, `# ${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>\`。
+`, `# ${context.projectName}
 
 > Generated by OSpec CLI
 
@@ -34,37 +56,87 @@ ${context.summary}
 ## Execution
 
 Active changes live under \`changes/active/<change>\`.
-`;
-        }
-        return `# ${context.projectName}
+`, `# ${context.projectName}
 
-> 由 OSpec CLI 初始化生成
+> OSpec CLI により生成
 
 ## OSpec Bootstrap
 
-当前仓库已按 \`${mode}\` 模式完成 OSpec 初始化。
+このリポジトリは OSpec の \`${mode}\` モードで初期化されました。
 
-## 项目简介
+## 概要
 
 ${context.summary}
 
-## 项目知识层
+## プロジェクト知識
 
-- 根技能文档：\`SKILL.md\`
-- 文档中心：\`docs/SKILL.md\`
-- 源码地图：\`src/SKILL.md\`
-- 测试说明：\`tests/SKILL.md\`
-- 语义索引：\`SKILL.index.json\`
+- ルート SKILL: \`SKILL.md\`
+- docs ハブ: \`docs/SKILL.md\`
+- ソースマップ: \`src/SKILL.md\`
+- テストガイド: \`tests/SKILL.md\`
+- インデックス: \`SKILL.index.json\`
 
-## 执行层
+## 実行レイヤー
 
-Active change 位于 \`changes/active/<change>\`。
-`;
+active change は \`changes/active/<change>\` にあります。
+`, `# ${context.projectName}
+
+> تم توليده بواسطة OSpec CLI
+
+## OSpec Bootstrap
+
+تمت تهيئة هذا المستودع بواسطة OSpec في وضع \`${mode}\`.
+
+## الملخص
+
+${context.summary}
+
+## معرفة المشروع
+
+- ملف SKILL الجذري: \`SKILL.md\`
+- مركز docs: \`docs/SKILL.md\`
+- خريطة المصدر: \`src/SKILL.md\`
+- دليل الاختبارات: \`tests/SKILL.md\`
+- الفهرس: \`SKILL.index.json\`
+
+## طبقة التنفيذ
+
+توجد التغييرات النشطة تحت \`changes/active/<change>\` .
+`);
     }
     generateRootSkillTemplate(fallbackName, mode, input) {
         const context = this.getProjectContext(fallbackName, mode, input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# ${context.projectName}
+        const body = this.copy(context.documentLanguage, `# ${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 仍被阻断，先完成设计审核再继续。`, `# ${context.projectName}
 
 > Layer: project root
 
@@ -94,48 +166,89 @@ ${context.architecture}
 
 - 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}
+- 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}
+- **プロジェクト**: ${context.projectName}
+- **モード**: ${mode}
+- **状態**: OSpec により初期化済み
+- **概要**: ${context.summary}
 
-## 技术栈
+## 技術スタック
 
-${this.formatList(context.techStack, '待补充')}
+${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)
+- docs ハブ: [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 仍被阻断，先完成设计审核再继续。`;
+- active change を進める前に \`.skillrc\` を読む。
+- Stitch が有効で、現在の change が \`stitch_design_review\` を有効化している場合は \`changes/active/<change>/artifacts/stitch/approval.json\` を確認する。
+- Stitch 承認がない、または状態が \`approved\` でない場合は、デザインレビュー完了まで change をブロックされたものとして扱う。`, `# ${context.projectName}
+
+> الطبقة: جذر المشروع
+
+## نظرة عامة على المشروع
+
+- **المشروع**: ${context.projectName}
+- **النمط**: ${mode}
+- **الحالة**: تمت تهيئته بواسطة OSpec
+- **الملخص**: ${context.summary}
+
+## المكدس التقني
+
+${this.formatList(context.techStack, 'قيد التحديد')}
+
+## المعمارية
+
+${context.architecture}
+
+## التنقل
+
+- مركز docs: [docs/SKILL.md](docs/SKILL.md)
+- خريطة المصدر: [src/SKILL.md](src/SKILL.md)
+- دليل الاختبارات: [tests/SKILL.md](tests/SKILL.md)
+- دليل الذكاء الاصطناعي: [for-ai/ai-guide.md](for-ai/ai-guide.md)
+
+## بوابات الإضافات
+
+- اقرأ \`.skillrc\` قبل متابعة أي change نشط.
+- إذا كان 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`),
+            title: this.copy(context.documentLanguage, context.projectName, `${context.projectName} Project`, `${context.projectName} プロジェクト`, `${context.projectName} المشروع`),
             tags: ['ospec', 'project', mode],
         }, body);
     }
     generateDocsSkillTemplate(fallbackName, input) {
         const context = this.getProjectContext(fallbackName, 'standard', input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Documentation Hub
+        const body = this.copy(context.documentLanguage, `# 文档中心
+
+> 层级：第 2 层（项目文档索引）
+
+## 文档导航
+
+- 项目概览：[project/overview.md](project/overview.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)`, `# Documentation Hub
 
 > Layer: docs index
 
@@ -148,24 +261,36 @@ ${context.architecture}
 - 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)`
-            : `# 文档中心
+- API docs: [api/README.md](api/README.md)`, `# ドキュメントハブ
 
-> 层级：第 2 层（项目文档索引）
+> レイヤー: docs インデックス
 
-## 文档导航
+## ナビゲーション
 
-- 项目概览：[project/overview.md](project/overview.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)`;
+- プロジェクト概要: [project/overview.md](project/overview.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)`, `# مركز الوثائق
+
+> الطبقة: فهرس docs
+
+## التنقل
+
+- نظرة عامة على المشروع: [project/overview.md](project/overview.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`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 文档中心`, `${context.projectName} Docs Hub`, `${context.projectName} ドキュメントハブ`, `${context.projectName} مركز الوثائق`),
             tags: ['docs', 'project', 'planning', 'api'],
         }, body);
     }
@@ -174,9 +299,19 @@ ${context.architecture}
         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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# 源码地图
+
+> 层级：第 2 层（源码索引）
+
+## 目录导航
+
+- 核心层：[core/SKILL.md](core/SKILL.md)
+- 模块层：\`src/modules/<module>/SKILL.md\`
+
+## 模块说明
+
+${moduleLinks}`, `# Source Map
 
 > Layer: source index
 
@@ -187,29 +322,51 @@ ${context.architecture}
 
 ## Modules
 
-${moduleLinks}`
-            : `# 源码地图
+${moduleLinks}`, `# ソースマップ
 
-> 层级：第 2 层（源码索引）
+> レイヤー: ソースインデックス
 
-## 目录导航
+## ナビゲーション
 
-- 核心层：[core/SKILL.md](core/SKILL.md)
-- 模块层：\`src/modules/<module>/SKILL.md\`
+- コア層: [core/SKILL.md](core/SKILL.md)
+- モジュール層: \`src/modules/<module>/SKILL.md\`
 
-## 模块说明
+## モジュール
+
+${moduleLinks}`, `# خريطة المصدر
+
+> الطبقة: فهرس المصدر
+
+## التنقل
+
+- الطبقة الأساسية: [core/SKILL.md](core/SKILL.md)
+- طبقة الوحدات: \`src/modules/<module>/SKILL.md\`
 
-${moduleLinks}`;
+## الوحدات
+
+${moduleLinks}`);
         return this.withFrontmatter({
             name: 'src',
-            title: this.copy(context.documentLanguage, `${context.projectName} 源码地图`, `${context.projectName} Source Map`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 源码地图`, `${context.projectName} Source Map`, `${context.projectName} ソースマップ`, `${context.projectName} خريطة المصدر`),
             tags: ['src', 'modules', 'architecture'],
         }, body);
     }
     generateCoreSkillTemplate(fallbackName, input) {
         const context = this.getProjectContext(fallbackName, 'standard', input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Core Layer
+        const body = this.copy(context.documentLanguage, `# Core 核心层
+
+> 层级：第 3 层（核心模块）
+> 上层：[src/SKILL.md](../SKILL.md)
+
+## 模块概述
+
+- **职责**：承载项目级公共能力
+- **位置**：src/core/
+- **依赖**：待补充
+
+## API 文档
+
+- 项目 API 总览：[../../docs/project/api-overview.md](../../docs/project/api-overview.md)`, `# Core Layer
 
 > Layer: core module
 > Parent: [src/SKILL.md](../SKILL.md)
@@ -222,54 +379,89 @@ ${moduleLinks}`;
 
 ## API Docs
 
-- Project API overview: [../../docs/project/api-overview.md](../../docs/project/api-overview.md)`
-            : `# Core 核心层
+- Project API overview: [../../docs/project/api-overview.md](../../docs/project/api-overview.md)`, `# コア層
 
-> 层级：第 3 层（核心模块）
-> 上层：[src/SKILL.md](../SKILL.md)
+> レイヤー: コアモジュール
+> 親: [src/SKILL.md](../SKILL.md)
 
-## 模块概述
+## モジュール概要
 
-- **职责**：承载项目级公共能力
-- **位置**：src/core/
-- **依赖**：待补充
+- **役割**: 共通ランタイムおよび基盤機能
+- **パス**: src/core/
+- **依存関係**: 未定
 
-## API 文档
+## API 文書
+
+- プロジェクト API 概要: [../../docs/project/api-overview.md](../../docs/project/api-overview.md)`, `# الطبقة الأساسية
+
+> الطبقة: الوحدة الأساسية
+> الأصل: [src/SKILL.md](../SKILL.md)
+
+## نظرة عامة على الوحدة
+
+- **الدور**: القدرات المشتركة للتشغيل والبنية التحتية
+- **المسار**: src/core/
+- **الاعتماديات**: قيد التحديد
 
-- 项目 API 总览：[../../docs/project/api-overview.md](../../docs/project/api-overview.md)`;
+## وثائق 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`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 核心层`, `${context.projectName} Core Layer`, `${context.projectName} コア層`, `${context.projectName} الطبقة الأساسية`),
             tags: ['core', 'runtime', 'infrastructure'],
         }, body);
     }
     generateTestsSkillTemplate(fallbackName, input) {
         const context = this.getProjectContext(fallbackName, 'standard', input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Test Guide
+        const body = this.copy(context.documentLanguage, `# 测试说明
+
+## 测试策略
+
+- 单元测试：待补充
+- 集成测试：待补充
+- 端到端测试：待补充`, `# Test Guide
 
 ## Test Strategy
 
 - Unit tests: TBD
 - Integration tests: TBD
-- End-to-end tests: TBD`
-            : `# 测试说明
+- End-to-end tests: TBD`, `# テストガイド
 
-## 测试策略
+## テスト戦略
 
-- 单元测试：待补充
-- 集成测试：待补充
-- 端到端测试：待补充`;
+- 単体テスト: 未定
+- 統合テスト: 未定
+- エンドツーエンドテスト: 未定`, `# دليل الاختبارات
+
+## استراتيجية الاختبار
+
+- اختبارات الوحدة: قيد التحديد
+- اختبارات التكامل: قيد التحديد
+- اختبارات طرف إلى طرف: قيد التحديد`);
         return this.withFrontmatter({
             name: 'tests',
-            title: this.copy(context.documentLanguage, `${context.projectName} 测试说明`, `${context.projectName} Test Guide`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 测试说明`, `${context.projectName} Test Guide`, `${context.projectName} テストガイド`, `${context.projectName} دليل الاختبارات`),
             tags: ['tests', 'quality', 'verification'],
         }, body);
     }
     generateProjectOverviewTemplate(fallbackName, mode, input) {
         const context = this.getProjectContext(fallbackName, mode, input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Project Overview
+        const body = this.copy(context.documentLanguage, `# 项目概览
+
+## 背景
+
+\`${context.projectName}\` 已通过 OSpec CLI 初始化，当前模式为 \`${mode}\`。
+
+## 项目简介
+
+${context.summary}
+
+## 当前目标
+
+- 保持项目知识文档与仓库真实状态一致
+- 建立分层 SKILL 体系
+- 使用 change workflow 管理需求交付`, `# Project Overview
 
 ## Background
 
@@ -283,32 +475,52 @@ ${context.summary}
 
 - Keep the project knowledge docs aligned with the real repository state
 - Establish layered skill files
-- Manage delivery through the change workflow`
-            : `# 项目概览
+- Manage delivery through the change workflow`, `# プロジェクト概要
 
 ## 背景
 
-\`${context.projectName}\` 已通过 OSpec CLI 初始化，当前模式为 \`${mode}\`。
+\`${context.projectName}\` は OSpec CLI により \`${mode}\` モードで初期化されました。
 
-## 项目简介
+## 概要
 
 ${context.summary}
 
-## 当前目标
+## 現在の目標
 
-- 保持项目知识文档与仓库真实状态一致
-- 建立分层 SKILL 体系
-- 使用 change workflow 管理需求交付`;
+- プロジェクト知識文書を実際のリポジトリ状態と一致させる
+- レイヤー化された SKILL を整備する
+- change workflow で要件の実行を管理する`, `# نظرة عامة على المشروع
+
+## الخلفية
+
+تمت تهيئة \`${context.projectName}\` بواسطة OSpec CLI في وضع \`${mode}\`.
+
+## الملخص
+
+${context.summary}
+
+## الأهداف الحالية
+
+- إبقاء وثائق معرفة المشروع متوافقة مع الحالة الفعلية للمستودع
+- تأسيس ملفات SKILL متعددة الطبقات
+- إدارة التسليم عبر change workflow`);
         return this.withFrontmatter({
             name: 'project-overview',
-            title: this.copy(context.documentLanguage, `${context.projectName} 项目概览`, `${context.projectName} Project Overview`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 项目概览`, `${context.projectName} Project Overview`, `${context.projectName} プロジェクト概要`, `${context.projectName} نظرة عامة على المشروع`),
             tags: ['project', 'overview', 'bootstrap'],
         }, body);
     }
     generateTechStackTemplate(fallbackName, input) {
         const context = this.getProjectContext(fallbackName, 'standard', input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Tech Stack
+        const body = this.copy(context.documentLanguage, `# 技术栈
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 技术栈清单
+
+${this.formatList(context.techStack, '待补充')}`, `# Tech Stack
 
 ## Project
 
@@ -316,26 +528,46 @@ ${context.summary}
 
 ## Stack List
 
-${this.formatList(context.techStack, 'TBD')}`
-            : `# 技术栈
+${this.formatList(context.techStack, 'TBD')}`, `# 技術スタック
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 技术栈清单
+## スタック一覧
+
+${this.formatList(context.techStack, '未定')}`, `# المكدس التقني
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## قائمة المكدس
 
-${this.formatList(context.techStack, '待补充')}`;
+${this.formatList(context.techStack, 'قيد التحديد')}`);
         return this.withFrontmatter({
             name: 'tech-stack',
-            title: this.copy(context.documentLanguage, `${context.projectName} 技术栈`, `${context.projectName} Tech Stack`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 技术栈`, `${context.projectName} Tech Stack`, `${context.projectName} 技術スタック`, `${context.projectName} المكدس التقني`),
             tags: ['project', 'tech-stack', 'architecture'],
         }, body);
     }
     generateArchitectureTemplate(fallbackName, input) {
         const context = this.getProjectContext(fallbackName, 'standard', input);
-        const body = this.isEnglish(context.documentLanguage)
-            ? `# Architecture
+        const body = this.copy(context.documentLanguage, `# 架构说明
+
+## 整体架构
+
+- **项目**：${context.projectName}
+- **当前阶段**：已建立 OSpec 项目知识骨架
+
+${context.architecture}
+
+## 分层说明
+
+- Project Knowledge
+- Layered Skills
+- Execution
+- GUI`, `# Architecture
 
 ## System Architecture
 
@@ -349,25 +581,38 @@ ${context.architecture}
 - Project Knowledge
 - Layered Skills
 - Execution
-- GUI`
-            : `# 架构说明
+- GUI`, `# アーキテクチャ
 
-## 整体架构
+## システムアーキテクチャ
 
-- **项目**：${context.projectName}
-- **当前阶段**：已建立 OSpec 项目知识骨架
+- **プロジェクト**: ${context.projectName}
+- **現在の段階**: OSpec の知識骨格を初期化済み
 
 ${context.architecture}
 
-## 分层说明
+## レイヤー
 
 - Project Knowledge
 - Layered Skills
 - Execution
-- GUI`;
+- 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`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 架构说明`, `${context.projectName} Architecture`, `${context.projectName} アーキテクチャ`, `${context.projectName} المعمارية`),
             tags: ['project', 'architecture', 'layers'],
         }, body);
     }
@@ -376,9 +621,16 @@ ${context.architecture}
         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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# 模块地图
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 模块列表
+
+${modules}`, `# Module Map
 
 ## Project
 
@@ -386,19 +638,26 @@ ${context.architecture}
 
 ## Modules
 
-${modules}`
-            : `# 模块地图
+${modules}`, `# モジュールマップ
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 模块列表
+## モジュール
+
+${modules}`, `# خريطة الوحدات
 
-${modules}`;
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## الوحدات
+
+${modules}`);
         return this.withFrontmatter({
             name: 'module-map',
-            title: this.copy(context.documentLanguage, `${context.projectName} 模块地图`, `${context.projectName} Module Map`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 模块地图`, `${context.projectName} Module Map`, `${context.projectName} モジュールマップ`, `${context.projectName} خريطة الوحدات`),
             tags: ['project', 'modules', 'map'],
         }, body);
     }
@@ -407,13 +666,24 @@ ${modules}`;
         const apiAreas = this.formatLinkedList(context.apiAreaPlans.map(plan => ({
             displayName: plan.displayName,
             path: plan.path,
-        })), this.copy(context.documentLanguage, '待补充', 'TBD'));
+        })), 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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# API 总览
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## API 边界
+
+${apiAreas}
+
+## 模块 API 文档
+
+${moduleApis}`, `# API Overview
 
 ## Project
 
@@ -425,23 +695,34 @@ ${apiAreas}
 
 ## Module API Docs
 
-${moduleApis}`
-            : `# API 总览
+${moduleApis}`, `# API 概要
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## API 边界
+## API 領域
 
 ${apiAreas}
 
-## 模块 API 文档
+## モジュール API 文書
+
+${moduleApis}`, `# نظرة عامة على API
 
-${moduleApis}`;
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## نطاقات API
+
+${apiAreas}
+
+## وثائق API للوحدات
+
+${moduleApis}`);
         return this.withFrontmatter({
             name: 'api-overview',
-            title: this.copy(context.documentLanguage, `${context.projectName} API 总览`, `${context.projectName} API Overview`),
+            title: this.copy(context.documentLanguage, `${context.projectName} API 总览`, `${context.projectName} API Overview`, `${context.projectName} API 概要`, `${context.projectName} نظرة عامة على API`),
             tags: ['project', 'api', 'overview'],
         }, body);
     }
@@ -450,29 +731,43 @@ ${moduleApis}`;
         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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# 设计文档规划
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 需要沉淀的设计文档
+
+${designDocs}`, `# Design Docs
 
 ## Project
 
 - **Project**: ${context.projectName}
 
-## Planned Design Docs
+## Planned Design Docs
+
+${designDocs}`, `# 設計文書
+
+## プロジェクト
+
+- **プロジェクト**: ${context.projectName}
+
+## 計画中の設計文書
 
-${designDocs}`
-            : `# 设计文档规划
+${designDocs}`, `# وثائق التصميم
 
-## 项目
+## المشروع
 
-- **项目名称**：${context.projectName}
+- **المشروع**: ${context.projectName}
 
-## 需要沉淀的设计文档
+## وثائق التصميم المخطط لها
 
-${designDocs}`;
+${designDocs}`);
         return this.withFrontmatter({
             name: 'design-docs',
-            title: this.copy(context.documentLanguage, `${context.projectName} 设计文档`, `${context.projectName} Design Docs`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 设计文档`, `${context.projectName} Design Docs`, `${context.projectName} 設計文書`, `${context.projectName} وثائق التصميم`),
             tags: ['docs', 'design', 'planning'],
         }, body);
     }
@@ -481,9 +776,16 @@ ${designDocs}`;
         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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# 开发计划文档
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 计划文档需求
+
+${planningDocs}`, `# Planning Docs
 
 ## Project
 
@@ -491,19 +793,26 @@ ${designDocs}`;
 
 ## Planning Documents
 
-${planningDocs}`
-            : `# 开发计划文档
+${planningDocs}`, `# 計画文書
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 计划文档需求
+## 計画文書
+
+${planningDocs}`, `# وثائق التخطيط
+
+## المشروع
 
-${planningDocs}`;
+- **المشروع**: ${context.projectName}
+
+## وثائق التخطيط
+
+${planningDocs}`);
         return this.withFrontmatter({
             name: 'planning-docs',
-            title: this.copy(context.documentLanguage, `${context.projectName} 计划文档`, `${context.projectName} Planning Docs`),
+            title: this.copy(context.documentLanguage, `${context.projectName} 计划文档`, `${context.projectName} Planning Docs`, `${context.projectName} 計画文書`, `${context.projectName} وثائق التخطيط`),
             tags: ['docs', 'planning', 'milestone'],
         }, body);
     }
@@ -512,9 +821,16 @@ ${planningDocs}`;
         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
+        })), this.copy(context.documentLanguage, '待补充', 'TBD', '未定', 'قيد التحديد'));
+        const body = this.copy(context.documentLanguage, `# API 文档目录说明
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## API 文档规划
+
+${apiDocs}`, `# API Docs Directory
 
 ## Project
 
@@ -522,19 +838,26 @@ ${planningDocs}`;
 
 ## Planned API Docs
 
-${apiDocs}`
-            : `# API 文档目录说明
+${apiDocs}`, `# API 文書ディレクトリ
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## API 文档规划
+## 計画中の API 文書
+
+${apiDocs}`, `# دليل وثائق API
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## وثائق API المخطط لها
 
-${apiDocs}`;
+${apiDocs}`);
         return this.withFrontmatter({
             name: 'api-docs',
-            title: this.copy(context.documentLanguage, `${context.projectName} API 文档`, `${context.projectName} API Docs`),
+            title: this.copy(context.documentLanguage, `${context.projectName} API 文档`, `${context.projectName} API Docs`, `${context.projectName} API 文書`, `${context.projectName} وثائق API`),
             tags: ['docs', 'api', 'reference'],
         }, body);
     }
@@ -552,8 +875,44 @@ ${apiDocs}`;
             ...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}
+        const body = presetBody ?? this.copy(context.documentLanguage, `# ${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)
+- 模块源码入口：当前目录`, `# ${moduleName}
 
 > Layer: module document
 > Parent: [src/SKILL.md](../../SKILL.md)
@@ -589,56 +948,105 @@ ${this.formatReferenceList(refs, 'TBD')}
 ## 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} 模块
+- API overview: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)`, `# ${moduleName} モジュール
 
-> 层级：第 3 层（业务模块文档）
-> 上层：[src/SKILL.md](../../SKILL.md)
+> レイヤー: モジュール文書
+> 親: [src/SKILL.md](../../SKILL.md)
 
-## 模块概述
+## モジュール概要
 
-- **项目**：${context.projectName}
-- **模块名**：${moduleName}
-- **路径**：src/modules/${slug}
+- **プロジェクト**: ${context.projectName}
+- **モジュール**: ${moduleName}
+- **パス**: src/modules/${slug}
 
-## 主要职责
+## 責務
 
-- 承载 ${moduleName} 相关业务能力
-- 衔接项目级设计与当前模块实现
-- 维护模块边界、依赖与测试要求
+- ${moduleName} ドメインの振る舞いを担う
+- このモジュールでプロジェクト設計と実装を接続する
+- モジュール境界、依存関係、テスト要件を維持する
 
-## API 文档
+## API 文書
 
-${this.formatReferenceList(refs, '待补充')}
+${this.formatReferenceList(refs, '未定')}
 
-## 依赖关系
+## 依存関係
 
-- 上游依赖：\`src/core/\`、项目级配置、共享基础设施
-- 同层协作：与其他 \`src/modules/*\` 保持清晰边界，通过文档和接口约定协作
-- 下游影响：实现变更后需回看关联 API 文档、执行层 change 文档和测试说明
+- 上流: \`src/core/\`、プロジェクト設定、共有基盤
+- 同列協調: 他の \`src/modules/*\` と明確な境界を保つ
+- 下流影響: 振る舞い変更時は API 文書、change 文書、テストを更新する
 
-## 测试要求
+## テスト要件
 
-- 单元测试：覆盖 ${moduleName} 模块核心业务规则和边界分支
-- 集成测试：覆盖该模块与 API / 数据层 / 外部服务的集成路径
-- 回归验证：当模块接口或行为变化时，同步更新 change 验证与相关文档
+- 単体テスト: 主要な業務ルールと境界条件をカバーする
+- 統合テスト: API、データ、サービスとの連携をカバーする
+- リグレッション確認: インターフェース変更時に change 検証を同期する
 
-## 关联文档
+## 関連文書
 
-- 项目模块地图：[../../../docs/project/module-map.md](../../../docs/project/module-map.md)
-- API 总览：[../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)
-- 模块源码入口：当前目录`);
+- モジュールマップ: [../../../docs/project/module-map.md](../../../docs/project/module-map.md)
+- API 概要: [../../../docs/project/api-overview.md](../../../docs/project/api-overview.md)`, `# وحدة ${moduleName}
+
+> الطبقة: وثيقة الوحدة
+> الأصل: [src/SKILL.md](../../SKILL.md)
+
+## نظرة عامة على الوحدة
+
+- **المشروع**: ${context.projectName}
+- **الوحدة**: ${moduleName}
+- **المسار**: src/modules/${slug}
+
+## المسؤوليات
+
+- امتلاك سلوك نطاق ${moduleName}
+- ربط تصميم المشروع بالتنفيذ داخل هذه الوحدة
+- الحفاظ على حدود الوحدة واعتمادياتها واختباراتها
+
+## وثائق API
+
+${this.formatReferenceList(refs, 'قيد التحديد')}
+
+## الاعتماديات
+
+- المنبع: \`src/core/\` وإعدادات المشروع والبنية المشتركة
+- التعاون الموازي: الحفاظ على حدود واضحة مع \`src/modules/*\` الأخرى
+- الأثر اللاحق: حدّث وثائق API ووثائق change والاختبارات عند تغيّر السلوك
+
+## متطلبات الاختبار
+
+- اختبارات الوحدة: تغطي القواعد الأساسية والحالات الحدّية
+- اختبارات التكامل: تغطي تفاعل الوحدة مع 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`),
+            title: this.copy(context.documentLanguage, `${context.projectName} ${moduleName} 模块`, `${context.projectName} ${moduleName} Module`, `${context.projectName} ${moduleName} モジュール`, `${context.projectName} وحدة ${moduleName}`),
             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}
+        const body = presetBody ?? this.copy(context.documentLanguage, `# ${apiAreaName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 边界说明
+
+- 负责 ${apiAreaName} 相关接口能力
+- 待补充请求入口、鉴权规则、错误码和数据模型
+
+## 待补充清单
+
+- [ ] 路由列表
+- [ ] 请求/响应结构
+- [ ] 权限与安全要求
+- [ ] 测试与验收要求`, `# ${apiAreaName}
 
 ## Project
 
@@ -654,27 +1062,42 @@ ${this.formatReferenceList(refs, '待补充')}
 - [ ] Routes
 - [ ] Request / response payloads
 - [ ] Permissions and security rules
-- [ ] Tests and acceptance requirements`
-            : `# ${apiAreaName}
+- [ ] Tests and acceptance requirements`, `# ${apiAreaName}
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 边界说明
+## 境界
 
-- 负责 ${apiAreaName} 相关接口能力
-- 待补充请求入口、鉴权规则、错误码和数据模型
+- ${apiAreaName} のインターフェースと契約を担当する
+- エントリポイント、認証ルール、エラーコード、データモデルを文書化する
 
-## 待补充清单
+## チェックリスト
 
-- [ ] 路由列表
-- [ ] 请求/响应结构
-- [ ] 权限与安全要求
-- [ ] 测试与验收要求`);
+- [ ] ルート
+- [ ] リクエスト / レスポンス
+- [ ] 権限とセキュリティルール
+- [ ] テストと受け入れ要件`, `# ${apiAreaName}
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## الحدود
+
+- امتلاك واجهات وعقود ${apiAreaName}
+- توثيق نقاط الدخول وقواعد المصادقة ورموز الأخطاء ونماذج البيانات
+
+## قائمة التحقق
+
+- [ ] المسارات
+- [ ] هياكل الطلب / الاستجابة
+- [ ] قواعد الأذونات والأمان
+- [ ] متطلبات الاختبار والقبول`);
         return this.withFrontmatter({
             name: this.slugify(apiAreaName) || 'api-area',
-            title: this.copy(context.documentLanguage, `${apiAreaName} API 文档`, `${apiAreaName} API Doc`),
+            title: this.copy(context.documentLanguage, `${apiAreaName} API 文档`, `${apiAreaName} API Doc`, `${apiAreaName} API 文書`, `وثيقة ${apiAreaName} API`),
             tags: ['api', 'reference', 'module'],
         }, body);
     }
@@ -682,8 +1105,29 @@ ${this.formatReferenceList(refs, '待补充')}
         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
+        const body = presetBody ?? this.copy(context.documentLanguage, `# ${moduleName} Module API
+
+## 项目
+
+- **项目名称**：${context.projectName}
+- **模块名**：${moduleName}
+- **模块路径**：src/modules/${slug}
+
+## 对外接口
+
+- 待补充该模块暴露的服务、事件、命令或接口
+
+## 依赖关系
+
+- 上游依赖：待补充
+- 下游调用方：待补充
+- 共享依赖：待补充
+
+## 测试要求
+
+- 单元测试：核心逻辑和边界条件
+- 集成测试：跨模块 / API / 数据依赖
+- 回归验证：接口变更后同步更新 change 验证`, `# ${moduleName} Module API
 
 ## Project
 
@@ -705,41 +1149,77 @@ ${this.formatReferenceList(refs, '待补充')}
 
 - 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
+- Regression checks: update change verification when interfaces change`, `# ${moduleName} モジュール API
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
-- **模块名**：${moduleName}
-- **模块路径**：src/modules/${slug}
+- **プロジェクト**: ${context.projectName}
+- **モジュール**: ${moduleName}
+- **モジュールパス**: src/modules/${slug}
 
-## 对外接口
+## 公開インターフェース
 
-- 待补充该模块暴露的服务、事件、命令或接口
+- このモジュールが公開するサービス、イベント、コマンド、API を文書化する
 
-## 依赖关系
+## 依存関係
 
-- 上游依赖：待补充
-- 下游调用方：待补充
-- 共享依赖：待补充
+- 上流: 未定
+- 下流利用側: 未定
+- 共有依存: 未定
 
-## 测试要求
+## テスト要件
 
-- 单元测试：核心逻辑和边界条件
-- 集成测试：跨模块 / API / 数据依赖
-- 回归验证：接口变更后同步更新 change 验证`);
+- 単体テスト: 主要ロジックと境界条件
+- 統合テスト: モジュール横断 / API / データ依存
+- リグレッション確認: インターフェース変更時に change 検証を更新する`, `# API وحدة ${moduleName}
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+- **الوحدة**: ${moduleName}
+- **مسار الوحدة**: src/modules/${slug}
+
+## الواجهة العامة
+
+- وثّق الخدمات أو الأحداث أو الأوامر أو واجهات API التي تكشفها هذه الوحدة
+
+## الاعتماديات
+
+- المنبع: قيد التحديد
+- الجهات المستهلكة: قيد التحديد
+- الاعتماديات المشتركة: قيد التحديد
+
+## متطلبات الاختبار
+
+- اختبارات الوحدة: المنطق الأساسي والحالات الحدّية
+- اختبارات التكامل: الاعتماديات العابرة للوحدات / API / البيانات
+- فحوص الارتداد: حدّث تحقق change عند تغيّر الواجهات`);
         return this.withFrontmatter({
             name: `module-${slug}`,
-            title: this.copy(context.documentLanguage, `${moduleName} 模块 API`, `${moduleName} Module API`),
+            title: this.copy(context.documentLanguage, `${moduleName} 模块 API`, `${moduleName} Module API`, `${moduleName} モジュール API`, `API وحدة ${moduleName}`),
             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}
+        const body = presetBody ?? this.copy(context.documentLanguage, `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 设计目标
+
+- 说明 ${docName} 的设计背景和目标
+- 记录方案边界、关键约束和取舍
+
+## 待补充内容
+
+- 背景
+- 方案
+- 风险
+- 验证方式`, `# ${docName}
 
 ## Project
 
@@ -755,35 +1235,64 @@ ${this.formatReferenceList(refs, '待补充')}
 - Background
 - Proposal
 - Risks
-- Verification`
-            : `# ${docName}
+- Verification`, `# ${docName}
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 设计目标
+## 設計目標
 
-- 说明 ${docName} 的设计背景和目标
-- 记录方案边界、关键约束和取舍
+- ${docName} の背景と目的を説明する
+- 境界、制約、トレードオフを記録する
 
-## 待补充内容
+## 未記入項目
 
 - 背景
-- 方案
-- 风险
-- 验证方式`);
+- 提案
+- リスク
+- 検証`, `# ${docName}
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## أهداف التصميم
+
+- اشرح خلفية ${docName} وهدفه
+- سجّل الحدود والقيود والمفاضلات
+
+## عناصر يجب إكمالها
+
+- الخلفية
+- المقترح
+- المخاطر
+- التحقق`);
         return this.withFrontmatter({
             name: this.slugify(docName) || 'design-doc',
-            title: this.copy(context.documentLanguage, `${docName} 设计文档`, `${docName} Design Doc`),
+            title: this.copy(context.documentLanguage, `${docName} 设计文档`, `${docName} Design Doc`, `${docName} 設計文書`, `${docName} وثيقة تصميم`),
             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}
+        const body = presetBody ?? this.copy(context.documentLanguage, `# ${docName}
+
+## 项目
+
+- **项目名称**：${context.projectName}
+
+## 规划目标
+
+- 说明 ${docName} 对应的阶段目标和交付边界
+
+## 待补充内容
+
+- 里程碑
+- 任务拆解
+- 风险与依赖
+- 验收节奏`, `# ${docName}
 
 ## Project
 
@@ -798,34 +1307,53 @@ ${this.formatReferenceList(refs, '待补充')}
 - Milestones
 - Task breakdown
 - Risks and dependencies
-- Acceptance cadence`
-            : `# ${docName}
+- Acceptance cadence`, `# ${docName}
 
-## 项目
+## プロジェクト
 
-- **项目名称**：${context.projectName}
+- **プロジェクト**: ${context.projectName}
 
-## 规划目标
+## 計画目標
 
-- 说明 ${docName} 对应的阶段目标和交付边界
+- ${docName} の段階目標と納品境界を記述する
 
-## 待补充内容
+## 未記入項目
 
-- 里程碑
-- 任务拆解
-- 风险与依赖
-- 验收节奏`);
+- マイルストーン
+- タスク分解
+- リスクと依存関係
+- 受け入れの進め方`, `# ${docName}
+
+## المشروع
+
+- **المشروع**: ${context.projectName}
+
+## هدف التخطيط
+
+- صف هدف المرحلة وحدود التسليم الخاصة بـ ${docName}
+
+## عناصر يجب إكمالها
+
+- المعالم
+- تقسيم المهام
+- المخاطر والاعتماديات
+- إيقاع القبول`);
         return this.withFrontmatter({
             name: this.slugify(docName) || 'planning-doc',
-            title: this.copy(context.documentLanguage, `${docName} 计划文档`, `${docName} Planning Doc`),
+            title: this.copy(context.documentLanguage, `${docName} 计划文档`, `${docName} Planning Doc`, `${docName} 計画文書`, `${docName} وثيقة تخطيط`),
             tags: ['planning', 'delivery', 'milestone'],
         }, body);
     }
     generateAiGuideTemplate(input) {
-        const language = input?.documentLanguage === 'en-US' ? 'en-US' : 'zh-CN';
+        const language = input?.documentLanguage === 'zh-CN' ||
+            input?.documentLanguage === 'en-US' ||
+            input?.documentLanguage === 'ja-JP' ||
+            input?.documentLanguage === 'ar'
+            ? input.documentLanguage
+            : 'en-US';
         return this.withFrontmatter({
             name: 'ai-guide',
-            title: this.copy(language, 'AI 开发指南', 'AI Guide'),
+            title: this.copy(language, 'AI 开发指南', 'AI Guide', 'AI ガイド', 'دليل الذكاء الاصطناعي'),
             tags: ['ai', 'guide', 'workflow'],
         }, this.copy(language, `# AI 开发指南
 
@@ -847,13 +1375,38 @@ ${this.formatReferenceList(refs, '待补充')}
 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.`));
+7. Update skill documents and rebuild the index after meaningful changes.`, `# AI ガイド
+
+## 作業順序
+
+1. まず \`SKILL.index.json\` を読む。
+2. コード編集前に関連する \`SKILL.md\` を読む。
+3. 現在の作業は \`changes/active/<change>\` を基準に進める。
+4. Stitch が有効で、現在の change が \`stitch_design_review\` を有効化している場合は、先に \`artifacts/stitch/approval.json\` を確認し、\`approved\` になるまで継続や archive 可と見なさない。
+5. Stitch のインストール、provider 切り替え、doctor 修復、MCP 設定、認証設定が関係する場合は、まずリポジトリ内の Stitch 仕様を読む。仕様がない場合のみ内蔵ベースラインを使う。
+6. 内蔵 Codex provider が読み取り専用呼び出しでは成功するのに Stitch 書き込みが止まる場合は、\`codex exec --dangerously-bypass-approvals-and-sandbox\` が本当に使われているかを確認する。カスタム Codex runner を使う場合も同じフラグを明示的に渡す。
+7. 重要な変更後は SKILL 文書を更新し、インデックスを再生成する。`, `# دليل الذكاء الاصطناعي
+
+## ترتيب العمل
+
+1. اقرأ \`SKILL.index.json\` أولاً إن وجد.
+2. اقرأ ملفات \`SKILL.md\` ذات الصلة قبل تعديل الكود.
+3. استخدم \`changes/active/<change>\` كطبقة التنفيذ الحالية.
+4. إذا كان Stitch مفعلاً وكان change الحالي يفعّل \`stitch_design_review\`، فافحص \`artifacts/stitch/approval.json\` أولاً ولا تعتبر change جاهزاً للاستمرار أو الأرشفة حتى تصبح حالته \`approved\`.
+5. إذا كان العمل يتضمن تثبيت Stitch أو تبديل provider أو إصلاح doctor أو إعداد MCP أو المصادقة، فاقرأ مواصفة Stitch المحلية في المستودع أولاً. استخدم الخطوط الأساسية المدمجة فقط عند غياب المواصفة.
+6. إذا نجح provider الداخلي لـ Codex في الاستدعاءات للقراءة فقط لكن توقفت عمليات الكتابة الخاصة بـ Stitch، فتحقق أولاً من أن التشغيل يستخدم فعلاً \`codex exec --dangerously-bypass-approvals-and-sandbox\`. وإذا كان المشروع يبدل Runner مخصصاً لـ Codex فيجب أن يمرر العلم نفسه صراحةً.
+7. حدّث وثائق SKILL وأعد بناء الفهرس بعد التغييرات المهمة.`));
     }
     generateExecutionProtocolTemplate(input) {
-        const language = input?.documentLanguage === 'en-US' ? 'en-US' : 'zh-CN';
+        const language = input?.documentLanguage === 'zh-CN' ||
+            input?.documentLanguage === 'en-US' ||
+            input?.documentLanguage === 'ja-JP' ||
+            input?.documentLanguage === 'ar'
+            ? input.documentLanguage
+            : 'en-US';
         return this.withFrontmatter({
             name: 'execution-protocol',
-            title: this.copy(language, '执行协议', 'Execution Protocol'),
+            title: this.copy(language, '执行协议', 'Execution Protocol', '実行プロトコル', 'بروتوكول التنفيذ'),
             tags: ['execution', 'protocol', 'workflow'],
         }, this.copy(language, `# 执行协议
 
@@ -899,7 +1452,51 @@ Use active changes for current implementation work.
 - 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>\`.`));
+- When recording manual review decisions, prefer \`ospec plugins approve stitch <change-path>\` or \`ospec plugins reject stitch <change-path>\`.`, `# 実行プロトコル
+
+## 参照元
+
+- \`.skillrc\`
+- \`changes/active/<change>/proposal.md\`
+- \`changes/active/<change>/tasks.md\`
+- \`changes/active/<change>/state.json\`
+- \`changes/active/<change>/verification.md\`
+
+## ルール
+
+長期知識にはプロジェクト文書とレイヤー化された SKILL を使う。
+現在の実装作業には active change を使う。
+
+## プラグインゲート
+
+- まず \`.skillrc.plugins\` を読んで有効なブロック系プラグインを確認する。
+- 現在の change が \`tasks.md\` または \`verification.md\` で \`stitch_design_review\` を有効化している場合は、先に \`artifacts/stitch/approval.json\` を確認する。
+- \`approval.json.status\` が \`approved\` でない場合、継続実装、完了宣言、archive 準備完了として扱わない。
+- Stitch provider、MCP、認証設定が関係する場合は、まずリポジトリ内の Stitch 仕様を読む。仕様がない場合のみ内蔵ベースラインを使う。
+- 内蔵 Codex provider が読み取り専用呼び出しでは成功するのに Stitch 書き込みが止まる場合は、\`codex exec --dangerously-bypass-approvals-and-sandbox\` が実際に使われているかを確認する。カスタム runner でも同じフラグが必要。
+- 手動レビュー結果を記録する場合は \`ospec plugins approve stitch <change-path>\` または \`ospec plugins reject stitch <change-path>\` を優先する。`, `# بروتوكول التنفيذ
+
+## مصدر الحقيقة
+
+- \`.skillrc\`
+- \`changes/active/<change>/proposal.md\`
+- \`changes/active/<change>/tasks.md\`
+- \`changes/active/<change>/state.json\`
+- \`changes/active/<change>/verification.md\`
+
+## القاعدة
+
+استخدم وثائق المشروع وملفات SKILL متعددة الطبقات للمعرفة طويلة الأمد.
+واستخدم التغييرات النشطة للأعمال التنفيذية الحالية.
+
+## بوابات الإضافات
+
+- اقرأ \`.skillrc.plugins\` أولاً لاكتشاف الإضافات الحاجبة المفعلة.
+- إذا كان change الحالي يفعّل \`stitch_design_review\` في \`tasks.md\` أو \`verification.md\`، فافحص \`artifacts/stitch/approval.json\` قبل التقدم.
+- عندما لا تكون \`approval.json.status\` مساوية لـ \`approved\`، فلا تعتبر change جاهزاً للاستمرار أو إعلان الاكتمال أو الأرشفة.
+- إذا كان العمل يتضمن Stitch provider أو MCP أو إعدادات المصادقة، فاقرأ مواصفة Stitch المحلية في المستودع أولاً، واستخدم الخطوط الأساسية المدمجة فقط عند غيابها.
+- إذا نجح provider الداخلي لـ Codex في الاستدعاءات للقراءة فقط لكن توقفت عمليات كتابة Stitch، فتحقق أولاً من أن التشغيل يستخدم فعلاً \`codex exec --dangerously-bypass-approvals-and-sandbox\`. وإذا استُخدم runner مخصص فيجب أن يمرر العلم نفسه.
+- عند تسجيل قرارات المراجعة اليدوية، فضّل \`ospec plugins approve stitch <change-path>\` أو \`ospec plugins reject stitch <change-path>\`.`));
     }
     generateBuildIndexScriptTemplate() {
         return `#!/usr/bin/env node
@@ -997,7 +1594,8 @@ scan(rootDir)
         return this.inputs.normalizeProjectBootstrapInput(input, fallbackName, mode);
     }
     getPresetModuleSkillBody(context, moduleName, slug, refs) {
-        if (context.projectPresetId !== 'official-site') {
+        if (context.projectPresetId !== 'official-site' ||
+            (context.documentLanguage !== 'zh-CN' && context.documentLanguage !== 'en-US')) {
             return null;
         }
         const moduleKey = slug.toLowerCase();
@@ -1386,7 +1984,8 @@ ${relatedDocs}`,
         return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
     }
     getPresetApiAreaDocBody(context, apiAreaName) {
-        if (context.projectPresetId !== 'official-site') {
+        if (context.projectPresetId !== 'official-site' ||
+            (context.documentLanguage !== 'zh-CN' && context.documentLanguage !== 'en-US')) {
             return null;
         }
         const key = apiAreaName.trim().toLowerCase();
@@ -1555,7 +2154,8 @@ ${relatedDocs}`,
         return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
     }
     getPresetModuleApiDocBody(context, moduleName, slug) {
-        if (context.projectPresetId !== 'official-site') {
+        if (context.projectPresetId !== 'official-site' ||
+            (context.documentLanguage !== 'zh-CN' && context.documentLanguage !== 'en-US')) {
             return null;
         }
         const docs = {
@@ -1619,11 +2219,12 @@ ${relatedDocs}`,
         return this.isEnglish(context.documentLanguage) ? template.en : template.zh;
     }
     getPresetDesignDocBody(context, docName) {
-        if (context.projectPresetId !== 'official-site') {
+        if (context.projectPresetId !== 'official-site' ||
+            (context.documentLanguage !== 'zh-CN' && context.documentLanguage !== 'en-US')) {
             return null;
         }
         const key = docName.trim().toLowerCase();
-        const isChinese = !this.isEnglish(context.documentLanguage);
+        const isChinese = context.documentLanguage === 'zh-CN';
         if (['ui information architecture', '界面信息架构'].includes(key)) {
             return isChinese
                 ? `# ${docName}
@@ -1784,11 +2385,12 @@ ${relatedDocs}`,
         return null;
     }
     getPresetPlanningDocBody(context, docName) {
-        if (context.projectPresetId !== 'official-site') {
+        if (context.projectPresetId !== 'official-site' ||
+            (context.documentLanguage !== 'zh-CN' && context.documentLanguage !== 'en-US')) {
             return null;
         }
         const key = docName.trim().toLowerCase();
-        const isChinese = !this.isEnglish(context.documentLanguage);
+        const isChinese = context.documentLanguage === 'zh-CN';
         if (['delivery plan', '交付计划'].includes(key)) {
             return isChinese
                 ? `# ${docName}