eb346ae1fd
运行时可观测性：
- 新增 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 补充蓝图驱动开发规范
63 lines
1.8 KiB
Markdown
63 lines
1.8 KiB
Markdown
---
|
||
name: architect
|
||
description: 针对复杂新功能做架构分析，输出设计决策文档，为 splitter 提供输入。Use for L-complexity tasks before writing any code.
|
||
allowed-tools: 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 能直接产出可派发任务卡
|
||
- 需求不清晰时先向用户确认，再开始分析
|