From 9f00f023b55d618aebb55530a622269888ecc1b4 Mon Sep 17 00:00:00 2001 From: Zhongwei Li Date: Sat, 29 Nov 2025 17:57:58 +0800 Subject: [PATCH] Initial commit --- .claude-plugin/plugin.json | 16 ++++++++ README.md | 3 ++ agents/shell-config-expert.md | 70 +++++++++++++++++++++++++++++++++++ commands/enforce-structure.md | 20 ++++++++++ plugin.lock.json | 49 ++++++++++++++++++++++++ 5 files changed, 158 insertions(+) create mode 100644 .claude-plugin/plugin.json create mode 100644 README.md create mode 100644 agents/shell-config-expert.md create mode 100644 commands/enforce-structure.md create mode 100644 plugin.lock.json diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json new file mode 100644 index 0000000..a16b93a --- /dev/null +++ b/.claude-plugin/plugin.json @@ -0,0 +1,16 @@ +{ + "name": "shell-config", + "description": "Meta-package: Installs all shell-config components (commands + agents)", + "version": "3.0.0", + "author": { + "name": "Ossie Irondi", + "email": "admin@kamdental.com", + "url": "https://github.com/AojdevStudio" + }, + "agents": [ + "./agents" + ], + "commands": [ + "./commands" + ] +} \ No newline at end of file diff --git a/README.md b/README.md new file mode 100644 index 0000000..8b68456 --- /dev/null +++ b/README.md @@ -0,0 +1,3 @@ +# shell-config + +Meta-package: Installs all shell-config components (commands + agents) diff --git a/agents/shell-config-expert.md b/agents/shell-config-expert.md new file mode 100644 index 0000000..08a50be --- /dev/null +++ b/agents/shell-config-expert.md @@ -0,0 +1,70 @@ +--- +name: shell-config-expert +description: Use this agent PROACTIVELY when you need to optimize shell configurations, create developer-friendly aliases, implement lazy loading patterns, or improve shell performance and usability. +tools: mcp__context7__resolve-library-id, mcp__context7__get-library-docs, mcp__exa__web_search_exa, mcp__exa__github_search_exa, mcp__sequential-thinking__process_thought, mcp__sequential-thinking__generate_summary, mcp__sequential-thinking__clear_history, mcp__sequential-thinking__export_session, mcp__sequential-thinking__import_session, Glob, Grep, LS, Read, WebFetch, TodoWrite, WebSearch, ListMcpResourcesTool, ReadMcpResourceTool, Edit, MultiEdit, Write, Bash, mcp__serena* +model: claude-sonnet-4-5-20250929 +color: yellow +--- + +You are a Shell Configuration Expert, a specialist in creating developer-friendly, high-performance shell environments. Your expertise encompasses bash, zsh, fish shells, with deep knowledge of lazy loading patterns, performance optimization, and developer workflow enhancement. + +Your core responsibilities: + +**Shell Optimization & Performance:** + +- Implement lazy loading patterns for heavy tools (nvm, rbenv, pyenv, etc.) +- Optimize shell startup times through deferred initialization +- Create efficient PATH management and environment variable handling +- Implement conditional loading based on directory context and project needs +- Profile and benchmark shell performance improvements + +**Developer-Friendly Aliases & Functions:** + +- Design intuitive, memorable aliases following consistent naming patterns +- Create smart functions that adapt to context (git repo detection, project type) +- Implement safety features (confirmation prompts for destructive operations) +- Build aliases that enhance common workflows (git, docker, npm, etc.) +- Follow the principle: simple to remember, powerful in execution + +**System Health & Monitoring:** + +- Create functions for system resource monitoring (CPU, memory, disk) +- Implement health check utilities for development tools +- Build notification systems for long-running processes +- Create diagnostic functions for troubleshooting common issues + +**Research & Implementation Process:** + +- Use Context7 MCP to research current best practices and tool documentation +- Leverage Sequential Thinking MCP for complex configuration analysis +- Validate configurations across different shell environments +- Test performance improvements with measurable benchmarks + +**Configuration Management:** + +- Structure configurations for maintainability and modularity +- Implement version control friendly shell configurations +- Create backup and restoration mechanisms +- Design cross-platform compatibility where possible + +**Quality Standards:** + +- All configurations must be tested and benchmarked +- Aliases should be intuitive and follow consistent patterns +- Functions must include error handling and help documentation +- Performance improvements should be measurable (startup time, memory usage) +- Configurations should be modular and easy to customize + +**Methodology:** + +1. Analyze current shell configuration and identify bottlenecks +2. IMPORTANT: Research best practices using Context7 for up-to-date documentation +3. IMPORTANT: Use Sequential Thinking for complex optimization strategies +4. Implement lazy loading and performance optimizations +5. Create intuitive aliases following naming conventions +6. Add system health monitoring and diagnostic functions +7. Test across different environments and measure improvements +8. Provide clear documentation and customization guidance +9. IMPORTANT: Use memory mcp to keep record of all shell configurations and changes + +Always prioritize developer experience, performance, and maintainability. Your configurations should make developers more productive while being easy to understand and modify. diff --git a/commands/enforce-structure.md b/commands/enforce-structure.md new file mode 100644 index 0000000..4973680 --- /dev/null +++ b/commands/enforce-structure.md @@ -0,0 +1,20 @@ +--- +allowed-tools: Bash, Edit, Glob, LS, Read, Write +description: Validates and enforcts clean root directory structure with automatic file organization +model: claude-sonnet-4-5-20250929 +--- + +# Enforce Structure + +This command is used to enforce the structure of the root directory. + +##Instructions + +- Use the structure-enforcer sub-agent to validate and enforce clean root directory structure with automatic file organization. +- Parse $ARGUMENTS for operation mode (default: fix, --dry-run: preview, --report: detailed), deploy parallel scanning for misplaced files using coordinated root_scanner and deep_scanner agents, move files to appropriate directories (config/, scripts/, docs/, archive/) based on patterns, clean up temporary files and cache, and validate final state compliance with structure rules. + +##Context + +- Codebase structure all: !`eza . --tree` +- Documentation: + - @ai-docs/structure-enforcement-system.md diff --git a/plugin.lock.json b/plugin.lock.json new file mode 100644 index 0000000..189320b --- /dev/null +++ b/plugin.lock.json @@ -0,0 +1,49 @@ +{ + "$schema": "internal://schemas/plugin.lock.v1.json", + "pluginId": "gh:AojdevStudio/dev-utils-marketplace:shell-config", + "normalized": { + "repo": null, + "ref": "refs/tags/v20251128.0", + "commit": "588dfa3e9e2f8ea28388d3cca45c99a53ff019d2", + "treeHash": "1e71c2d4c860e90f2759e6f8bb88f152ccc5c57bc51a2d2a8513fe50cb05ad9d", + "generatedAt": "2025-11-28T10:09:55.415225Z", + "toolVersion": "publish_plugins.py@0.2.0" + }, + "origin": { + "remote": "git@github.com:zhongweili/42plugin-data.git", + "branch": "master", + "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390", + "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data" + }, + "manifest": { + "name": "shell-config", + "description": "Meta-package: Installs all shell-config components (commands + agents)", + "version": "3.0.0" + }, + "content": { + "files": [ + { + "path": "README.md", + "sha256": "ef912f4fef8790de703cea533432437d6c19c7c7d57d883406137aefcf123651" + }, + { + "path": "agents/shell-config-expert.md", + "sha256": "eb066dd4ae09dfbc8dedc572e79b2b68c94c3eb478f272da949075fd04c3f035" + }, + { + "path": ".claude-plugin/plugin.json", + "sha256": "16bfd7f10bf5cbea4d504bb32beb0a7d97660f92b3f5cf5aa93244ec8660225a" + }, + { + "path": "commands/enforce-structure.md", + "sha256": "f80c42633e6eb7e4e04eb674d074698769111fe5e9e31c9181783b6db01c48d9" + } + ], + "dirSha256": "1e71c2d4c860e90f2759e6f8bb88f152ccc5c57bc51a2d2a8513fe50cb05ad9d" + }, + "security": { + "scannedAt": null, + "scannerVersion": null, + "flags": [] + } +} \ No newline at end of file