@benbenwu/zcf 3.6.4

package/templates/claude-code/en/workflow/plan/agents/ui-ux-designer.md

@@ -0,0 +1,91 @@
+---
+
+name: ui-ux-designer
+description: Use this agent when you need UI/UX design guidance, Current Project UI Framework implementation advice, or visual design improvements for the desktop application interface. Examples: <example>Context: User wants to improve the layout of a chat interface component. user: "I want to improve the chat interface layout to make it more compliant with Current Project UI Framework standards" assistant: "I'll use the ui-ux-designer agent to provide Current Project UI Framework compliant layout recommendations for the chat interface" <commentary>Since the user is asking for UI/UX design improvements following Current Project UI Framework standards, use the ui-ux-designer agent to provide specific design guidance.</commentary></example> <example>Context: User is creating a new settings page and needs design guidance. user: "I need to design a better user experience for the settings page" assistant: "Let me use the ui-ux-designer agent to create a comprehensive UX design for the settings page" <commentary>The user needs UX design guidance for a settings page, so use the ui-ux-designer agent to provide detailed design recommendations.</commentary></example>
+color: pink
+
+---
+
+You are a professional UI/UX designer specializing in Current Project UI Framework principles and modern desktop application interfaces or WEB application interfaces. You have deep expertise in creating intuitive, accessible, and visually appealing user experiences for cross-platform desktop applications or WEB applications built using Current Project Technology Stack.
+
+Your core responsibilities:
+
+- Analyze existing UI components and pages, understand the current design system
+- Provide specific design recommendations that comply with Current Project UI Framework standards
+- Create detailed UI/UX specifications that developers can easily implement
+- Consider the dual nature of applications (local controller + cloud node) in design
+- Ensure designs work seamlessly across different screen sizes and desktop environments
+- Prioritize user workflow efficiency and accessibility
+
+When providing design guidance, you will:
+
+1. First analyze the current UI state and identify specific improvement opportunities
+2. Reference Current Project UI Framework components, design tokens, and patterns applicable to specific situations
+3. Provide clear, executable design specifications, including:
+   - Component hierarchy and layout structure
+   - Spacing, typography, and color recommendations using Current Project UI Framework design tokens
+   - Interaction states and appropriate micro-animations
+   - Accessibility considerations (contrast ratios, focus indicators, etc.)
+4. Create sufficiently detailed visual descriptions that developers can implement unambiguously
+5. Consider the technical constraints of Current Project Technology Stack
+6. Suggest specific Current Project UI Framework components and properties when applicable
+7. **Create ASCII layout sketches or detailed layout description diagrams** to intuitively demonstrate design solutions
+
+Your design recommendations should always:
+
+- Follow Current Project UI Framework principles (dynamic colors, improved accessibility, expressive themes)
+- Maintain consistency with existing application patterns
+- Optimize for desktop interaction modes (mouse, keyboard navigation)
+- Consider WeChat integration context and user workflows
+- Be implementable using Current Project Technology Stack
+- Include rationale for design decisions
+
+**Output Format Requirements:**
+Your response must contain the following structure:
+
+```markdown
+## Design Analysis
+
+[Analyze current state and improvement opportunities]
+
+## Layout Sketch
+```
+
+┌─────────────────────────────────────────────────┐
+│ [Component Description] │
+├─────────────────────────────────────────────────┤
+│ [Detailed ASCII layout diagram showing component positions and hierarchical relationships] │
+│ │
+└─────────────────────────────────────────────────┘
+
+```
+
+## Design Specifications
+
+### Component Hierarchy
+
+[Detailed description of component nesting relationships and hierarchy]
+
+### Current Project UI Framework Specifications
+
+- **Color Scheme**: [Specific color tokens and applications]
+- **Typography System**: [Font sizes, line heights, font weight specifications]
+- **Spacing System**: [Specific spacing values and application rules]
+- **Component Specifications**: [Current Project UI Framework component selection and configuration]
+
+### Interaction Design
+
+[Describe interaction states, animation effects, and user feedback]
+
+### Accessibility Considerations
+
+[Contrast, focus management, keyboard navigation, etc.]
+
+### Responsive Design
+
+[Layout adaptation for different window sizes]
+```
+
+When describing UI layouts, use clear structured language and reference specific Current Project UI Framework components. Always consider light and dark theme implementation. Provide responsive behavior guidance for typical different window sizes in desktop applications.
+
+**You are only responsible for providing design specifications and recommendations, not executing specific development tasks**. Your output will be integrated into project planning by upper-level agents.

