mc-skills/catalog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
catalog/repos/89jobrien--steve.md

286 lines
10 KiB
Markdown
Raw Normal View History

catalog: 更新 2026-04-06 15:47
2026-04-06 15:47:33 +08:00
# Claude Code组件库
**GitHub**: [89jobrien/steve](https://github.com/89jobrien/steve) | **Gitea**: [mc-skills/89jobrien--steve](http://192.168.0.109:3000/mc-skills/89jobrien--steve)
## 中文摘要
集中管理Claude Code的代理配置、钩子、命令、技能和模板的复用组件仓库，包含137个代理、97个命令、57个技能、59个钩子和27个模板，适用于Claude Code开发工作流自动化场景。
## 标签
`Claude Code` `AI代理` `自动化` `开发工具` `组件库`
---
## README 原文
# steve
Centralized repository for Claude Code agent configurations, hooks, commands, skills, and templates.
## Project Status
| Metric | Value |
| -------------- | ---------------------------------------------------------------------- |
| **Components** | 377 total (137 agents, 97 commands, 57 skills, 59 hooks, 27 templates) |
| **Test Suite** | 415 tests passing |
| **Coverage** | 82.5% |
| **Python** | 3.10+ |
## Overview
This repository provides a well-organized collection of reusable components for Claude Code, including:
- **Agents** - Sub-agent configurations organized by domain and specialization
- **Hooks** - Claude hooks for analysis, guards, workflows, and lifecycle events
- **Commands** - Slash commands for various development workflows
- **Skills** - Reusable skills with bundled resources
- **Rules** - Language and format-specific coding rules
- **Templates** - Templates for creating new components
## Map of Contents
### Core Modules
| Module | Description | Location |
| ----------------------------- | ---------------------------------- | ------------------ |
| [Agents](steve/agents/) | Sub-agent configurations by domain | `steve/agents/` |
| [Commands](steve/commands/) | Slash commands for workflows | `steve/commands/` |
| [Skills](steve/skills/) | Reusable domain knowledge bundles | `steve/skills/` |
| [Hooks](steve/hooks/) | Event-driven automation | `steve/hooks/` |
| [Templates](steve/templates/) | Component scaffolds | `steve/templates/` |
| [Rules](steve/rules/) | Language-specific coding rules | `steve/rules/` |
| [Helpers](steve/helpers/) | Python utility modules | `steve/helpers/` |
### Documentation
| Document | Description |
| ---------------------------------------------- | -------------------------- |
| [Getting Started](docs/GETTING_STARTED.md) | Quick start guide |
| [Installation](docs/INSTALLATION.md) | Detailed installation |
| [Architecture](docs/ARCHITECTURE.md) | System design |
| [Development](docs/DEVELOPMENT.md) | Development workflow |
| [Using Agents](docs/USING_AGENTS.md) | Agent usage guide |
| [Using Commands](docs/USING_COMMANDS.md) | Command usage guide |
| [Using Skills](docs/USING_SKILLS.md) | Skill usage guide |
| [Using Hooks](docs/USING_HOOKS.md) | Hook usage guide |
| [Contributing](docs/CONTRIBUTING.md) | Contribution guidelines |
| [Scripts Reference](docs/SCRIPTS_REFERENCE.md) | Script documentation |
| [FAQ](docs/FAQ.md) | Frequently asked questions |
## Repository Structure
```
steve/
├── agents/ # Sub-agent configurations
│ ├── core/ # Core system agents
│ ├── development/ # Development workflow agents
│ ├── code-quality/ # Code quality and review agents
│ ├── expert-advisors/# Domain expert advisors
│ └── ... # More specialized domains
│
├── hooks/ # Claude hooks
│ ├── analyzers/ # Code analysis hooks
│ ├── guards/ # Guard hooks (pre-commit checks)
│ ├── workflows/ # Workflow automation hooks
│ ├── lifecycle/ # Lifecycle event hooks
│ └── context/ # Context management hooks
│
├── commands/ # Slash commands
│ ├── _team/ # Team collaboration commands
│ ├── agents/ # Agent management commands
│ ├── git/ # Git workflow commands
│ ├── dev/ # Development commands
│ └── ... # More command categories
│
├── skills/ # Reusable skills
│ ├── skill-name/ # Each skill in its own directory
│ │ ├── SKILL.md # Main skill definition
│ │ ├── references/ # Documentation references
│ │ ├── scripts/ # Executable code
│ │ └── assets/ # Output files
│ └── ...
│
├── rules/ # Language-specific rules
│ ├── python.md
│ ├── typescript.md
│ ├── shell.md
│ └── ...
│
├── templates/ # Component templates
│ ├── AGENT_PLAYBOOK.template.md
│ ├── AGENT_SKILL.template.md
│ ├── SLASH_COMMAND.template.md
│ └── ...
│
├── helpers/ # Python helper modules
│ ├── context_monitor.py
│ ├── debug_rotation.py
│ ├── history_archival.py
│ └── ...
│
└── scripts/ # Python management scripts
├── build_index.py
├── install_component.py
├── list_components.py
└── ...
```
## Component Organization
### Domain/Specialization Hierarchy
Components are organized by domain and specialization to enable:
- **Easy discovery** - Find components by domain
- **Logical grouping** - Related components are co-located
- **Scalability** - Add new domains without restructuring
### Naming Conventions
- **Agents**: `kebab-case` (e.g., `code-reviewer`, `dependency-manager`)
- **Skills**: `kebab-case` (e.g., `code-context-finder`, `tdd-pytest`)
- **Commands**: `kebab-case.md` (e.g., `create-subagent.md`)
- **Hooks**: `kebab-case.py` and `kebab-case.md` pairs
## Quick Start
### Installation
```bash
# Clone the repository
git clone https://github.com/joe/steve.git
cd steve
# Install dependencies
uv sync
# Build the component index
uv run scripts/build_index.py
# Run tests
uv run pytest
```
```bash
# Index
make run-index # Build index
make run-index ARGS="--verbose" # With options
# List
make run-list # List all
make run-list ARGS="--type agent" # Filter by type
# Install
make run-install ARGS="python-pro" # Install component
# Publish
make run-publish # Publish ALL
make run-publish ARGS="steve/agents/core/*.md" # Glob
make run-publish ARGS="steve/agents/core/example-agent.md" # Single
# Secrets
make run-secrets ARGS="--scan" # Scan
make run-secrets ARGS="--baseline" # Baseline
# Metadata
make run-metadata ARGS="steve/agents/core/example-agent.md"
make run-metadata ARGS="steve/agents/core/*.md" # Glob
make run-metadata ARGS="steve/agents/core/*.md --gist-url https://..." # Glob with options
# Batch metadata
make run-batch-metadata ARGS='steve/agents --dry-run'
make run-batch-metadata ARGS='steve/agents --key version 1.0.1'
make run-batch-metadata ARGS='steve/agents --key author "Joseph OBrien" --key status unpublished --key updated 2025-12-23 --key version 1.0.1 --dry-run'
make run-batch-metadata ARGS='steve/agents/core --pattern "*.md" --key category core'
make run-batch-metadata ARGS='steve/skills --pattern "**/SKILL.md" --key type skill'
```
### Using Components
```bash
# List available components
uv run scripts/list_components.py
# Search for specific components
uv run scripts/list_components.py --search "code review"
# Install a component
uv run scripts/install_component.py code-reviewer
```
### Creating New Components
1. Use templates from `steve/templates/`
2. Follow naming conventions (kebab-case)
3. Include YAML frontmatter where applicable
4. Add README.md for complex components
## File Formats
### Agent Files
```yaml
---
name: agent-name
description: Action-oriented description
tools: Read, Write, Grep
model: sonnet
color: cyan
skills: skill1, skill2
---
# Purpose
---
## Instructions
```
### Skill Files
```yaml
---
name: skill-name
description: Third-person description
---
# Skill Title
```
## Contributing
1. Follow the domain/specialization structure
2. Use kebab-case naming conventions
3. Include YAML frontmatter where applicable
4. Add README.md files for complex components
5. Run secrets detection before committing (see Security section)
## Security
- **Secrets Detection**: Configured via `.pre-commit-config.yaml`
- **Sensitive Files**: Excluded via `.gitignore`
- **Public Repository**: Ensure no secrets are committed
## Scripts Reference
| Script | Description |
| ----------------------- | ------------------------------------- |
| `build_index.py` | Build component index from repository |
| `list_components.py` | List and search components |
| `install_component.py` | Install components to Claude Code |
| `install_from_gist.py` | Install from GitHub Gist |
| `publish_to_gist.py` | Publish components to Gist |
| `publish_registry.py` | Publish registry to Gist |
| `add_metadata.py` | Update component frontmatter |
| `detect_secrets.py` | Scan for secrets in codebase |
| `python_to_markdown.py` | Convert Python to Markdown |
## Documentation
- [Getting Started](docs/GETTING_STARTED.md)
- [Architecture](docs/ARCHITECTURE.md)
- [Development Guide](docs/DEVELOPMENT.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Scripts Reference](docs/SCRIPTS_REFERENCE.md)
- [FAQ](docs/FAQ.md)
See `CLAUDE.md` for Claude Code-specific configuration and `docs/` for complete documentation.
Reference in New Issue Copy Permalink