Skill: northcipher/project-assistant (version 1.0.0)

--- name: project-assistant description: 项目初始化与智能分析工具。当用户要求初始化新项目、分析项目结构、项目问答时使用。触发词：初始化项目、init、分析项目、项目问答。 metadata: openclaw: emoji: "🚀" homepage: "https://github.com/Northcipher/project-assistant" requires: bins: ["python3"] --- # 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: 确定项目目录 ```bash # 读取配置的工作目录 python3 {baseDir}/scripts/config_manager.py {baseDir} get workdir ``` 优先级：命令行参数 > 配置的 workdir > 当前目录 ### Step 2: 检查项目文档 检查 `$PROJECT_DIR/.claude/project.md` 是否存在，不存在则调用 `/init` ### Step 3: 智能缓存检查 根据问题类型决定缓存检查策略： | 问题类型 | 检查策略 | 原因 | |---------|---------|------| | LOCATION | 跳过 | 直接搜索即可 | | CONFIG | 快速 | 只检查时间戳 | | ARCHITECTURE | 完整 | 需要最新数据 | | IMPACT | 强制 | 必须最新 | ```bash python3 {baseDir}/scripts/utils/cache_manager.py check "$PROJECT_DIR" --quick ``` ### Step 4: 搜索历史问答 ```bash python3 {baseDir}/scripts/qa_doc_manager.py "$PROJECT_DIR" search "$QUERY" ``` ### Step 5: 分析并回答 根据问题意图选择回答策略： | 意图 | 关键词 | 格式 | |------|--------|------| | LOCATION | 在哪、哪个文件 | 简洁路径 | | EXPLAIN | 怎么实现、原理 | Markdown详情 | | MODIFY | 如何修改 | 步骤指导 | | IMPACT | 影响什么 | 影响树 | ### Step 6: 沉淀问答文档 ```bash python3 {baseDir}/scripts/qa_doc_manager.py "$PROJECT_DIR" create "$QUESTION" "$ANSWER" "$FILES" "$TAGS" ``` --- ## 工具命令 ```bash # 配置管理 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

path: tests/__init__.py
content: """
Project Assistant 测试套件
"""

path: tests/test_parsers/__init__.py
content: """
Tests for parsers package
"""

Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)