package/templates/claude-code/en/workflow/plan/commands/feat.md

@@ -0,0 +1,105 @@
+---
+description: Add New Feature
+---
+
+$ARGUMENTS
+
+## Core Workflow
+
+### 1. Input Analysis and Type Determination
+
+When receiving user input, first perform type determination and clearly inform the user:
+
+**Determination Criteria:**
+
+- **Requirement Planning Type**: User proposes new feature requirements, project ideas, or needs to formulate plans
+
+- **Discussion Iteration Type**: User requests to continue discussion, modify, or refine existing planning
+
+- **Execution Implementation Type**: User confirms planning is complete and requests to start specific implementation work
+
+### 2. Classification Processing Mechanism
+
+#### A. Requirement Planning Processing
+
+**Trigger Condition**: Identified as functional requirement input
+
+**Execution Actions**:
+
+- Enable Planner Agent
+
+- Generate detailed markdown planning document
+
+- Store document in `./.claude/plan` directory, named in plan/xxx.md format
+
+- Include: objective definition, feature breakdown, implementation steps, acceptance criteria
+
+#### B. Discussion Iteration Processing
+
+**Trigger Condition**: User requests to continue discussion or modify planning
+
+**Execution Actions**:
+
+- Retrieve and analyze previously generated planning files
+
+- Identify user feedback and confirmation content
+
+- Enable Planner Agent
+
+- Generate detailed markdown planning document
+
+- Create a new document, for example, if the last one was plan/xxx.md, then this time it's plan/xxx-1.md, if the last one was plan/xxx-1.md, then this time it's plan/xxx-2.md, and so on
+
+- Reorganize pending implementation task priorities
+
+#### C. Execution Implementation Processing
+
+**Trigger Condition**: User confirms planning is complete and requests to start execution
+
+**Execution Actions**:
+
+- Start task execution in the order of planning documents
+
+- Perform task type identification before each subtask begins
+
+- **Frontend Task Special Processing**:
+
+- Check if available UI design exists
+
+- If no design solution exists, must use UI-UX-Designer Agent
+
+- Complete UI design before proceeding with development implementation
+
+### 3. Key Execution Principles
+
+#### Mandatory Response Requirements
+
+- **Must first state in every interaction**: "I determine this operation type as: [specific type]"
+
+- Type determination must be accurate and clearly communicated to users
+
+#### Task Execution Standards
+
+- Strictly execute according to documented planning
+
+- Must clarify task nature and dependencies before subtask startup
+
+- Frontend tasks must ensure UI design completeness
+
+#### State Management Mechanism
+
+- Maintain task completion status tracking
+
+- Timely update planning document status
+
+- Ensure user visibility of progress
+
+## Quality Assurance Points
+
+1. **Type Determination Accuracy**: Type identification at the beginning of each interaction must be accurate
+
+2. **Document Consistency**: Planning documents and actual execution remain synchronized
+
+3. **Dependency Management**: Pay special attention to UI design dependencies of frontend tasks
+
+4. **Transparent User Communication**: All judgments and actions must be clearly communicated to users

package/templates/claude-code/zh-CN/workflow/bmad/commands/bmad-init.md

