project-assistant

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

触发条件

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

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

角色视角

问题类型	角色	关注点
架构设计	架构师	系统架构、扩展性
功能实现	开发工程师	代码逻辑、调试
项目进度	项目经理	里程碑、风险点
测试质量	测试工程师	测试用例、覆盖率
部署运维	DevOps	部署流程、环境配置

---

命令索引

配置管理

命令	说明	详细指南
/set-config <key> <value>	设置配置项	{baseDir}/references/guides/config.md
/get-config <key>	获取配置项	-
/show-config	显示所有配置	-
/delete-config <key>	删除配置项	-

项目初始化

命令	说明	详细指南
/init [目录] [选项]	初始化项目	{baseDir}/references/guides/init.md

问答文档

命令	说明	详细指南
/search-qa <关键词>	搜索历史问答	{baseDir}/references/guides/qa.md
/list-qa [分类]	列出问答文档	-
/check-qa	检查文档过期	-
/delete-qa <id>	删除问答文档	-

飞书集成

命令	说明	详细指南
/feishu-report	生成更新建议	{baseDir}/references/guides/feishu.md
/feishu-status	检查同步状态	-
/feishu-suggest <file> <type>	生成文档建议	-

---

执行流程

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