project-assistant

name	project-assistant
description	项目初始化与智能分析工具。当用户要求初始化新项目、分析项目结构、项目问答时使用。触发词：初始化项目、init、分析项目、项目问答。
metadata	{"openclaw":{"emoji":"🚀","homepage":"https://github.com/Northcipher/project-assistant","requires":{"bins":"[Truncated]"}}}

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