thoughtbox-dot-claude

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# thoughtbox-dot-claude

A comprehensive, reusable `.claude/` configuration folder for Claude Code CLI. This repository contains a curated collection of skills, commands, hooks, plugins, agents, and a learning memory system to enhance Claude Code workflows.

## Quick Start

Copy the `.claude/` folder into any project:

```bash
# Clone and copy
git clone https://github.com/Kastalien-Research/thoughtbox-dot-claude.git
cp -r thoughtbox-dot-claude/.claude/ /path/to/your/project/
```

## What's Included

### `/agents` - Custom Sub-Agents

Specialized agents for specific tasks:

- **`meta-agent.md`** - Generates new sub-agent configuration files from descriptions
- **`fact-checking-agent.md`** - Verifies claims in documentation against sources of truth
- **`reasoning-evaluator.md`** - Evaluates reasoning quality and logical consistency

### `/ai_docs` - Reference Documentation

Curated documentation for AI context:

- **Anthropic docs** - Claude Code hooks, subagents, custom commands, output styles
- **OpenAI quick start** - Reference for OpenAI API patterns
- **Memory system design** - Full design documentation for the memory system
- **uv single-file scripts** - Python scripting patterns

### `/bin` - Memory CLI Tools

Command-line utilities for the memory system:

| Command | Description |
|---------|-------------|
| `memory-add` | Add new learnings to memory |
| `memory-query` | Search memory for relevant patterns |
| `memory-stats` | View memory system statistics |
| `memory-rank` | Rank memory entries by relevance |
| `memory-pipe` | Pipe content into memory |

### `/commands` - Slash Commands (Skills)

Organized collection of 60+ slash commands:

#### Core Categories

