project-assistant

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

触发条件

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

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

角色视角

问题类型	角色	关注点
架构设计	架构师	系统架构、扩展性
功能实现

开发工程师 | 代码逻辑、调试 | | 项目进度 | 项目经理 | 里程碑、风险点 | | 测试质量 | 测试工程师 | 测试用例、覆盖率 | | 部署运维 | DevOps | 部署流程、环境配置 |

---

命令索引

配置管理

命令	说明	详细指南
INLINECODE0	设置配置项	INLINECODE1
INLINECODE2

获取配置项 | - | | /show-config | 显示所有配置 | - | | /delete-config <key> | 删除配置项 | - |

项目初始化

命令	说明	详细指南
INLINECODE5	初始化项目	INLINECODE6

问答文档

命令	说明	详细指南
INLINECODE7	搜索历史问答	INLINECODE8
INLINECODE9

列出问答文档 | - | | /check-qa | 检查文档过期 | - | | /delete-qa <id> | 删除问答文档 | - |

飞书集成

命令	说明	详细指南
INLINECODE12	生成更新建议	INLINECODE13
INLINECODE14

检查同步状态 | - | | /feishu-suggest <file> <type> | 生成文档建议 | - |

---

执行流程

Step 1: 确定项目目录

CODEBLOCK0

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

Step 2: 检查项目文档

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

Step 3: 智能缓存检查

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

问题类型	检查策略	原因
LOCATION	跳过	直接搜索即可
CONFIG

快速 | 只检查时间戳 |
| ARCHITECTURE | 完整 | 需要最新数据 |
| IMPACT | 强制 | 必须最新 |

CODEBLOCK1

Step 4: 搜索历史问答

CODEBLOCK2

Step 5: 分析并回答

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

意图	关键词	格式
LOCATION	在哪、哪个文件	简洁路径
EXPLAIN

怎么实现、原理 | Markdown详情 |
| MODIFY | 如何修改 | 步骤指导 |
| IMPACT | 影响什么 | 影响树 |

Step 6: 沉淀问答文档

CODEBLOCK3

---

工具命令

CODEBLOCK4

---

子模块索引

按需加载详细指南：

模块	路径	内容
配置管理	INLINECODE18	配置项详细说明
项目初始化

{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 |

---

目录结构

CODEBLOCK5

依赖

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

许可证

MIT License