Copilot commented on code in PR #355: URL: https://github.com/apache/hugegraph-ai/pull/355#discussion_r3346670092
########## tools/ai/hugegraph-ai-deepwiki-skill/README-zh.md: ########## @@ -0,0 +1,121 @@ +# HugeGraph AI 仓库知识助手 + +[English](README.md) | [中文](README-zh.md) + +这个独立模块将 [Apache HugeGraph AI](https://github.com/apache/hugegraph-ai) 源码仓库问答能力打包为 Claude Code 和 Codex 可安装的 skill。 + +DeepWiki 是底层线上知识库和 MCP 传输通道： + +```text +https://deepwiki.com/apache/hugegraph-ai +https://mcp.deepwiki.com/mcp +``` + +## 功能 + +- 回答 HugeGraph AI 模块、agent、RAG 工作流、图增强 AI、模型集成、配置、示例、安装和实现细节相关问题。 +- 使用 `read_wiki_contents` 构建本地 DeepWiki wiki 缓存，并优先搜索缓存。 +- 当缓存内容不能直接、精准回答问题时，使用 `ask_question` 获取线上答案。 +- 普通问答不会 clone 上游源码仓库。 + +## 前置要求 + +- Python 3.9 或更高版本，用于运行随附的 MCP 客户端脚本。 +- 当前环境需要能访问 `https://mcp.deepwiki.com/mcp`。 Review Comment: 中文 README 声明脚本支持 Python 3.9+，但 `deepwiki_mcp.py` 使用了 `Path | None` 等 PEP 604 联合类型语法（仅 Python 3.10+ 支持）。当前前置要求会误导 3.9 用户并导致运行时报 SyntaxError。 ########## tools/ai/hugegraph-ai-deepwiki-skill/README.md: ########## @@ -0,0 +1,121 @@ +# HugeGraph AI Repository Assistant + +[中文](README-zh.md) | [English](README.md) + +This standalone module packages a Claude Code and Codex skill for answering questions about the [Apache HugeGraph AI](https://github.com/apache/hugegraph-ai) source repository. + +DeepWiki is used as the online knowledge and MCP transport layer: + +```text +https://deepwiki.com/apache/hugegraph-ai +https://mcp.deepwiki.com/mcp +``` + +## What It Does + +- Answers repository-grounded questions about HugeGraph AI modules, agents, RAG workflows, graph-enhanced AI features, model integration, configuration, examples, installation, and implementation details. +- Uses `read_wiki_contents` to build a local DeepWiki wiki cache and searches that cache before answering. +- Uses `ask_question` when the cached context does not directly and precisely answer the question. +- Avoids cloning upstream repositories for ordinary Q&A. + +## Requirements + +- Python 3.9 or later for the bundled MCP client script. +- Network access to `https://mcp.deepwiki.com/mcp`. Review Comment: The README states the bundled MCP client supports Python 3.9+, but the script uses PEP 604 union type syntax (e.g., `Path | None`), which is only valid in Python 3.10+. This makes the stated requirement inaccurate for users and will fail with SyntaxError on 3.9. ########## tools/ai/hugegraph-ai-deepwiki-skill/plugins/hugegraph-ai-deepwiki-skill/skills/hugegraph-ai-deepwiki-skill/SKILL.md: ########## @@ -0,0 +1,87 @@ +--- +name: hugegraph-ai-deepwiki-skill +description: Use this skill as a repository knowledge assistant for Apache HugeGraph AI, apache/hugegraph-ai source code, architecture, modules, examples, agents, RAG workflows, graph-enhanced AI features, model integration, configuration, installation, demos, or implementation details. It answers questions grounded in apache/hugegraph-ai and uses the official DeepWiki MCP wiki as the underlying retrieval channel. +metadata: + short-description: Apache HugeGraph AI repository assistant +--- + +# HugeGraph AI Repository Knowledge Assistant + +Answer questions about the Apache HugeGraph AI source repository. Use the official DeepWiki MCP server as the underlying knowledge retrieval channel. + +- Source repository: `https://github.com/apache/hugegraph-ai` +- DeepWiki page: `https://deepwiki.com/apache/hugegraph-ai` +- MCP endpoint: `https://mcp.deepwiki.com/mcp` +- Default repository: `apache/hugegraph-ai` +- Runtime requirements: Python 3.9+ and network access to the MCP endpoint. Review Comment: SKILL.md declares runtime requirements as Python 3.9+, but the included `scripts/deepwiki_mcp.py` uses Python 3.10-only syntax (PEP 604 unions like `int | None`). This should be corrected so users don't attempt to run it on Python 3.9. ########## .gitattributes: ########## @@ -14,5 +14,7 @@ hugegraph-ml/ export-ignore .idea/ export-ignore style/ export-ignore scripts/ export-ignore +tools/ai/hugegraph-ai-deepwiki-skill/plugins/hugegraph-ai-deepwiki-skill/skills/hugegraph-ai-deepwiki-skill/scripts/ -export-ignore +tools/ai/hugegraph-ai-deepwiki-skill/plugins/hugegraph-ai-deepwiki-skill/skills/hugegraph-ai-deepwiki-skill/scripts/** -export-ignore Review Comment: The two `-export-ignore` entries appear to be a no-op and confusing: `.gitattributes` only ignores the top-level `scripts/` directory (line 16), so there is no inherited `export-ignore` to negate for this tool’s `.../scripts/` path. Keeping these lines suggests special handling that doesn’t currently exist and may cause surprises if future rules are added. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
