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
dvcrn