Skip to content

Conversation

@NTLx
Copy link

@NTLx NTLx commented Jan 28, 2026

Summary

Addressing oceanbase/seekdb#123 (Track 9 - Add seekdb Skill for Claude Code).
Closes #35.

This PR introduces a specialized Claude Code skill to automate the management and synchronization of SeekDB configurations. It simplifies the setup process for new developers while ensuring local environment variables remain secure and uncommitted.

Key Changes

  • Interactive Setup: Added /setup-seekdb command to guide users through environment configuration.
  • Auto-Sync: Added /sync-seekdb to generate config.toml from templates using local .env values.
  • Environment Abstraction: Implemented dynamic proxy detection (proxy &&) and connectivity validation (nc -zv).
  • Safety First: Updated .gitignore and added header warnings to generated files to prevent private data leakage.
  • Documentation: Included design and implementation plans under docs/plans/.

Test Plan

  • Verified /setup-seekdb generates a correct .env file.
  • Verified /sync-seekdb performs correct variable substitution into config.toml.
  • Verified dynamic proxy detection works in restricted network environments.
  • Confirmed connectivity tests pass against a live SeekDB instance (biodev.cm.com:2881).
  • Verified .env and config.toml are correctly ignored by Git.

AI Contribution Details

Generated with Claude Code.

  • Workflow: Brainstorming -> Design Plan -> Subagent-Driven Implementation -> End-to-End Validation.
  • Security: Focused on isolating private environment details from the codebase.

Thank you for your review! 🚀

🤖 Generated with Claude Code

NTLx and others added 2 commits January 28, 2026 09:39
- Added .env and config.toml to .gitignore
- Updated .env.example with better placeholders for SeekDB config

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit introduces a specialized Claude Code skill to automate SeekDB
configuration and synchronization within the EchoKit Server environment.

Changes:
- Implement `.claude/skills/seekdb-management.md` with `/setup-seekdb` and `/sync-seekdb` commands.
- Add `src/resources/config.toml.example` for secure TOML template generation.
- Include comprehensive design and implementation plans in `docs/plans/`.
- Enhance environment abstraction with dynamic proxy detection and connectivity tests.
- Enforce security via gitignore rules and local-only configuration warnings.

Addressing issue: second-state#35

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@alabulei1
Copy link
Member

Hi @NTLx,

Thanks a lot for the contribution! This is a great start 👍
Before we can merge it, there are two things we need to take care of:

  1. Could you please move all SKILL-related documentation into a single folder under ./claude/skills? This helps keep the SKILL structure consistent.

  2. At the moment, the SKILL sets up the seekdb MCP server, but it doesn’t yet connect it to the EchoKit server. We’ll need that connection step to be part of the SKILL.

Feel free to ask if anything is unclear — happy to help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants