LRriver opened a new pull request, #3045:
URL: https://github.com/apache/hugegraph/pull/3045
## Purpose of the PR
- No linked issue. This PR adds an optional repository knowledge assistant
module for Claude Code and Codex users who want DeepWiki-grounded Q&A for
Apache HugeGraph.
## Main Changes
- Add `tools/ai/hugegraph-deepwiki-skill` as a standalone installable module.
- Package a Claude Code plugin manifest, Codex plugin manifest, and the
`hugegraph-deepwiki-skill` skill.
- Include bilingual README files with local checkout, branch checkout,
manual skill install, and AI-assisted install instructions.
- Add a small DeepWiki MCP client script that supports `structure`,
`contents`, `context`, `ask`, and `tools` commands.
- Keep the module isolated under `tools/ai/` so it does not affect HugeGraph
runtime, Maven modules, or repository root plugin configuration.
## Verifying these changes
- [x] Need tests and can be verified as follows:
- `python3 -m json.tool
tools/ai/hugegraph-deepwiki-skill/.agents/plugins/marketplace.json`
- `python3 -m json.tool
tools/ai/hugegraph-deepwiki-skill/.claude-plugin/marketplace.json`
- `python3 -m json.tool
tools/ai/hugegraph-deepwiki-skill/plugins/hugegraph-deepwiki-skill/.codex-plugin/plugin.json`
- `python3 -m json.tool
tools/ai/hugegraph-deepwiki-skill/plugins/hugegraph-deepwiki-skill/.claude-plugin/plugin.json`
- `python3 -m py_compile
tools/ai/hugegraph-deepwiki-skill/plugins/hugegraph-deepwiki-skill/skills/hugegraph-deepwiki-skill/scripts/deepwiki_mcp.py`
- `claude plugin validate tools/ai/hugegraph-deepwiki-skill`
- `claude plugin validate
tools/ai/hugegraph-deepwiki-skill/plugins/hugegraph-deepwiki-skill`
- `codex plugin marketplace add
"$(pwd)/tools/ai/hugegraph-deepwiki-skill"`
- `codex plugin add hugegraph-deepwiki-skill@hugegraph-deepwiki-skill`
- `python3 scripts/deepwiki_mcp.py structure --repo hugegraph`
- `python3 scripts/deepwiki_mcp.py context --repo hugegraph --query
"Which components handle schema operations?" --limit 1`
- `DEEPWIKI_MCP_STREAM_TIMEOUT=60 python3 scripts/deepwiki_mcp.py ask
--repo hugegraph --question "Which HugeGraph components handle schema
operations?"`
## Does this PR potentially affect the following parts?
- [ ] Dependencies ([add/update
license](https://hugegraph.apache.org/docs/contribution-guidelines/contribute/#321-check-licenses)
info &
[regenerate_known_dependencies.sh](../install-dist/scripts/dependency/regenerate_known_dependencies.sh))
- [ ] Modify configurations
- [ ] The public API
- [x] Other affects: Adds an optional AI assistant module under `tools/ai/`.
- [ ] Nope
## Documentation Status
- [ ] `Doc - TODO`
- [x] `Doc - Done`
- [ ] `Doc - No Need`
--
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]