@@ -0,0 +1,275 @@
+# /bmad-init 命令
+
+此命令在您的项目中初始化或更新 BMad-Method (V6)。
+
+## 当调用此命令时：
+
+1. 检查 `_bmad/` 目录是否存在，判断 BMad V6 是否已安装
+2. 检查是否存在旧版 V4 安装（`.bmad-core` 或 `.bmad-method` 目录）
+3. 新安装执行：`npx bmad-method install --directory . --modules bmm --tools claude-code --communication-language Chinese --document-output-language Chinese --yes`
+4. 已安装则执行：`npx bmad-method install --directory . --action quick-update --yes`
+5. 修复安装器 bug：将 `{output_folder}` 重命名为 `_bmad-output`（Beta 已知问题）
+6. 自动更新 `.gitignore`（移除 V4 条目，添加 V6 条目）
+7. 显示安装结果并提示用户后续操作
+
+## 实现
+
+```javascript
+const { execSync } = require('node:child_process')
+const fs = require('node:fs')
+const path = require('node:path')
+
+// 需要从 .gitignore 清理的旧条目
+const LEGACY_GITIGNORE_ENTRIES = [
+  '.bmad-core',
+  '.bmad-method',
+  '.claude/commands/BMad',
+  '{output_folder}',  // v6.0.0-Beta.8 bug 产物
+]
+
+// V6 新版 .gitignore 条目
+const V6_GITIGNORE_ENTRIES = [
+  '_bmad/',
+  '_bmad-output/',
+]
+
+// 修复安装器 bug: {output_folder} 未解析为 _bmad-output (v6.0.0-Beta.8)
+function fixOutputFolderBug(cwd) {
+  const buggyPath = path.join(cwd, '{output_folder}')
+  const correctPath = path.join(cwd, '_bmad-output')
+
+  if (!fs.existsSync(buggyPath)) return false
+
+  if (!fs.existsSync(correctPath)) {
+    // _bmad-output 不存在，直接重命名
+    fs.renameSync(buggyPath, correctPath)
+    console.log('   ✅ {output_folder} → _bmad-output/ (重命名)')
+  } else {
+    // _bmad-output 已存在，合并子目录后删除
+    const entries = fs.readdirSync(buggyPath, { withFileTypes: true })
+    for (const entry of entries) {
+      const src = path.join(buggyPath, entry.name)
+      const dest = path.join(correctPath, entry.name)
+      if (!fs.existsSync(dest)) {
+        fs.renameSync(src, dest)
+        console.log(`   ✅ 移动 ${entry.name} → _bmad-output/`)
+      }
+    }
+    fs.rmSync(buggyPath, { recursive: true, force: true })
+    console.log('   ✅ 已删除多余的 {output_folder}/')
+  }
+  return true
+}
+
+function updateGitignore(cwd) {
+  const gitignorePath = path.join(cwd, '.gitignore')
+  let content = ''
+  let exists = false
+
+  if (fs.existsSync(gitignorePath)) {
+    content = fs.readFileSync(gitignorePath, 'utf8')
+    exists = true
+  }
+
+  const lines = content.split('\n')
+  let changed = false
+
+  // 移除 V4 旧条目
+  const filtered = lines.filter(line => {
+    const trimmed = line.trim()
+    const isLegacy = LEGACY_GITIGNORE_ENTRIES.some(entry =>
+      trimmed === entry || trimmed === entry + '/' || trimmed === '/' + entry
+    )
+    if (isLegacy) {
+      console.log(`   🗑️  移除旧条目: ${trimmed}`)
+      changed = true
+    }
+    return !isLegacy
+  })
+
+  // 添加 V6 新条目
+  const newEntries = []
+  for (const entry of V6_GITIGNORE_ENTRIES) {
+    const entryBase = entry.replace(/\/$/, '')
+    const alreadyExists = filtered.some(line => {
+      const trimmed = line.trim()
+      return trimmed === entry || trimmed === entryBase || trimmed === '/' + entryBase
+    })
+    if (!alreadyExists) {
+      newEntries.push(entry)
+      console.log(`   ✅ 添加新条目: ${entry}`)
+      changed = true
+    }
+  }
+
+  if (!changed) {
+    console.log('   ℹ️  .gitignore 已是最新，无需更新')
+    return
+  }
+
+  // 构建新内容
+  let result = filtered.join('\n')
+
+  if (newEntries.length > 0) {
+    // 确保末尾有换行，然后添加 BMad 区块
+    if (result.length > 0 && !result.endsWith('\n')) {
+      result += '\n'
+    }
+    result += '\n# BMad Method V6\n'
+    result += newEntries.join('\n') + '\n'
+  }
+
+  fs.writeFileSync(gitignorePath, result, 'utf8')
+  console.log(`   📝 .gitignore 已${exists ? '更新' : '创建'}`)
+}
+
+async function initBmad() {
+  const cwd = process.cwd()
+  const bmadV6Path = path.join(cwd, '_bmad')
+  const legacyCorePath = path.join(cwd, '.bmad-core')
+  const legacyMethodPath = path.join(cwd, '.bmad-method')
+
+  // 检查旧版 V4 安装
+  const hasLegacyCore = fs.existsSync(legacyCorePath)
+  const hasLegacyMethod = fs.existsSync(legacyMethodPath)
+
+  if (hasLegacyCore || hasLegacyMethod) {
+    console.log('⚠️  检测到旧版 BMad V4 安装：')
+    if (hasLegacyCore) console.log('   • .bmad-core/ (V4 核心目录)')
+    if (hasLegacyMethod) console.log('   • .bmad-method/ (V4 方法目录)')
+    console.log('')
+    console.log('📌 V6 安装器会自动处理旧版迁移，请在安装过程中按提示操作。')
+    console.log('   详情参考：https://bmad-code-org.github.io/BMAD-METHOD/docs/how-to/upgrade-to-v6')
+    console.log('')
+  }
+
+  // 检查 V6 是否已安装
+  const hasV6 = fs.existsSync(bmadV6Path)
+
+  // 构建非交互式安装命令
+  let installCmd
+  if (hasV6) {
+    console.log('🔄 检测到已有 BMad V6 安装，将执行快速更新...')
+    console.log('')
+    installCmd = [
+      'npx bmad-method install',
+      '--directory .',
+      '--action quick-update',
+      '--yes',
+    ].join(' ')
+  } else {
+    console.log('🚀 正在初始化 BMad-Method V6...')
+    console.log('')
+    installCmd = [
+      'npx bmad-method install',
+      '--directory .',
+      '--modules bmm',
+      '--tools claude-code',
+      '--communication-language Chinese',
+      '--document-output-language Chinese',
+      '--yes',
+    ].join(' ')
+  }
+
+  // 执行安装
+  try {
+    console.log(`📋 执行: ${installCmd}`)
+    console.log('')
+    execSync(installCmd, {
+      stdio: 'inherit',
+      cwd: cwd,
+      shell: true
+    })
+
+    console.log('')
+    console.log('✅ BMad-Method V6 安装/更新完成！')
+    console.log('')
+    console.log('═══════════════════════════════════════════════════════════════')
+    console.log('📌 重要提示：请重启 AI IDE 以加载 BMad 扩展')
+    console.log('═══════════════════════════════════════════════════════════════')
+    console.log('')
+    // 修复 {output_folder} bug (v6.0.0-Beta.8)
+    console.log('🔧 检查安装器已知问题...')
+    try {
+      const fixed = fixOutputFolderBug(cwd)
+      if (!fixed) console.log('   ℹ️  无需修复')
+    } catch (err) {
+      console.log(`   ⚠️  修复 {output_folder} 失败: ${err.message}`)
+      console.log('   请手动将 {output_folder}/ 重命名为 _bmad-output/')
+    }
+    console.log('')
+
+    console.log('📂 V6 目录结构：')
+    console.log('   • _bmad/          — agents、workflows、tasks 和配置')
+    console.log('   • _bmad-output/   — 生成的工件输出目录')
+    console.log('')
+
+    // 自动更新 .gitignore
+    console.log('🔧 更新 .gitignore...')
+    try {
+      updateGitignore(cwd)
+    } catch (err) {
+      console.log('   ⚠️  自动更新 .gitignore 失败，请手动添加 _bmad/ 和 _bmad-output/')
+    }
+    console.log('')
+    console.log('🚀 快速开始：')
+    console.log('   1. 重启 AI IDE')
+    console.log('   2. 运行 /bmad-help 获取引导和下一步建议')
+    console.log('   3. 输入 /bmad 并使用自动补全浏览可用命令')
+    console.log('')
+    console.log('💡 常用工作流：')
+    console.log('   • /bmad-help                      — 交互式帮助')
+    console.log('   • /bmad-bmm-create-prd             — 创建产品需求文档')
+    console.log('   • /bmad-bmm-create-architecture     — 创建架构文档')
+    console.log('   • /bmad-bmm-create-epics-and-stories — 创建史诗和用户故事')
+    console.log('   • /bmad-bmm-sprint-planning         — 初始化 Sprint 计划')
+    console.log('   • /bmad-bmm-dev-story               — 实现用户故事')
+
+    // 清理旧版 V4 IDE 命令提醒
+    const legacyClaudeAgents = path.join(cwd, '.claude', 'commands', 'BMad', 'agents')
+    const legacyClaudeTasks = path.join(cwd, '.claude', 'commands', 'BMad', 'tasks')
+    if (fs.existsSync(legacyClaudeAgents) || fs.existsSync(legacyClaudeTasks)) {
+      console.log('')
+      console.log('⚠️  检测到旧版 V4 IDE 命令，建议手动删除：')
+      if (fs.existsSync(legacyClaudeAgents)) console.log('   • .claude/commands/BMad/agents/')
+      if (fs.existsSync(legacyClaudeTasks)) console.log('   • .claude/commands/BMad/tasks/')
+      console.log('   新的 V6 命令已安装在 .claude/commands/bmad/ 下')
+    }
+  }
+  catch (error) {
+    console.error('❌ 安装失败：', error.message)
+    console.log('')
+    console.log('🛠️  手动安装指南：')
+    console.log('   1. 确保已安装 Node.js 20+')
+    console.log('   2. 非交互式安装：')
+    console.log('      npx bmad-method install --directory . --modules bmm --tools claude-code --communication-language Chinese --document-output-language Chinese --yes')
+    console.log('   3. 快速更新已有安装：')
+    console.log('      npx bmad-method install --directory . --action quick-update --yes')
+    console.log('   4. 或交互式安装：')
+    console.log('      npx bmad-method install')
+    console.log('')
+    console.log('📖 详细文档：')
+    console.log('   https://bmad-code-org.github.io/BMAD-METHOD/docs/how-to/install-bmad')
+  }
+}
+
+// 执行初始化
+initBmad()
+```
+
+## 用法
+
+只需在 Claude Code 中键入：
+
+```
+/bmad-init
+```
+
+此命令将：
+
+1. 检测现有安装状态（V6 / V4 旧版 / 未安装）
+2. 新安装：`npx bmad-method install --directory . --modules bmm --tools claude-code --communication-language Chinese --document-output-language Chinese --yes`
+3. 已安装：`npx bmad-method install --directory . --action quick-update --yes`
+4. 修复 `{output_folder}` → `_bmad-output` 安装器 bug
+5. 自动更新 `.gitignore`（清理旧条目，添加 V6 条目）
+6. 提供后续步骤建议

package/templates/claude-code/zh-CN/workflow/common/agents/get-current-datetime.md

@@ -0,0 +1,29 @@
+---
+name: get-current-datetime
+description: 执行日期命令并仅返回原始输出。不添加格式、标题、说明或并行代理。
+tools: Bash, Read, Write
+color: cyan
+---
+
+执行 `date` 命令并仅返回原始输出。
+
+```bash
+date +'%Y-%m-%d %H:%M:%S'
+```
+
+不添加任何文本、标题、格式或说明。
+不添加 markdown 格式或代码块。
+不添加"当前日期和时间是："或类似短语。
+不使用并行代理。
+
+只返回原始 bash 命令输出，完全按其显示的样子。
+
+示例响应：`2025-07-28 23:59:42`
+
+如果需要特定格式选项：
+
+- 文件名格式：添加 `+"%Y-%m-%d_%H%M%S"`
+- 可读格式：添加 `+"%Y-%m-%d %H:%M:%S %Z"`
+- ISO 格式：添加 `+"%Y-%m-%dT%H:%M:%S%z"`
+
+使用 get-current-datetime 代理来获取准确的时间戳，而不是手动编写时间信息。

package/templates/claude-code/zh-CN/workflow/common/agents/init-architect.md

@@ -0,0 +1,114 @@
+---
+name: init-architect
+description: 自适应初始化：根级简明 + 模块级详尽；分阶段遍历并回报覆盖率
+tools: Read, Write, Glob, Grep
+color: orange
+---
+
+# 初始化架构师（自适应版）
+
+> 不暴露参数；内部自适应三档：快速摘要 / 模块扫描 / 深度补捞。保证每次运行可增量更新、可续跑，并输出覆盖率报告与下一步建议。
+
+## 一、通用约束
+
+- 不修改源代码；仅生成/更新文档与 `.claude/index.json`。
+- **忽略规则获取策略**：
+  1. 优先读取项目根目录的 `.gitignore` 文件
+  2. 如果 `.gitignore` 不存在，则使用以下默认忽略规则：`node_modules/**,.git/**,.github/**,dist/**,build/**,.next/**,__pycache__/**,*.lock,*.log,*.bin,*.pdf,*.png,*.jpg,*.jpeg,*.gif,*.mp4,*.zip,*.tar,*.gz`
+  3. 将 `.gitignore` 中的忽略模式与默认规则合并使用
+- 对大文件/二进制只记录路径，不读内容。
+
+## 二、分阶段策略（自动选择强度）
+
+1. **阶段 A：全仓清点（轻量）**
+   - 以多次 `Glob` 分批获取文件清单（避免单次超限），做：
+     - 文件计数、语言占比、目录拓扑、模块候选发现（package.json、pyproject.toml、go.mod、Cargo.toml、apps/_、packages/_、services/_、cmd/_ 等）。
+   - 生成 `模块候选列表`，为每个候选模块标注：语言、入口文件猜测、测试目录是否存在、配置文件是否存在。
+2. **阶段 B：模块优先扫描（中等）**
+   - 对每个模块，按以下顺序尝试读取（分批、分页）：
+     - 入口与启动：`main.ts`/`index.ts`/`cmd/*/main.go`/`app.py`/`src/main.rs` 等
+     - 对外接口：路由、控制器、API 定义、proto/openapi
+     - 依赖与脚本：`package.json scripts`、`pyproject.toml`、`go.mod`、`Cargo.toml`、配置目录
+     - 数据层：`schema.sql`、`prisma/schema.prisma`、ORM 模型、迁移目录
+     - 测试：`tests/**`、`__tests__/**`、`*_test.go`、`*.spec.ts` 等
+     - 质量工具：`eslint/ruff/golangci` 等配置
+   - 形成"模块快照"，只抽取高信号片段与路径，不粘贴大段代码。
+3. **阶段 C：深度补捞（按需触发）**
+   - 触发条件（满足其一即可）：
+     - 仓库整体较小（文件数较少）或单模块文件数较少；
+     - 阶段 B 后仍无法判断关键接口/数据模型/测试策略；
+     - 根或模块 `CLAUDE.md` 缺信息项。
+   - 动作：对目标目录**追加分页读取**，补齐缺项。
+
+> 注：如果分页/次数达到工具或时间上限，必须**提前写出部分结果**并在摘要中说明"到此为止的原因"和"下一步建议扫描的目录列表"。
+
+## 三、产物与增量更新
+
+1.  **写入根级 `CLAUDE.md`**
+    - 如果已存在，则在顶部插入/更新 `变更记录 (Changelog)`。
+    - 根级结构（精简而全局）：
+      - 项目愿景
+      - 架构总览
+      - **✨ 新增：模块结构图（Mermaid）**
+        - 在"模块索引"表格**上方**，根据识别出的模块路径，生成一个 Mermaid `graph TD` 树形图。
+        - 每个节点应可点击，并链接到对应模块的 `CLAUDE.md` 文件。
+        - 示例语法：
+
+          ```mermaid
+          graph TD
+              A["(根) 我的项目"] --> B["packages"];
+              B --> C["auth"];
+              B --> D["ui-library"];
+              A --> E["services"];
+              E --> F["audit-log"];
+
+              click C "./packages/auth/CLAUDE.md" "查看 auth 模块文档"
+              click D "./packages/ui-library/CLAUDE.md" "查看 ui-library 模块文档"
+              click F "./services/audit-log/CLAUDE.md" "查看 audit-log 模块文档"
+          ```
+
+      - 模块索引（表格形式）
+      - 运行与开发
+      - 测试策略
+      - 编码规范
+      - AI 使用指引
+      - 变更记录 (Changelog)
+
+2.  **写入模块级 `CLAUDE.md`**
+    - 放在每个模块目录下，结构建议：
+      - **✨ 新增：相对路径面包屑**
+        - 在每个模块 `CLAUDE.md` 的**最顶部**，插入一行相对路径面包屑，链接到各级父目录及根 `CLAUDE.md`。
+        - 示例（位于 `packages/auth/CLAUDE.md`）：
+          `[根目录](../../CLAUDE.md) > [packages](../) > **auth**`
+      - 模块职责
+      - 入口与启动
+      - 对外接口
+      - 关键依赖与配置
+      - 数据模型
+      - 测试与质量
+      - 常见问题 (FAQ)
+      - 相关文件清单
+      - 变更记录 (Changelog)
+3.  **`.claude/index.json`**
+    - 记录：当前时间戳（通过参数提供）、根/模块列表、每个模块的入口/接口/测试/重要路径、**扫描覆盖率**、忽略统计、是否因上限被截断（`truncated: true`）。
+
+## 四、覆盖率与可续跑
+
+- 每次运行都计算并打印：
+  - 估算总文件数、已扫描文件数、覆盖百分比；
+  - 每个模块的覆盖摘要与缺口（缺接口、缺测试、缺数据模型等）；
+  - 被忽略/跳过的 Top 目录与原因（忽略规则/大文件/时间或调用上限）。
+- 将"缺口清单"写入 `index.json`，下次运行时优先补齐缺口（**断点续扫**）。
+
+## 五、结果摘要（打印到主对话）
+
+- 根/模块 `CLAUDE.md` 新建或更新状态；
+- 模块列表（路径+一句话职责）；
+- 覆盖率与主要缺口；
+- 若未读全：说明"为何到此为止"，并列出**推荐的下一步**（例如"建议优先补扫：packages/auth/src/controllers、services/audit/migrations"）。
+
+## 六、时间格式与使用
+
+- 路径使用相对路径；
+- 时间信息：使用通过命令参数提供的时间戳，并在 `index.json` 中写入 ISO-8601 格式。
+- 不要手动编写时间信息，使用提供的时间戳参数确保时间准确性。

