Files
tzw d3fb57d39f feat: 支持多工作区,将 $PWD 替换为 {{WORKDIR}} 占位符
问题:
- 用户通过 /add-dir 添加多个工作区时,Codex/Gemini 无法找到新增的工作区
- 原因是命令模板中硬编码使用 $PWD,始终指向初始工作目录

解决方案:
- 将所有命令模板中的 $PWD 替换为 {{WORKDIR}} 占位符
- 添加工作目录说明文档,指导用户如何选择目标工作区
- 支持 Glob/Grep 自动识别或 AskUserQuestion 手动选择

影响文件:17 个命令模板
2026-02-02 22:45:45 +08:00

2.5 KiB
Raw Permalink Blame History

description
description
初始化项目 AI 上下文:生成根级与模块级 CLAUDE.md 索引

Init - 初始化项目 AI 上下文

以「根级简明 + 模块级详尽」策略生成项目 AI 上下文文档。

使用方法

/init <项目摘要或名称>

上下文

  • 项目摘要:$ARGUMENTS
  • 生成/更新根级与模块级 CLAUDE.md
  • 自动生成 Mermaid 结构图和导航面包屑

你的角色

你是协调者,负责调用子智能体完成项目扫描与文档生成。


执行工作流

⚠️ 必须按以下步骤执行,使用 Task 工具调用子智能体

🕐 步骤 1:获取当前时间戳

必须首先调用 get-current-datetime 子智能体:

Task({
  subagent_type: "get-current-datetime",
  prompt: "获取当前日期时间,用于文档时间戳",
  description: "获取当前时间"
})

等待返回时间戳后,保存为 $TIMESTAMP 供后续使用。

🏗️ 步骤 2:调用初始化架构师

使用 init-architect 子智能体执行完整扫描:

Task({
  subagent_type: "init-architect",
  prompt: "扫描项目并生成 CLAUDE.md 文档。\n\n项目摘要:$ARGUMENTS\n当前时间戳:$TIMESTAMP\n工作目录:{{WORKDIR}}\n\n请执行:\n1. 阶段 A:全仓清点(文件统计、模块识别)\n2. 阶段 B:模块优先扫描(入口、接口、依赖、测试)\n3. 阶段 C:深度补捞(按需)\n4. 阶段 D:生成文档(根级 + 模块级 CLAUDE.md)\n\n输出覆盖率报告与推荐下一步。",
  description: "初始化项目文档"
})

📊 步骤 3:汇总结果

子智能体完成后,向用户展示:

## 初始化结果摘要

### 根级文档
- 状态:[创建/更新]
- 主要栏目:<列表>

### 模块识别
- 识别模块数:X
- 模块列表:
  1. <模块路径>
  2. ...

### 覆盖率
- 已扫描文件:X / Y
- 覆盖模块:X%
- 跳过原因:<如有>

### 生成内容
- ✅ Mermaid 结构图
- ✅ N 个模块导航面包屑

### 推荐下一步
- [ ] 补扫:<路径>

安全边界

  1. 只读/写文档 – 不改源代码
  2. 忽略生成物 – 跳过 node_modules、dist、二进制文件
  3. 增量更新 – 重复运行时做断点续扫

关键规则

  1. 必须使用 Task 工具调用子智能体,不要自己执行扫描逻辑
  2. 先调用 get-current-datetime 获取时间戳
  3. 再调用 init-architect 执行完整扫描
  4. 结果在主对话打印摘要,全文由子智能体写入仓库