dev-manager-tauri/.claude/skills/architect/SKILL.md
lanrtop eb346ae1fd feat: add runtime diagnostics, health center, and project mentor
运行时可观测性:
- 新增 runtime_logs SQLite 表,提供全局 log_event 写入函数(保留最近 500 条)
- mcp_server/mcp_inject/groups 关键路径接入结构化日志
- MCP 新增 get_diagnostics 工具,返回注入摘要与近期错误
- add_group_member 注入失败时前端显示黄色 toast 警告

健康中心:
- 新增 run_health_check 命令(6 项并行检查:MCP/Git 路径/项目路径/GitHub Token/编辑器/DB 延迟)
- 新增质量指标聚合(休眠项目/孤立项目/注入异常组/无路径项目)
- 侧边栏新增健康中心页面,支持手动刷新和诊断报告复制
- 设置页 MCP 状态改为真实 HTTP ping 检测

项目导师:
- 新增 get_mentor_context 后端命令,聚合健康状态/蓝图摘要/近期错误
- MCP 新增 get_project_mentor_context 工具(含产品组归属校验)
- 项目卡片底部新增 🎓 导师按钮,面板支持复制结构化 Markdown 报告
- 修复 WSL 项目路径识别:wsl_path 存 UNC 格式时自动提取 distro 和 Linux 路径,改用 wsl 命令检查路径存在性(规避 Path::exists() 对 \wsl.localhost\... 不可靠的问题)

AI 工作流:
- 新增 AI-WORKFLOW.md、.claude/skills/ 技能体系配置
- 更新 CLAUDE.md 补充蓝图驱动开发规范
2026-04-04 19:58:49 +09:00

1.8 KiB
Raw Blame History

name description allowed-tools
architect 针对复杂新功能做架构分析,输出设计决策文档,为 splitter 提供输入。Use for L-complexity tasks before writing any code. Read, Glob, Grep, Bash(git log *), Bash(git diff *)

架构分析

在写任何代码之前,先理解现有结构,再做设计决策。

步骤

1. 读取项目上下文

  • 读取 CLAUDE.md 了解技术栈和目录结构
  • 若存在 .blueprint/manifest.yaml,读取它了解模块全景和依赖关系

2. 分析现有实现模式

根据需求涉及的层次读取核心文件:

  • 数据层入口(数据库 schema、model 定义)
  • 后端服务层API / command 注册列表)
  • 前端调用层API 封装、状态管理)
  • 相关功能模块的现有实现(同类功能参考)

3. 识别系统边界

确认本次需求涉及的层次变更:

  • 是否需要新增数据表或字段
  • 是否需要新增后端接口 / command
  • 前后端数据流如何变化

4. 输出设计文档

## 设计决策:<功能名>

### 背景
<关联的现有模块>

### 方案选择
<2-3 个方案及取舍,标注选定方案>

### 受影响文件
- 新增:<路径> — <用途>
- 修改:<路径> — <改动说明>

### 系统边界变更
<新增接口 / 数据表 / 字段定义>

### 风险点
- <风险><规避方式>

### 拆解建议
建议拆为 N 张任务卡依赖顺序卡A → 卡B → 卡C

5. 更新蓝图(若项目有 .blueprint/

  • 若需要新模块,在 manifest.yaml 新增status: concept
  • 创建对应 modules/<id>.md 骨架

原则

  • 不写任何代码,只输出设计文档
  • 设计文档要足够具体,让 splitter 能直接产出可派发任务卡
  • 需求不清晰时先向用户确认,再开始分析