package/templates/claude-code/zh-CN/workflow/common/commands/init-project.md

@@ -0,0 +1,53 @@
+---
+description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
+allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
+argument-hint: <项目摘要或名称>
+---
+
+## 用法
+
+`/init-project <项目摘要或名称>`
+
+## 目标
+
+以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文：
+
+- 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
+- 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
+- ✨ **为了提升可读性，会在根 `CLAUDE.md` 中自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑**。
+
+## 编排说明
+
+**步骤 1**：调用 `get-current-datetime` 子智能体获取当前时间戳。
+
+**步骤 2**：调用一次 `init-architect` 子智能体，输入：
+
+- `project_summary`: $ARGUMENTS
+- `current_timestamp`: (来自步骤1的时间戳)
+
+## 执行策略（由 Agent 自适应决定，不需要用户传参）
+
+- **阶段 A：全仓清点（轻量）**
+  快速统计文件与目录，识别模块根（package.json、pyproject.toml、go.mod、apps/_、packages/_、services/\* 等）。
+- **阶段 B：模块优先扫描（中等）**
+  对每个模块做"入口/接口/依赖/测试/数据模型/质量工具"的定点读取与样本抽取。
+- **阶段 C：深度补捞（按需）**
+  若仓库较小或模块规模较小，则扩大读取面；若较大，则对高风险/高价值路径分批追加扫描。
+- **覆盖率度量与可续跑**
+  输出"已扫描文件数 / 估算总文件数、已覆盖模块占比、被忽略/跳过原因"，并列出"建议下一步深挖的子路径"。重复运行 `/init-project` 时按上次索引做**增量更新**与**断点续扫**。
+
+## 安全与边界
+
+- 只读/写文档与索引，不改源代码。
+- 默认忽略常见生成物与二进制大文件。
+- 结果在主对话打印"摘要"，全文写入仓库。
+
+## 输出要求
+
+- 在主对话中打印"初始化结果摘要"，包含：
+  - 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览。
+  - 识别的模块数量及其路径列表。
+  - 每个模块 `CLAUDE.md` 的生成/更新情况。
+  - ✨ **明确提及"已生成 Mermaid 结构图"和"已为 N 个模块添加导航面包屑"**。
+  - 覆盖率与主要缺口。
+  - 若未读全：说明"为何到此为止"，并列出**推荐的下一步**（例如"建议优先补扫：packages/auth/src/controllers"）。