project-assistant

项目全能助手，支持 50+ 项目类型，提供智能问答、文档沉淀、飞书集成。

触发条件

TRIGGER when: 用户询问项目相关问题：

• "这个项目的架构是什么？"
• "XXX功能是怎么实现的？"
• "如何构建/运行这个项目？"
• "修改XXX会影响什么？"

角色视角

| 问题类型 | 角色 | 关注点 |

|---------|------|-------|

| 架构设计 | 架构师 | 系统架构、扩展性 |

| 功能实现 | 开发工程师 | 代码逻辑、调试 |

| 项目进度 | 项目经理 | 里程碑、风险点 |

| 测试质量 | 测试工程师 | 测试用例、覆盖率 |

| 部署运维 | DevOps | 部署流程、环境配置 |

命令索引

配置管理

| 命令 | 说明 | 详细指南 |

|------|------|---------|

| /set-config | 设置配置项 | {baseDir}/references/guides/config.md |

| /get-config | 获取配置项 | - |

| /show-config | 显示所有配置 | - |

| /delete-config | 删除配置项 | - |

项目初始化

| 命令 | 说明 | 详细指南 |

|------|------|---------|

| /init [目录] [选项] | 初始化项目 | {baseDir}/references/guides/init.md |

问答文档

| 命令 | 说明 | 详细指南 |

|------|------|---------|

| /search-qa <关键词> | 搜索历史问答 | {baseDir}/references/guides/qa.md |

| /list-qa [分类] | 列出问答文档 | - |

| /check-qa | 检查文档过期 | - |

| /delete-qa | 删除问答文档 | - |

飞书集成

| 命令 | 说明 | 详细指南 |

|------|------|---------|

| /feishu-report | 生成更新建议 | {baseDir}/references/guides/feishu.md |

| /feishu-status | 检查同步状态 | - |

| /feishu-suggest | 生成文档建议 | - |

执行流程

Step 1: 确定项目目录

# 读取配置的工作目录
python3 {baseDir}/scripts/config_manager.py {baseDir} get workdir

优先级：命令行参数 > 配置的 workdir > 当前目录

Step 2: 检查项目文档

检查 $PROJECT_DIR/.claude/project.md 是否存在，不存在则调用 /init

Step 3: 智能缓存检查

根据问题类型决定缓存检查策略：

| 问题类型 | 检查策略 | 原因 |

|---------|---------|------|

| LOCATION | 跳过 | 直接搜索即可 |

| CONFIG | 快速 | 只检查时间戳 |

| ARCHITECTURE | 完整 | 需要最新数据 |

| IMPACT | 强制 | 必须最新 |

python3 {baseDir}/scripts/utils/cache_manager.py check "$PROJECT_DIR" --quick

Step 4: 搜索历史问答

python3 {baseDir}/scripts/qa_doc_manager.py "$PROJECT_DIR" search "$QUERY"

Step 5: 分析并回答

根据问题意图选择回答策略：

| 意图 | 关键词 | 格式 |

|------|--------|------|

| LOCATION | 在哪、哪个文件 | 简洁路径 |

| EXPLAIN | 怎么实现、原理 | Markdown详情 |

| MODIFY | 如何修改 | 步骤指导 |

| IMPACT | 影响什么 | 影响树 |

Step 6: 沉淀问答文档

python3 {baseDir}/scripts/qa_doc_manager.py "$PROJECT_DIR" create "$QUESTION" "$ANSWER" "$FILES" "$TAGS"

工具命令

# 配置管理
python3 {baseDir}/scripts/config_manager.py {baseDir} <get|set|delete|show> [args]

# 项目探测
python3 {baseDir}/scripts/detector.py "$PROJECT_DIR"

# 问答文档
python3 {baseDir}/scripts/qa_doc_manager.py "$PROJECT_DIR" <search|list|check|create|delete> [args]

# 飞书集成
python3 {baseDir}/scripts/feishu_doc_manager.py "$PROJECT_DIR" <report|status|suggest> [args]

# 缓存管理
python3 {baseDir}/scripts/utils/cache_manager.py <check|update|clear> "$PROJECT_DIR"

# 调用链分析
python3 {baseDir}/scripts/utils/call_chain_analyzer.py "$PROJECT_DIR" "$FUNCTION" --impact

子模块索引

按需加载详细指南：

| 模块 | 路径 | 内容 |

|------|------|------|

| 配置管理 | {baseDir}/references/guides/config.md | 配置项详细说明 |

| 项目初始化 | {baseDir}/references/guides/init.md | 初始化流程详解 |

| 问答文档 | {baseDir}/references/guides/qa.md | 问答功能详解 |

| 飞书集成 | {baseDir}/references/guides/feishu.md | 飞书协作详解 |

| 示例对话 | {baseDir}/references/guides/examples.md | 完整示例 |

项目类型支持

| 分类 | 类型 |

|------|------|

| 嵌入式MCU | STM32, ESP32, Arduino, Pico, Keil, IAR |

| 嵌入式RTOS | FreeRTOS, Zephyr, RT-Thread |

| 嵌入式Linux | Yocto, Buildroot, OpenWrt, QNX |

| Android | 应用, NDK, AOSP |

| iOS | Swift, SwiftUI |

| Web前端 | React, Vue, Angular, Svelte, Next.js |

| Web后端 | Django, FastAPI, Flask, Spring |

| 桌面应用 | Qt, Electron, Flutter |

| 系统编程 | C/C++, Rust, Go |

目录结构

project-assistant/
├── SKILL.md                    # 主入口（本文件）
├── scripts/                    # Python 工具脚本
│   ├── config_manager.py       # 配置管理器
│   ├── qa_doc_manager.py       # 问答文档管理器
│   ├── feishu_doc_manager.py   # 飞书文档管理器
│   ├── detector.py             # 项目类型探测器
│   ├── parsers/                # 配置文件解析器
│   ├── analyzers/              # 代码分析器
│   └── utils/                  # 工具函数
├── references/
│   ├── templates/              # 子 Skill 模板
│   └── guides/                 # 详细指南（按需加载）
├── tests/                      # 测试套件
└── README.md

依赖

• Python 3.6+
• Git（可选）
• PyYAML（可选）

许可证

MIT License