| Category | Description | Key Commands |
|----------|-------------|--------------|
| **analysis/** | Code analysis & insights | `/context-aware-review`, `/knowledge-graph`, `/evolution-tracker` |
| **clear-thought/** | Structured thinking | `/think-solve`, `/think-debug`, `/think-decide`, `/think-create` |
| **debugging/** | Systematic debugging | `/systematic-debug`, `/distributed-debug`, `/temporal-debug` |
| **development/** | Code generation | `/implementation-variants`, `/spec-to-test`, `/implement-spec` |
| **exploration/** | Solution discovery | `/parallel-explorer` |
| **loops/** | OODA loop building blocks | Authoring, exploration, verification, refinement loops |
| **meta/** | Higher-order frameworks | `/ulysses-protocol`, `/virgil-protocol`, `/learning-accelerator` |
| **orchestration/** | Multi-agent coordination | `/swarm-intelligence`, `/meta-orchestrator`, `/adaptive-workflow` |
| **research/** | Research workflows | `/docs-researcher` |
| **speckit.*** | Specification workflows | `/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement` |
| **startup/** | Session initialization | `/prime`, `/metacursor`, `/metaclaude` |
| **synthesis/** | Pattern extraction | `/pattern-synthesizer`, `/knowledge-fusion`, `/wisdom-distillation` |
| **toolscontext/** | MCP tool context | `/exa`, `/firecrawl`, `/context7` |
| **workflows/** | MCP orchestration | `/mcp-workflow`, `/mcp-chain`, `/mcp-orchestrate` |

#### Memory Commands

- `/memory-start` - Initialize memory system
- `/memory-add-quick` - Quick add to memory
- `/memory-search` - Search memory

### `/hooks` - Lifecycle Hooks

Event-driven shell scripts for Claude Code:

| Hook | Trigger | Purpose |
|------|---------|---------|
| `pre_tool_use.sh` | Before tool execution | Block dangerous git operations, validate commands |
| `post_tool_use.sh` | After tool execution | Log operations, track file access |
| `session_start.sh` | Session begins | Load context, show memory status |
| `session_end_memory.sh` | Session ends | Prompt for learning capture |
| `user_prompt_submit.sh` | User submits prompt | Pre-process user input |
| `git-validator.sh` | Permission requests | Advanced git validation (block/approve/prompt) |
| `notification.sh` | Various events | Desktop notifications |
| `track_file_access.sh` | File operations | Track which files agents access |
| `memory_pattern_detector.sh` | Periodic | Identify memory gaps and patterns |

**Protection Features:**
- Blocks force pushes and direct pushes to protected branches
- Prevents dangerous `rm -rf` operations
- Validates commit message format
- Logs all git operations for audit trail

### `/hooks-alternate` - Alternative Hook Set

Alternative hook implementations with additional utilities:

- **`utils/llm/`** - LLM API wrappers (Anthropic, OpenAI, Ollama)
- **`utils/tts/`** - Text-to-speech integrations (ElevenLabs, OpenAI, pyttsx3)

### `/output-styles` - Response Formatting

Customize Claude's output format:

| Style | Description |
|-------|-------------|
| `ultra-concise.md` | Minimal, essential information only |
| `bullet-points.md` | Structured bullet point format |
| `markdown-focused.md` | Rich markdown formatting |
| `table-based.md` | Tabular data presentation |
| `yaml-structured.md` | YAML-formatted responses |
| `html-structured.md` | HTML-formatted output |
| `tts-summary.md` | Optimized for text-to-speech |
| `genui.md` | Generative UI components |

### `/plugins` - Claude Code Plugins

Modular extensions with commands and agents:

#### agent-sdk-dev
- **Command:** `/new-sdk-app` - Scaffold new Agent SDK projects
- **Agents:** SDK verifiers for Python and TypeScript

#### commit-commands
- **Commands:** `/commit`, `/commit-push-pr`, `/clean_gone`
- **Purpose:** Streamlined git workflows

#### feature-dev
- **Command:** `/feature-dev` - 7-phase feature development workflow
- **Agents:** `code-explorer`, `code-architect`, `code-reviewer`

#### pr-review-toolkit
- **Command:** `/review-pr` - Comprehensive PR review
- **Agents:** `code-reviewer`, `silent-failure-hunter`, `code-simplifier`, `comment-analyzer`, `pr-test-analyzer`, `type-design-analyzer`

#### security-guidance
- **Purpose:** Security-focused hooks and validation

### `/rules` - Learning Memory System

A living memory system that improves over time:

```
rules/
├── 00-meta.md              # How the memory system works
├── TEMPLATE.md             # Template for new rules
├── active-context/         # Current work focus
│   └── current-focus.md
├── infrastructure/         # System-level patterns
│   ├── firebase.md
│   └── hooks-calibration.md
├── lessons/                # Time-stamped learnings
│   └── 2026-01-version-control-safety.md
├── testing/                # Testing conventions
│   └── behavioral-tests.md
└── tools/                  # Tool-specific patterns
    └── thoughtbox.md
```

**Key Features:**
- **Path-specific auto-loading:** Rules load automatically when working on matching files
- **Freshness tags:** Hot (2 weeks), Warm (3 months), Cold (>3 months), Archived
- **Calibration metrics:** Track discovery time, coverage gaps, repeated issues
- **Progressive learning:** Memory improves with each agent interaction

### `/skills` - Reusable Skills

Domain expertise modules:

| Skill | Description |
|-------|-------------|
| `docker/` | Multi-stage builds, security, optimization |
| `effect-ts/` | Effect-TS functional TypeScript patterns |
| `firebase-firestore/` | Firebase Admin SDK and Firestore |
| `gcp-cloud-run/` | Google Cloud Run deployment |
| `mcp-builder/` | Building MCP servers |
| `mcp-client-builder/` | Building MCP clients |
| `skill-creator/` | Creating new skills |
| `thoughtbox-expertise/` | ThoughtBox MCP server patterns |
| `thoughtbox-mcp/` | Building thoughtbox-style MCP servers |
| `zod4/` | Zod 4 schema validation |

### `/status_lines` - Status Line Scripts

Python scripts for custom Claude Code status lines (v2, v3, v4 variants).

### `/data` & `/state`

- **`data/`** - Persistent data storage
- **`state/`** - Runtime state (hook logs, calibration data, file access logs)

### `settings.local.json`

Local settings for enabled MCP servers:

```json
{
  "enabledMcpjsonServers": [
    "github",
    "thoughtbox",
    "firecrawl-mcp",
    "context7"
  ]
}
```

## Memory System Overview

The memory system is designed to make salient information "ready at hand":

1. **Capture** - Document learnings as they happen
2. **Consolidate** - Integrate patterns into domain rules
3. **Prune** - Archive stale information
4. **Calibrate** - Track metrics to improve topology

### Using Memory

```bash
# Check current focus
/read .claude/rules/active-context/current-focus.md

# Search memory
/memory-search "pattern name"

# Capture a learning
/meta capture-learning

# View memory status
.claude/bin/memory-stats
```

## Customization

### Adding New Rules

1. Copy `TEMPLATE.md` to the appropriate domain folder
2. Add YAML frontmatter with path patterns
3. Document learnings in the standard format

### Creating New Commands

Add markdown files to `/commands/[category]/`:

```markdown
# Command Name

Description of what this command does.

## Usage

/command-name [args]

## Implementation

[Command logic here]
```

### Adding Hooks

1. Create shell script in `/hooks/`
2. Make executable: `chmod +x .claude/hooks/your-hook.sh`
3. Configure in `.claude/settings.json`

## Repository Structure

```
.claude/
├── agents/          # Custom sub-agents
├── ai_docs/         # Reference documentation
├── bin/             # CLI utilities
├── commands/        # Slash commands (60+)
├── data/            # Persistent data
├── hooks/           # Lifecycle hooks
├── hooks-alternate/ # Alternative hooks with LLM/TTS utils
├── output-styles/   # Response formatting
├── plugins/         # Modular extensions
├── rules/           # Learning memory system
├── skills/          # Domain expertise
├── state/           # Runtime state
├── status_lines/    # Status line scripts
└── settings.local.json
```

## License

MIT

## Contributing

1. Fork the repository
2. Add your improvements
3. Submit a pull request

Focus areas for contributions:
- New skills for common development tasks
- Additional hooks for safety and automation
- Memory system improvements
- New slash commands for workflows

thoughtbox-dot-claude

A comprehensive, reusable .claude/ configuration folder for Claude Code CLI. This repository contains a curated collection of skills, commands, hooks, plugins, agents, and a learning memory system to enhance Claude Code workflows.

Quick Start

Copy the .claude/ folder into any project:

# Clone and copy
git clone https://github.com/Kastalien-Research/thoughtbox-dot-claude.git
cp -r thoughtbox-dot-claude/.claude/ /path/to/your/project/

What's Included

`/agents` - Custom Sub-Agents

Specialized agents for specific tasks:

meta-agent.md - Generates new sub-agent configuration files from descriptions
fact-checking-agent.md - Verifies claims in documentation against sources of truth
reasoning-evaluator.md - Evaluates reasoning quality and logical consistency

`/ai_docs` - Reference Documentation

Curated documentation for AI context:

Anthropic docs - Claude Code hooks, subagents, custom commands, output styles
OpenAI quick start - Reference for OpenAI API patterns
Memory system design - Full design documentation for the memory system
uv single-file scripts - Python scripting patterns

`/bin` - Memory CLI Tools

Command-line utilities for the memory system:

Command	Description
`memory-add`	Add new learnings to memory
`memory-query`	Search memory for relevant patterns
`memory-stats`	View memory system statistics
`memory-rank`	Rank memory entries by relevance
`memory-pipe`	Pipe content into memory

`/commands` - Slash Commands (Skills)

Organized collection of 60+ slash commands:

Core Categories

Category	Description	Key Commands
analysis/	Code analysis & insights	`/context-aware-review`, `/knowledge-graph`, `/evolution-tracker`
clear-thought/	Structured thinking	`/think-solve`, `/think-debug`, `/think-decide`, `/think-create`
debugging/	Systematic debugging	`/systematic-debug`, `/distributed-debug`, `/temporal-debug`
development/	Code generation	`/implementation-variants`, `/spec-to-test`, `/implement-spec`
exploration/	Solution discovery	`/parallel-explorer`
loops/	OODA loop building blocks	Authoring, exploration, verification, refinement loops
meta/	Higher-order frameworks	`/ulysses-protocol`, `/virgil-protocol`, `/learning-accelerator`
orchestration/	Multi-agent coordination	`/swarm-intelligence`, `/meta-orchestrator`, `/adaptive-workflow`
research/	Research workflows	`/docs-researcher`
speckit.*	Specification workflows	`/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement`
startup/	Session initialization	`/prime`, `/metacursor`, `/metaclaude`
synthesis/	Pattern extraction	`/pattern-synthesizer`, `/knowledge-fusion`, `/wisdom-distillation`
toolscontext/	MCP tool context	`/exa`, `/firecrawl`, `/context7`
workflows/	MCP orchestration	`/mcp-workflow`, `/mcp-chain`, `/mcp-orchestrate`

Memory Commands

/memory-start - Initialize memory system
/memory-add-quick - Quick add to memory
/memory-search - Search memory

`/hooks` - Lifecycle Hooks

Event-driven shell scripts for Claude Code:

Hook	Trigger	Purpose
`pre_tool_use.sh`	Before tool execution	Block dangerous git operations, validate commands
`post_tool_use.sh`	After tool execution	Log operations, track file access
`session_start.sh`	Session begins	Load context, show memory status
`session_end_memory.sh`	Session ends	Prompt for learning capture
`user_prompt_submit.sh`	User submits prompt	Pre-process user input
`git-validator.sh`	Permission requests	Advanced git validation (block/approve/prompt)
`notification.sh`	Various events	Desktop notifications
`track_file_access.sh`	File operations	Track which files agents access
`memory_pattern_detector.sh`	Periodic	Identify memory gaps and patterns

Protection Features:

Blocks force pushes and direct pushes to protected branches
Prevents dangerous rm -rf operations
Validates commit message format
Logs all git operations for audit trail

`/hooks-alternate` - Alternative Hook Set

Alternative hook implementations with additional utilities:

utils/llm/ - LLM API wrappers (Anthropic, OpenAI, Ollama)
utils/tts/ - Text-to-speech integrations (ElevenLabs, OpenAI, pyttsx3)

`/output-styles` - Response Formatting

Customize Claude's output format:

Style	Description
`ultra-concise.md`	Minimal, essential information only
`bullet-points.md`	Structured bullet point format
`markdown-focused.md`	Rich markdown formatting
`table-based.md`	Tabular data presentation
`yaml-structured.md`	YAML-formatted responses
`html-structured.md`	HTML-formatted output
`tts-summary.md`	Optimized for text-to-speech
`genui.md`	Generative UI components

`/plugins` - Claude Code Plugins

Modular extensions with commands and agents:

agent-sdk-dev

Command: /new-sdk-app - Scaffold new Agent SDK projects
Agents: SDK verifiers for Python and TypeScript

commit-commands

Commands: /commit, /commit-push-pr, /clean_gone
Purpose: Streamlined git workflows

feature-dev

Command: /feature-dev - 7-phase feature development workflow
Agents: code-explorer, code-architect, code-reviewer

pr-review-toolkit

Command: /review-pr - Comprehensive PR review
Agents: code-reviewer, silent-failure-hunter, code-simplifier, comment-analyzer, pr-test-analyzer, type-design-analyzer

security-guidance

Purpose: Security-focused hooks and validation

`/rules` - Learning Memory System

A living memory system that improves over time:

rules/
├── 00-meta.md              # How the memory system works
├── TEMPLATE.md             # Template for new rules
├── active-context/         # Current work focus
│   └── current-focus.md
├── infrastructure/         # System-level patterns
│   ├── firebase.md
│   └── hooks-calibration.md
├── lessons/                # Time-stamped learnings
│   └── 2026-01-version-control-safety.md
├── testing/                # Testing conventions
│   └── behavioral-tests.md
└── tools/                  # Tool-specific patterns
    └── thoughtbox.md

Key Features:

Path-specific auto-loading: Rules load automatically when working on matching files
Freshness tags: Hot (2 weeks), Warm (3 months), Cold (>3 months), Archived
Calibration metrics: Track discovery time, coverage gaps, repeated issues
Progressive learning: Memory improves with each agent interaction

`/skills` - Reusable Skills

Domain expertise modules:

Skill	Description
`docker/`	Multi-stage builds, security, optimization
`effect-ts/`	Effect-TS functional TypeScript patterns
`firebase-firestore/`	Firebase Admin SDK and Firestore
`gcp-cloud-run/`	Google Cloud Run deployment
`mcp-builder/`	Building MCP servers
`mcp-client-builder/`	Building MCP clients
`skill-creator/`	Creating new skills
`thoughtbox-expertise/`	ThoughtBox MCP server patterns
`thoughtbox-mcp/`	Building thoughtbox-style MCP servers
`zod4/`	Zod 4 schema validation

`/status_lines` - Status Line Scripts

Python scripts for custom Claude Code status lines (v2, v3, v4 variants).

`/data` & `/state`

data/ - Persistent data storage
state/ - Runtime state (hook logs, calibration data, file access logs)

`settings.local.json`

Local settings for enabled MCP servers:

{
  "enabledMcpjsonServers": [
    "github",
    "thoughtbox",
    "firecrawl-mcp",
    "context7"
  ]
}

Memory System Overview

The memory system is designed to make salient information "ready at hand":

Capture - Document learnings as they happen
Consolidate - Integrate patterns into domain rules
Prune - Archive stale information
Calibrate - Track metrics to improve topology

Using Memory

# Check current focus
/read .claude/rules/active-context/current-focus.md

# Search memory
/memory-search "pattern name"

# Capture a learning
/meta capture-learning

# View memory status
.claude/bin/memory-stats

Customization

Adding New Rules

Copy TEMPLATE.md to the appropriate domain folder
Add YAML frontmatter with path patterns
Document learnings in the standard format

Creating New Commands

Add markdown files to /commands/[category]/:

# Command Name

Description of what this command does.

## Usage

/command-name [args]

## Implementation

[Command logic here]

Adding Hooks

Create shell script in /hooks/
Make executable: chmod +x .claude/hooks/your-hook.sh
Configure in .claude/settings.json

Repository Structure

.claude/
├── agents/          # Custom sub-agents
├── ai_docs/         # Reference documentation
├── bin/             # CLI utilities
├── commands/        # Slash commands (60+)
├── data/            # Persistent data
├── hooks/           # Lifecycle hooks
├── hooks-alternate/ # Alternative hooks with LLM/TTS utils
├── output-styles/   # Response formatting
├── plugins/         # Modular extensions
├── rules/           # Learning memory system
├── skills/          # Domain expertise
├── state/           # Runtime state
├── status_lines/    # Status line scripts
└── settings.local.json

License

MIT

Contributing

Fork the repository
Add your improvements
Submit a pull request

Focus areas for contributions:

New skills for common development tasks
Additional hooks for safety and automation
Memory system improvements
New slash commands for workflows

thoughtbox-dot-claude

原始内容

thoughtbox-dot-claude

Quick Start

What's Included

/agents - Custom Sub-Agents

/ai_docs - Reference Documentation

/bin - Memory CLI Tools

/commands - Slash Commands (Skills)

Core Categories

Memory Commands

/hooks - Lifecycle Hooks

/hooks-alternate - Alternative Hook Set

/output-styles - Response Formatting

/plugins - Claude Code Plugins

agent-sdk-dev

commit-commands

feature-dev

pr-review-toolkit

security-guidance

/rules - Learning Memory System

/skills - Reusable Skills

/status_lines - Status Line Scripts

/data & /state

settings.local.json

Memory System Overview

Using Memory

Customization

Adding New Rules

Creating New Commands

Adding Hooks

Repository Structure

License

Contributing

`/agents` - Custom Sub-Agents

`/ai_docs` - Reference Documentation

`/bin` - Memory CLI Tools

`/commands` - Slash Commands (Skills)

`/hooks` - Lifecycle Hooks

`/hooks-alternate` - Alternative Hook Set

`/output-styles` - Response Formatting

`/plugins` - Claude Code Plugins

`/rules` - Learning Memory System

`/skills` - Reusable Skills

`/status_lines` - Status Line Scripts

`/data` & `/state`

`settings.local.json`