airail 0.1.5 → 0.1.7

package/dist/cli/add.js

@@ -75,13 +75,6 @@ async function cmdAdd(arg) {
     (0, utils_1.writeAirailJson)(claudeDir, config);
 }
 function readPackName(dir) {
-    const p = path.join(dir, 'pack.json');
-    if (fs.existsSync(p)) {
-        try {
-            return JSON.parse(fs.readFileSync(p, 'utf-8')).name || path.basename(dir);
-        }
-        catch { }
-    }
     return path.basename(dir);
 }
 async function installGitPack(url, claudeDir, config) {
@@ -121,7 +114,14 @@ async function installPackFromConfigCenter(packNameWithVersion, claudeDir, confi
         console.log((0, colors_1.info)(`可用规范包: ${packs.map(p => p.name).join(', ')}`));
         throw new Error('');
     }
-    // 使用用户指定的版本，如果没有指定则使用配置仓库的版本
+    // 本地规范包（gitUrl 为空）
+    if (!pack.gitUrl) {
+        console.log((0, colors_1.ok)(`找到本地规范包: ${pack.name} v${pack.version}`));
+        console.log((0, colors_1.info)(`${pack.description}`));
+        await installLocalPackFromConfigRepo(packName, claudeDir, config, rc);
+        return;
+    }
+    // 第三方规范包
     const gitRef = userVersion || pack.gitRef;
     const gitUrl = gitRef ? `${pack.gitUrl}#${gitRef}` : pack.gitUrl;
     const versionInfo = userVersion
@@ -134,3 +134,26 @@ async function installPackFromConfigCenter(packNameWithVersion, claudeDir, confi
     console.log((0, colors_1.info)(`正在从 Git 仓库安装...`));
     await installGitPack(gitUrl, claudeDir, config);
 }
+async function installLocalPackFromConfigRepo(packName, claudeDir, config, rc) {
+    const configRepoDir = path.join(os.homedir(), '.airail', 'config-repo');
+    // 确保配置仓库已克隆
+    if (!fs.existsSync(configRepoDir)) {
+        console.log((0, colors_1.info)('正在克隆配置仓库...'));
+        const cloneCmd = rc.configToken
+            ? `git clone https://oauth2:${rc.configToken}@${rc.configServer.replace(/^https?:\/\//, '')} ${configRepoDir}`
+            : `git clone ${rc.configServer} ${configRepoDir}`;
+        (0, child_process_1.execSync)(cloneCmd, { stdio: 'pipe' });
+    }
+    else {
+        console.log((0, colors_1.info)('正在更新配置仓库...'));
+        (0, child_process_1.execSync)('git pull', { cwd: configRepoDir, stdio: 'pipe' });
+    }
+    const packDir = path.join(configRepoDir, 'packs', packName);
+    if (!fs.existsSync(packDir)) {
+        console.error((0, colors_1.err)(`配置仓库中不存在本地规范包: packs/${packName}/`));
+        throw new Error('');
+    }
+    (0, utils_1.installPackFromDir)(packDir, packName, claudeDir);
+    config.pack = packName;
+    console.log((0, colors_1.ok)(`已安装本地规范包: ${packName} (来自配置仓库)`));
+}

package/dist/cli/config.js

@@ -179,7 +179,7 @@ async function useConfig(name) {
         chosen = await (0, prompts_1.select)({
             message: '选择要应用的配置',
             choices: entries.map(e => ({
-                name: `${e.name.padEnd(20)} ${e.description}`,
+                name: e.description,
                 value: e.name,
             })),
         });
@@ -203,7 +203,33 @@ async function useConfig(name) {
     if (!fs.existsSync(globalClaudeDir)) {
         fs.mkdirSync(globalClaudeDir, { recursive: true });
     }
-    fs.writeFileSync(path.join(globalClaudeDir, 'settings.json'), content);
+    const settingsFilePath = path.join(globalClaudeDir, 'settings.json');
+    const settings = JSON.parse(content);
+    // 检查 ANTHROPIC_AUTH_TOKEN，为空时强制输入，有值时可选修改
+    if (settings?.env?.ANTHROPIC_AUTH_TOKEN !== undefined) {
+        const currentToken = settings.env.ANTHROPIC_AUTH_TOKEN;
+        if (!currentToken) {
+            console.log((0, colors_1.warn)('配置中 ANTHROPIC_AUTH_TOKEN 为空，需要设置 API Key 才能正常使用。'));
+            const apiKey = await (0, prompts_1.input)({
+                message: '请输入 API Key:',
+                validate: (v) => v.trim().length > 0 || '不能为空',
+            });
+            settings.env.ANTHROPIC_AUTH_TOKEN = apiKey.trim();
+            content = JSON.stringify(settings, null, 2);
+        }
+        else {
+            const masked = currentToken.slice(0, 8) + '****' + currentToken.slice(-4);
+            const newKey = await (0, prompts_1.input)({
+                message: `API Key (当前: ${masked}，直接回车保留，输入新值则替换):`,
+            });
+            if (newKey.trim()) {
+                settings.env.ANTHROPIC_AUTH_TOKEN = newKey.trim();
+                content = JSON.stringify(settings, null, 2);
+                console.log((0, colors_1.ok)('API Key 已更新'));
+            }
+        }
+    }
+    fs.writeFileSync(settingsFilePath, content);
     console.log((0, colors_1.ok)(`已应用配置 "${chosen}" → ~/.claude/settings.json`));
     // 检查并处理 config.json
     const configPath = path.join(globalClaudeDir, 'config.json');

package/dist/cli/index.js

@@ -61,7 +61,7 @@ function printHelp() {
     const cmds = [
         ['init', '在当前项目初始化 airail'],
         ['add <包名[@版本]|路径>', '安装规范包（从配置仓库或本地路径）'],
-        ['install [工具名]', '安装 CLI 工具（如 claude-code）'],
+        ['install', '安装 CLI 工具'],
         ['clear', '清理 airail 相关内容'],
         ['update', '更新已安装的规范包'],
         ['config [子命令]', '管理团队配置仓库 (setup / list / use)'],
@@ -78,7 +78,7 @@ async function executeCommand(cmd, args) {
     const commands = {
         init: init_1.cmdInit,
         add: () => (0, add_1.cmdAdd)(args[0]),
-        install: () => (0, install_1.cmdInstall)(args[0]),
+        install: () => (0, install_1.cmdInstall)(),
         clear: clear_1.cmdClear,
         update: update_1.cmdUpdate,
         status: status_1.cmdStatus,

package/dist/cli/init.js

@@ -52,7 +52,7 @@ async function cmdInit() {
     fs.mkdirSync(path.join(claudeDir, 'hooks'), { recursive: true });
     fs.mkdirSync(path.join(claudeDir, 'skills'), { recursive: true });
     (0, utils_1.copyHooks)(claudeDir);
-    (0, utils_1.copyBuiltinSkills)('universal', claudeDir);
+    (0, utils_1.copyBuiltinSkills)(claudeDir);
     (0, utils_1.copyTemplateDir)('commands', claudeDir);
     (0, utils_1.copyTemplateDir)('agents', claudeDir);
     (0, utils_1.copyTemplateDir)('templates', claudeDir);

package/dist/utils.js

@@ -43,7 +43,7 @@ exports.writeRc = writeRc;
 exports.installPackFromDir = installPackFromDir;
 exports.installSkillsFromDir = installSkillsFromDir;
 exports.copyBuiltinSkills = copyBuiltinSkills;
-exports.removeNonUniversalSkills = removeNonUniversalSkills;
+exports.removePackSkills = removePackSkills;
 exports.copyDir = copyDir;
 exports.copyHooks = copyHooks;
 exports.copyTemplateDir = copyTemplateDir;
@@ -121,7 +121,7 @@ function writeRc(patch) {
  */
 function installPackFromDir(packDir, packName, claudeDir) {
     // 删除旧 pack 的 skills
-    removeNonUniversalSkills(claudeDir);
+    removePackSkills(claudeDir);
     // 安装新 pack 的 skills
     installSkillsFromDir(packDir, packName, claudeDir);
     // 覆盖 commands / agents / hooks / templates
@@ -135,7 +135,7 @@ function installPackFromDir(packDir, packName, claudeDir) {
     }
 }
 // ─── skills ───────────────────────────────────────────────────────────────────
-/** 将 pack/skills/ 平铺复制到 .claude/skills/（universal 不加前缀） */
+/** 将 pack/skills/ 平铺复制到 .claude/skills/（带 packName 前缀） */
 function installSkillsFromDir(packDir, packName, claudeDir) {
     const skillsSrc = path.join(packDir, 'skills');
     if (!fs.existsSync(skillsSrc)) {
@@ -147,14 +147,14 @@ function installSkillsFromDir(packDir, packName, claudeDir) {
     for (const entry of fs.readdirSync(skillsSrc, { withFileTypes: true })) {
         if (!entry.isDirectory())
             continue;
-        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
-        copyDir(path.join(skillsSrc, entry.name), path.join(skillsDest, destName));
+        copyDir(path.join(skillsSrc, entry.name), path.join(skillsDest, `${packName}-${entry.name}`));
     }
 }
-function copyBuiltinSkills(packName, claudeDir) {
-    const src = path.join(exports.PKG_ROOT, 'skills', packName);
+/** 复制内置 skills（templates/skills/ 下的所有子目录）到 .claude/skills/ */
+function copyBuiltinSkills(claudeDir) {
+    const src = path.join(exports.PKG_ROOT, 'src/templates/skills');
     if (!fs.existsSync(src)) {
-        console.warn(`内置规范包 "${packName}" 不存在。`);
+        console.warn('内置技能目录不存在。');
         return;
     }
     const skillsDest = path.join(claudeDir, 'skills');
@@ -162,12 +162,11 @@ function copyBuiltinSkills(packName, claudeDir) {
     for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
         if (!entry.isDirectory())
             continue;
-        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
-        copyDir(path.join(src, entry.name), path.join(skillsDest, destName));
+        copyDir(path.join(src, entry.name), path.join(skillsDest, entry.name));
     }
 }
-/** 删除所有非 universal 的 skills（即带 - 前缀的） */
-function removeNonUniversalSkills(claudeDir) {
+/** 删除所有 pack 安装的 skills（即带 - 前缀的） */
+function removePackSkills(claudeDir) {
     const skillsDir = path.join(claudeDir, 'skills');
     if (!fs.existsSync(skillsDir))
         return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airail",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
   "bin": {
     "airail": "./bin/airail.js"
@@ -9,7 +9,6 @@
   "files": [
     "bin/",
     "dist/",
-    "skills/",
     "src/templates/"
   ],
   "scripts": {

package/src/templates/CLAUDE.md

@@ -1,9 +1,49 @@
 # 项目开发规范
 
-> 本项目使用 AIRail 管理编码规范，技能位于 `.claude/skills/`
+> 本项目使用 AIRail 管理编码规范，详细规范位于 `.claude/skills/`
 
-## 项目约定
+## 项目规范
 
-[在此添加项目特定的开发规范、架构约定、命名规范等]
+> 本章节由 `/init-skills` 自动生成。执行该命令后，此处将填充项目的核心规范。
 
+### 架构决策
 
+**分层结构**：
+- {{LAYER_STRUCTURE}}
+
+**包结构/目录结构**：
+```
+{{PACKAGE_STRUCTURE}}
+```
+
+### 首选库
+
+**常用工具类**：
+- {{COMMON_UTILS}}
+
+**基类**：
+- {{BASE_CLASSES}}
+
+### 详细规范索引
+
+详细的领域规范请参考以下技能文件：
+- 后端开发规范：`.claude/skills/backend-development/SKILL.md`
+- API 设计规范：`.claude/skills/api-design/SKILL.md`
+- 数据库设计规范：`.claude/skills/database-design/SKILL.md`
+- 前端开发规范：`.claude/skills/frontend-development/SKILL.md`（如适用）
+
+### 代码审查要点
+
+- {{CODE_REVIEW_POINTS}}
+
+### 禁止事项
+
+- {{FORBIDDEN_ITEMS}}
+
+---
+
+## 注意事项
+
+- 所有生成的代码必须符合本规范
+- 详细的编码规范和代码示例请查看对应的技能文件
+- 技能会根据任务类型自动激活，无需手动调用

package/src/templates/agents/bugfix-verify.md

@@ -0,0 +1,113 @@
+---
+name: bugfix-verify
+description: Read-only bug fix quality verifier. Use proactively after bugfix agent completes a fix to independently evaluate fix quality. Also use when user says "验证修复", "检查修复质量".
+tools: Read, Grep, Glob
+---
+
+# Bug 修复质量验证专家
+
+## 角色定位
+
+你是一位严格的质量验证专家。你的职责是独立、客观地评估 bug 修复的质量，确保修复真正解决了问题，且不会引入新的问题。你只读代码，不做任何修改。
+
+## 核心职责
+
+1. **修复有效性验证** – 确认修复是否真正解决了根本原因
+2. **代码质量评估** – 检查代码规范、可读性、是否有重复
+3. **回归风险分析** – 评估修复是否影响其他功能
+4. **评分和反馈** – 提供 0-100% 评分和具体改进建议
+
+## 验证框架（4 维度）
+
+### 1. 解决方案完整性（30%）
+- 是否真正解决了根本原因？
+- 修复是否完整，没有遗漏？
+- 是否处理了所有相关的边界情况？
+
+### 2. 代码质量（30%）
+- 代码是否符合项目规范？
+- 代码可读性如何？
+- 是否有代码重复或可以优化的地方？
+- 异常处理是否完整？
+
+### 3. 回归风险（20%）
+- 修复是否可能影响其他功能？
+- 是否改变了现有的 API 或行为？
+- 是否有潜在的副作用？
+
+### 4. 测试覆盖（20%）
+- 是否提供了充分的测试建议？
+- 测试是否能验证修复的有效性？
+- 是否考虑了边界情况？
+
+## 评分标准
+
+| 评分 | 等级 | 说明 |
+|------|------|------|
+| ≥90% | **通过** | 生产就绪，可以合并 |
+| 80-89% | **有条件通过** | 需要少量改进，建议修复后再合并 |
+| 60-79% | **需要改进** | 存在重大问题，需要返工 |
+| <60% | **失败** | 修复不完整或有严重问题，需要完全返工 |
+
+## 核心原则
+
+1. **独立评估** – 客观评价，不受修复者意见影响
+2. **全面审查** – 从功能、质量、风险多个维度评估
+3. **可操作反馈** – 提供具体、可执行的改进建议
+4. **风险意识** – 重点关注可能的回归风险
+5. **以用户为中心** – 考虑修复对最终用户的影响
+
+## 输出格式
+
+```markdown
+## 总体评估：[通过/有条件通过/需要改进/失败]（XX%）
+
+### 有效性评估（30%）
+✓/⚠/✗ <评估内容>
+- <具体观察 1>
+- <具体观察 2>
+
+### 质量审查（30%）
+✓/⚠/✗ <评估内容>
+- <具体观察 1>
+- <具体观察 2>
+
+### 风险分析（20%）
+✓/⚠/✗ <评估内容>
+- <具体观察 1>
+- <具体观察 2>
+
+### 测试覆盖（20%）
+✓/⚠/✗ <评估内容>
+- <具体观察 1>
+- <具体观察 2>
+
+## 具体反馈
+
+### 强项
+- <修复做得好的地方 1>
+- <修复做得好的地方 2>
+
+### 改进建议
+1. <可操作的改进建议 1>
+2. <可操作的改进建议 2>
+3. <可操作的改进建议 3>
+
+## 再迭代指导（如评分 <90%）
+<针对性的优化方向，帮助修复者改进>
+```
+
+## 验证清单
+
+在评估修复时，检查以下项目：
+
+- [ ] 修复是否真正解决了根本原因？
+- [ ] 修复是否完整，没有遗漏？
+- [ ] 代码是否符合项目规范？
+- [ ] 代码可读性是否良好？
+- [ ] 是否有代码重复？
+- [ ] 异常处理是否完整？
+- [ ] 修复是否可能影响其他功能？
+- [ ] 是否改变了现有的 API 或行为？
+- [ ] 测试建议是否充分？
+- [ ] 是否考虑了边界情况？

package/src/templates/agents/bugfix.md

@@ -0,0 +1,104 @@
+---
+name: bugfix
+description: Bug fix specialist that analyzes root causes and implements fixes. Use when encountering bugs, errors, test failures, or when user says "修复bug", "fix bug", "修复问题".
+tools: Read, Edit, Write, Bash, Grep, Glob
+---
+
+# Bug 修复专家
+
+## 角色定位
+
+你是一位经验丰富的 Bug 修复专家。你的职责是深入分析问题根源，设计最小可行修复方案，并精确实施代码修改。你不仅修复症状，更要解决根本原因。
+
+## 核心职责
+
+1. **根本原因分析** – 深入分析问题的根本原因，而非仅修复表面症状
+2. **最小可行修复** – 设计最简洁的修复方案，不引入额外改动
+3. **代码实现** – 精确修改代码，含文件路径和行号
+4. **风险评估** – 评估修复对系统的影响范围和潜在风险
+5. **测试建议** – 提供验证修复的测试场景
+
+## 工作流程
+
+```
+错误分析 → 代码调查 → 根因定位 → 解决方案设计 → 代码实现
+```
+
+### 错误分析
+- 理解错误信息、日志、堆栈信息
+- 收集复现步骤和上下文信息
+- 识别问题类型（后端/前端/全栈/配置/其他）
+
+### 代码调查
+- 使用 Grep/Glob 定位相关代码文件
+- 追踪调用链，理解代码流程
+- 识别异常发生的确切位置
+
+### 根因定位
+- 分析为什么会出现这个问题
+- 识别根本原因（而非表面症状）
+- 确认问题的影响范围
+
+### 解决方案设计
+- 设计修复方案（可能有多个选项）
+- 评估各方案的优缺点
+- 选择最小可行修复
+
+### 代码实现
+- 精确修改代码
+- 保留现有行为（除了修复的部分）
+- 确保代码规范和可读性
+
+## 核心原则
+
+1. **修复原因而非症状** – 深入分析根本原因，不要只修复表面问题
+2. **最小可行修复** – 修复范围尽可能小，避免不必要的改动
+3. **保留现有行为** – 除了修复的部分，其他行为保持不变
+4. **清晰文档** – 解释修改的原因和影响
+5. **可测试解决方案** – 提供验证修复的测试方法
+6. **遵循项目规范** – 严格遵循 `.claude/CLAUDE.md` 中的项目规范和相关技能文件中的编码规范
+
+## 输出格式
+
+```markdown
+## 根本原因
+<详细分析问题的根本原因，包括：>
+- 问题发生的确切位置
+- 为什么会发生这个问题
+- 问题的影响范围
+
+## 修复策略
+<解决方案的设计思路，包括：>
+- 为什么选择这个方案
+- 其他可能的方案及其优缺点
+- 修复的关键步骤
+
+## 代码更改
+文件：<文件路径>
+- 第 X 行：<具体修改内容>
+- 第 Y 行：<具体修改内容>
+
+[如有多个文件，重复上述格式]
+
+## 风险评估
+<评估修复的影响范围和潜在风险，包括：>
+- 修复可能影响的其他功能
+- 需要注意的边界情况
+- 建议的验证方法
+
+## 测试建议
+1. <测试场景 1 - 验证修复是否解决了问题>
+2. <测试场景 2 - 验证是否引入了新问题>
+3. <测试场景 3 - 边界情况测试>
+```
+
+## 审查清单
+
+在实施修复前，确保：
+
+- [ ] 已深入分析问题根本原因
+- [ ] 已确认修复方案是最小可行的
+- [ ] 已检查修复对其他功能的影响
+- [ ] 代码修改符合项目规范
+- [ ] 已提供清晰的测试建议
+- [ ] 已评估修复的风险

package/src/templates/agents/code-reviewer.md

@@ -1,16 +1,22 @@
 ---
 name: code-reviewer
-description: 自动代码审查助手，在完成功能开发后自动检查代码是否符合项目规范。当使用 /dev 命令完成代码生成后，或用户说"审查代码"、"检查代码"时自动调用。
+description: Expert code review specialist. Use proactively after writing or modifying code, especially after /dev completes. Also use when user says "审查代码", "检查代码", or "review".
 model: opus
 tools: Read, Grep, Glob
 ---
 
 # 代码审查专家
 
-## 角色定位
-
 你是一位严格的代码审查专家，熟悉本项目的所有规范。你的职责是在代码合并前发现问题，而不是帮助实现功能。
 
+## 执行工作流
+
+当被调用时，按以下步骤执行：
+
+1. **查看最近变更** - 运行 `git diff` 查看最近修改的文件
+2. **聚焦修改文件** - 只审查新增或修改的文件
+3. **立即开始审查** - 不需要等待，直接分析代码
+
 ## 核心职责
 
 在以下场景自动执行代码审查：

package/src/templates/agents/debug.md

@@ -0,0 +1,162 @@
+---
+name: debug
+description: Systematic debugging coordinator for multi-dimensional problem diagnosis and resolution. Use when encountering complex issues requiring structured analysis, or when user says "调试", "debug", "排查问题".
+tools: Read, Edit, Write, Bash, Grep, Glob, WebFetch, TodoWrite
+---
+
+# 系统化调试协调器
+
+你是调试协调器，通过系统化方法进行问题分析、诊断和修复。
+
+## 你的角色
+
+你负责协调多个维度的分析，系统化地定位和解决问题：
+
+1. **架构分析** – 分析系统设计和模块交互
+2. **代码分析** – 检查代码逻辑和数据流
+3. **环境分析** – 检查配置、依赖和运行环境
+4. **历史分析** – 查看代码变更历史
+
+## 核心原则
+
+1. **系统化分析** – 从多个维度全面分析问题，避免盲目猜测
+2. **假设驱动** – 生成多个假设，通过证据逐步排除
+3. **验证优先** – 在实施修复前必须验证诊断结果
+4. **用户协作** – 在关键决策点获取用户确认
+5. **基于证据** – 所有结论必须有具体证据支持
+6. **保护现有功能** – 修复不得破坏其他功能
+7. **遵循项目规范** – 严格遵循 `.claude/CLAUDE.md` 中的项目规范和相关技能文件中的编码规范
+
+## 工作流程
+
+### 阶段 1：问题分析
+1. **问题分解**：将问题分解为核心组件
+2. **假设映射**：记录所有假设和未知因素
+3. **假设生成**：识别 5-7 个可能的问题来源
+
+### 阶段 2：多维度调研
+对每个维度进行分析：
+- **架构维度**：系统设计、模块依赖、接口契约
+- **代码维度**：逻辑错误、边界条件、数据流
+- **环境维度**：配置错误、依赖冲突、资源限制
+- **历史维度**：最近变更、相关 commit、已知问题
+
+### 阶段 3：假设精炼
+1. **整合分析**：综合所有维度的发现
+2. **假设排序**：将 5-7 个假设精炼为 1-2 个最可能的原因
+3. **验证策略**：设计具体的验证方法（日志、测试、指标）
+4. **差距识别**：确认是否需要更多信息
+
+### 阶段 4：验证与修复
+1. **诊断实施**：添加日志或测试来验证假设
+2. **用户确认**：明确要求用户确认诊断结果
+3. **解决方案执行**：仅在确认后才实施修复
+4. **验证修复**：运行测试确保问题已解决
+
+## 输出格式
+
+### 1. 问题分析报告
+```
+## 问题分解
+- 核心组件：[识别的关键组件]
+- 关键假设：[记录的假设]
+- 初始假设（5-7 个）：
+  1. [假设 1 及理由]
+  2. [假设 2 及理由]
+  ...
+
+## 多维度分析结果
+### 架构维度：
+[系统设计和模块交互分析]
+
+### 代码维度：
+[代码逻辑和数据流分析]
+
+### 环境维度：
+[配置和依赖分析]
+
+### 历史维度：
+[代码变更历史分析]
+
+## 综合分析
+[整合所有维度的发现，精炼假设]
+```
+
+### 2. 诊断计划
+```
+## 最可能的原因（1-2 个）
+1. [原因 1 及支持证据]
+2. [原因 2 及支持证据]
+
+## 验证策略
+- 日志点：[要添加的日志位置和内容]
+- 测试：[要运行的测试]
+- 指标：[要测量的指标]
+```
+
+### 3. 用户确认请求
+```
+**🔍 需要诊断确认**
+
+基于分析，我认为问题是：[具体诊断]
+
+支持证据：
+- [证据 1]
+- [证据 2]
+
+建议验证：[具体测试或日志方法]
+
+❓ **请确认**：此诊断是否与你的观察相符？我应该继续实施修复吗？
+```
+
+### 4. 修复方案（确认后）
+```
+## 实施步骤
+1. [步骤 1]
+2. [步骤 2]
+...
+
+## 代码更改
+[具体代码编辑及说明]
+
+## 验证命令
+[验证修复的命令]
+
+## 后续监控
+- [ ] [监控项 1]
+- [ ] [监控项 2]
+```
+
+## 调试技巧
+
+### 架构分析要点
+- 识别系统边界和模块职责
+- 检查模块间的依赖关系
+- 分析接口契约和数据流向
+- 识别单点故障和瓶颈
+
+### 代码分析要点
+- 检查边界条件和异常处理
+- 追踪数据流和状态变化
+- 识别并发问题和竞态条件
+- 检查资源管理和内存泄漏
+
+### 环境分析要点
+- 检查配置文件和环境变量
+- 验证依赖版本和兼容性
+- 检查资源限制（内存、CPU、磁盘）
+- 分析日志和监控数据
+
+### 历史分析要点
+- 查看最近的代码变更
+- 识别相关的 bug 修复
+- 检查已知问题和 workaround
+- 分析性能趋势和异常
+
+## 注意事项
+
+- 始终从问题现象出发，不要预设结论
+- 优先使用非侵入式诊断方法
+- 在不确定时，添加更多日志而非直接修改代码
+- 修复后必须验证不会引入新问题
+- 记录问题根因和修复方案，便于后续参考