claude-skills-automation

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

原始内容

# Claude Skills Automation

> **Fully automated memory and context management for Claude Code**
>
> Zero-friction development with automatic context restoration, decision tracking, and permanent memory.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Claude Code](https://img.shields.io/badge/Claude-Code-blue.svg)](https://claude.ai/code)
[![Status](https://img.shields.io/badge/Status-Production%20Ready-green.svg)]()

---

## 🎯 What This Does

Eliminates **all manual memory management** in Claude Code through automated hooks:

### Before ❌
```
You: [Start Claude Code]
Claude: "How can I help?"
You: "hi-ai, what were we working on?"
You: "Remember we're using PostgreSQL"
You: "What did we decide about React?"
```

### After ✅
```
You: [Start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Using PostgreSQL for database (2 days ago)
• Chose React + Vite for frontend (3 days ago)
• Implementing JWT authentication (5 days ago)

**Memory system active**. Ready to continue!

You: [Just start working - context already there]
```

**Zero manual "hi-ai". Zero manual "remember". Just works.**

---

## ✨ Features

### 🚀 Automatic Context Restoration
- Session starts → Context automatically injected
- No more "hi-ai" commands
- Instant continuation from where you left off

### 💾 Automatic Decision Extraction
- Detects decisions from conversation patterns
- Extracts: "using", "chose", "decided", "implemented"
- Saves to memory automatically

### 🚧 Automatic Blocker Tracking
- Detects obstacles: "can't", "blocked by", "waiting for"
- Tracks active blockers
- Surfaces them in next session

### 📝 Automatic Session Saving
- Saves state on session end
- Backs up full transcript
- Never lose context

### 🔍 File Change Tracking
- Monitors significant file edits
- Logs DECISIONS.md, README, code changes
- Creates audit trail

### 💪 Neurodivergent-Optimized
- **ADHD**: Zero friction, immediate execution
- **SDAM**: Complete external memory system
- **Aphantasia**: Visual outputs, concrete examples
- **Dyschronometria**: Time-anchored context
- **Anendophasia**: Externalized reasoning

---

## 🚀 Quick Start

### Basic Installation (2 minutes)

```bash
# Clone repository
git clone https://github.com/toowiredd/claude-skills-automation
cd claude-skills-automation

# Run basic installer
bash scripts/install.sh
```

### Supercharged Installation with Paid Subscriptions Integration

If you have Pieces.app, GitHub Copilot Pro, Docker Pro, Codegen-ai, Jules CLI, or Codacy:

```bash
# Run enhanced installer
bash scripts/install-integrations.sh

# See full integration guide
cat docs/SUBSCRIPTIONS_INTEGRATION.md
```

That's it! Your next Claude Code session will have full automation.

### Verification

```bash
# Start Claude Code session
# Context should appear automatically

# Check automation logs
tail -f ~/.claude-memories/automation.log
```

---

## 📋 What Gets Installed

### Automation Hooks

**Core Hooks (5)** - Memory & context automation:
| Hook | Size | Executes When | Performance |
|------|------|---------------|-------------|
| `session-start.sh` | 3.1 KB | Session starts | 100ms |
| `session-end.sh` | 2.0 KB | Session ends | 50ms |
| `stop-extract-memories.sh` | 2.6 KB | After each response | 200ms |
| `post-tool-track.sh` | 1.4 KB | After file edits | 10ms |
| `pre-compact-backup.sh` | 1.5 KB | Before compression | 100ms |

**Integration Hooks (7)** - 🆕 Paid subscriptions:
- `async-task-jules.sh` - Jules CLI async tasks
- `error-lookup-copilot.sh` - GitHub Copilot error search
- `pre-commit-copilot-review.sh` - AI code review
- `pre-commit-codacy-check.sh` - Quality gates
- `post-tool-save-to-pieces.sh` - Pieces.app sync
- `testing-docker-isolation.sh` - Docker isolated tests
- `codegen-agent-trigger.sh` - Autonomous agents

**Total overhead per session**: <500ms (core only)

### 8 Claude Skills

**Core Skills (5)**:
- **session-launcher** - Zero context loss restoration
- **context-manager** - Permanent memory management
- **error-debugger** - Smart debugging with past solutions
- **testing-builder** - Automatic test generation
- **rapid-prototyper** - Fast idea validation

**New Skills (3)** 🆕:
- **browser-app-creator** - Generates single-file HTML/CSS/JS apps (ADHD-optimized, 60px+ buttons, localStorage)
- **repository-analyzer** - Analyzes codebases, generates documentation, detects patterns, extracts TODOs
- **api-integration-builder** - Creates TypeScript API clients with retry logic, rate limiting, and auth

### Memory Storage
```
~/.claude-memories/
├── index.json              # Master memory index
├── decisions/              # Architecture decisions
├── blockers/               # Active obstacles
├── procedures/             # How-to guides
├── backups/                # Session backups
├── automation.log          # Hook execution log
└── auto-extracted.log      # Auto-extracted memories
```

---

## 📖 Documentation

- **[Quick Start](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/QUICK_START.md)** - Get started in 5 minutes
- **[Complete Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md)** - Full documentation (3,500+ lines)
- **[Subscriptions Integration](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/SUBSCRIPTIONS_INTEGRATION.md)** - 🆕 Paid subscriptions integration guide
- **[Implementation](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/AUTOMATION_IMPLEMENTATION.md)** - Technical details
- **[Research](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/AUTOMATION_RESEARCH.md)** - How we built this

---

## 🎓 How It Works

### System Architecture

```
┌─────────────────────────────────────────┐
│   SessionStart Hook (100ms)              │
│   • Load memory index                    │
│   • Extract recent decisions             │
│   • Find active blockers                 │
│   • Inject context into conversation     │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   You Work Normally                      │
│   • Code, debug, design                  │
│   • Skills activate as needed            │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   PostToolUse Hook (10ms)                │
│   • Track file modifications             │
│   • Log significant changes              │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Stop Hook (200ms)                      │
│   • Analyze conversation                 │
│   • Extract decision patterns            │
│   • Extract blocker patterns             │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   SessionEnd Hook (50ms)                 │
│   • Save session state                   │
│   • Backup transcript                    │
└─────────────────────────────────────────┘
```

### Decision Extraction Patterns

Automatically detects and extracts:

| Pattern | Example | Extracted As |
|---------|---------|--------------|
| "using X" | "We're using PostgreSQL" | DECISION |
| "chose X" | "Chose React over Vue" | DECISION |
| "decided X" | "Decided to implement caching" | DECISION |
| "can't X" | "Can't access the API" | BLOCKER |
| "blocked by X" | "Blocked by missing keys" | BLOCKER |

---

## 🧪 Example Session

### First Session
```bash
You: "Let's build a task tracker with React and PostgreSQL"
Claude: "Great! Let's start..."

# Behind the scenes:
# → Stop hook extracts: "build a task tracker with React and PostgreSQL"
# → Logs as DECISION
# → SessionEnd saves state
```

### Next Session
```bash
[You start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Build a task tracker with React and PostgreSQL (1 day ago)

**Last Working On:** Building task tracker

Ready to continue!

# Zero manual effort - context just there
```

---

## 🔧 Requirements

- **Claude Code** (latest version)
- **Bash** (pre-installed on Linux/macOS)
- **jq** (for JSON processing)
  ```bash
  # Install jq if needed
  sudo apt install jq  # Ubuntu/Debian
  brew install jq      # macOS
  ```

---

## 📊 Performance

| Metric | Value |
|--------|-------|
| Installation time | 2 minutes |
| Hook overhead/session | <500ms |
| Disk usage/year | <100MB |
| Maintenance required | Zero |

---

## 🌟 Community & Credits

Built on research from:
- [claude-code-hooks-mastery](https://github.com/disler/claude-code-hooks-mastery)
- [awesome-claude-code](https://github.com/hesreallyhim/awesome-claude-code)
- [Claude-Code-Everything-You-Need-to-Know](https://github.com/wesammustafa/Claude-Code-Everything-You-Need-to-Know)

### Why We Built This

Designed specifically for **neurodivergent developers**:
- ADHD → Zero friction, immediate results
- SDAM → Complete external memory
- Dyschronometria → Time-anchored context
- Aphantasia → Visual, concrete outputs

---

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/CONTRIBUTING.md) for guidelines.

### Ideas for Contributions

- 🎯 New extraction patterns
- 🔧 Additional hooks
- 📚 More skills
- 🌍 Translations
- 🎨 Better documentation
- 🧪 Tests

---

## 📝 Advanced Usage

### Custom Decision Patterns

Edit `~/.config/claude-code/hooks/stop-extract-memories.sh`:

```bash
# Add your own patterns
local decision_patterns="using|chose|decided|MY_PATTERN"
```

### Pieces.app Integration

Three integration options:
1. Auto-save code to Pieces
2. Export memories to Pieces
3. Use Pieces API as backend

See [Pieces Integration Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md#piecesapp-integration)

### Project-Specific Hooks

Create `.claude/hooks/` in your project for custom automation.

---

## 🐛 Troubleshooting

### Hooks Not Firing?

```bash
# Check hooks are executable
ls -l ~/.config/claude-code/hooks/*.sh

# Fix permissions
chmod +x ~/.config/claude-code/hooks/*.sh
```

### Context Not Appearing?

```bash
# Verify memory index
cat ~/.claude-memories/index.json
jq '.total_memories' ~/.claude-memories/index.json
```

More help: [Troubleshooting Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md#troubleshooting)

---

## 📜 License

MIT License - see [LICENSE](https://github.com/Toowiredd/claude-skills-automation/tree/HEAD/LICENSE)

---

## 🙏 Acknowledgments

Built for the neurodivergent developer community.

If this helps you:
- ⭐ Star this repo
- 🐛 Report issues
- 💡 Suggest improvements
- 🤝 Contribute code

---

## 📞 Support

- **Issues**: [GitHub Issues](https://github.com/toowiredd/claude-skills-automation/issues)
- **Discussions**: [GitHub Discussions](https://github.com/toowiredd/claude-skills-automation/discussions)
- **Docs**: [Complete Guide](https://github.com/Toowiredd/claude-skills-automation/blob/HEAD/docs/README-AUTOMATION.md)

---

## 🎯 Problem → Solution

### For ADHD Developers
| Before ❌ | After ✅ |
|----------|---------|
| Context lost between sessions | Context auto-restored |
| Forget to track decisions | Decisions auto-extracted |
| Manual memory = friction | Zero manual work |

### For SDAM (No Episodic Memory)
| Before ❌ | After ✅ |
|----------|---------|
| Can't remember past decisions | Perfect external memory |
| "What did we decide?" unanswerable | All decisions saved |
| Repeat same mistakes | Past solutions auto-recalled |

### For All Developers
| Before ❌ | After ✅ |
|----------|---------|
| Context loss = productivity drain | Zero context loss |
| Manual "hi-ai" every session | Automatic restoration |
| No session continuity | Seamless continuation |

---

## 🚀 Status

✅ **Production Ready** - Fully tested
✅ **Actively Maintained** - Regular updates
✅ **Community Driven** - Contributions welcome

---

## 📈 Quick Stats

- **12** automation hooks (5 core + 7 integrations)
- **8** Claude Skills (5 core + 3 new)
- **<500ms** overhead
- **<100MB** disk usage/year
- **Zero** maintenance required
- **100%** neurodivergent-optimized

---

**Zero friction. Zero context loss. Forever.**

*Built with ❤️ for the neurodivergent developer community*

---

## Star History

If this project helps you, please consider starring it! ⭐

Claude Skills Automation

Fully automated memory and context management for Claude Code

Zero-friction development with automatic context restoration, decision tracking, and permanent memory.

🎯 What This Does

Eliminates all manual memory management in Claude Code through automated hooks:

Before ❌

You: [Start Claude Code]
Claude: "How can I help?"
You: "hi-ai, what were we working on?"
You: "Remember we're using PostgreSQL"
You: "What did we decide about React?"

After ✅

You: [Start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Using PostgreSQL for database (2 days ago)
• Chose React + Vite for frontend (3 days ago)
• Implementing JWT authentication (5 days ago)

**Memory system active**. Ready to continue!

You: [Just start working - context already there]

Zero manual "hi-ai". Zero manual "remember". Just works.

✨ Features

🚀 Automatic Context Restoration

Session starts → Context automatically injected
No more "hi-ai" commands
Instant continuation from where you left off

💾 Automatic Decision Extraction

Detects decisions from conversation patterns
Extracts: "using", "chose", "decided", "implemented"
Saves to memory automatically

🚧 Automatic Blocker Tracking

Detects obstacles: "can't", "blocked by", "waiting for"
Tracks active blockers
Surfaces them in next session

📝 Automatic Session Saving

Saves state on session end
Backs up full transcript
Never lose context

🔍 File Change Tracking

Monitors significant file edits
Logs DECISIONS.md, README, code changes
Creates audit trail

💪 Neurodivergent-Optimized

ADHD: Zero friction, immediate execution
SDAM: Complete external memory system
Aphantasia: Visual outputs, concrete examples
Dyschronometria: Time-anchored context
Anendophasia: Externalized reasoning

🚀 Quick Start

Basic Installation (2 minutes)

# Clone repository
git clone https://github.com/toowiredd/claude-skills-automation
cd claude-skills-automation

# Run basic installer
bash scripts/install.sh

Supercharged Installation with Paid Subscriptions Integration

If you have Pieces.app, GitHub Copilot Pro, Docker Pro, Codegen-ai, Jules CLI, or Codacy:

# Run enhanced installer
bash scripts/install-integrations.sh

# See full integration guide
cat docs/SUBSCRIPTIONS_INTEGRATION.md

That's it! Your next Claude Code session will have full automation.

Verification

# Start Claude Code session
# Context should appear automatically

# Check automation logs
tail -f ~/.claude-memories/automation.log

📋 What Gets Installed

Automation Hooks

Core Hooks (5) - Memory & context automation:

Hook	Size	Executes When	Performance
`session-start.sh`	3.1 KB	Session starts	100ms
`session-end.sh`	2.0 KB	Session ends	50ms
`stop-extract-memories.sh`	2.6 KB	After each response	200ms
`post-tool-track.sh`	1.4 KB	After file edits	10ms
`pre-compact-backup.sh`	1.5 KB	Before compression	100ms

Integration Hooks (7) - 🆕 Paid subscriptions:

async-task-jules.sh - Jules CLI async tasks
error-lookup-copilot.sh - GitHub Copilot error search
pre-commit-copilot-review.sh - AI code review
pre-commit-codacy-check.sh - Quality gates
post-tool-save-to-pieces.sh - Pieces.app sync
testing-docker-isolation.sh - Docker isolated tests
codegen-agent-trigger.sh - Autonomous agents

Total overhead per session: <500ms (core only)

8 Claude Skills

Core Skills (5):

session-launcher - Zero context loss restoration
context-manager - Permanent memory management
error-debugger - Smart debugging with past solutions
testing-builder - Automatic test generation
rapid-prototyper - Fast idea validation

New Skills (3) 🆕:

browser-app-creator - Generates single-file HTML/CSS/JS apps (ADHD-optimized, 60px+ buttons, localStorage)
repository-analyzer - Analyzes codebases, generates documentation, detects patterns, extracts TODOs
api-integration-builder - Creates TypeScript API clients with retry logic, rate limiting, and auth

Memory Storage

~/.claude-memories/
├── index.json              # Master memory index
├── decisions/              # Architecture decisions
├── blockers/               # Active obstacles
├── procedures/             # How-to guides
├── backups/                # Session backups
├── automation.log          # Hook execution log
└── auto-extracted.log      # Auto-extracted memories

📖 Documentation

Quick Start - Get started in 5 minutes
Complete Guide - Full documentation (3,500+ lines)
Subscriptions Integration - 🆕 Paid subscriptions integration guide
Implementation - Technical details
Research - How we built this

🎓 How It Works

System Architecture

┌─────────────────────────────────────────┐
│   SessionStart Hook (100ms)              │
│   • Load memory index                    │
│   • Extract recent decisions             │
│   • Find active blockers                 │
│   • Inject context into conversation     │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   You Work Normally                      │
│   • Code, debug, design                  │
│   • Skills activate as needed            │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   PostToolUse Hook (10ms)                │
│   • Track file modifications             │
│   • Log significant changes              │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   Stop Hook (200ms)                      │
│   • Analyze conversation                 │
│   • Extract decision patterns            │
│   • Extract blocker patterns             │
└────────────────┬────────────────────────┘
                 ↓
┌─────────────────────────────────────────┐
│   SessionEnd Hook (50ms)                 │
│   • Save session state                   │
│   • Backup transcript                    │
└─────────────────────────────────────────┘

Decision Extraction Patterns

Automatically detects and extracts:

Pattern	Example	Extracted As
"using X"	"We're using PostgreSQL"	DECISION
"chose X"	"Chose React over Vue"	DECISION
"decided X"	"Decided to implement caching"	DECISION
"can't X"	"Can't access the API"	BLOCKER
"blocked by X"	"Blocked by missing keys"	BLOCKER

🧪 Example Session

First Session

You: "Let's build a task tracker with React and PostgreSQL"
Claude: "Great! Let's start..."

# Behind the scenes:
# → Stop hook extracts: "build a task tracker with React and PostgreSQL"
# → Logs as DECISION
# → SessionEnd saves state

Next Session

[You start Claude Code]

Claude: # Session Context Restored

**Recent Decisions:**
• Build a task tracker with React and PostgreSQL (1 day ago)

**Last Working On:** Building task tracker

Ready to continue!

# Zero manual effort - context just there

🔧 Requirements

Claude Code (latest version)
Bash (pre-installed on Linux/macOS)

jq (for JSON processing)

# Install jq if needed
sudo apt install jq  # Ubuntu/Debian
brew install jq      # macOS

📊 Performance

Metric	Value
Installation time	2 minutes
Hook overhead/session	<500ms
Disk usage/year	<100MB
Maintenance required	Zero

🌟 Community & Credits

Built on research from:

Why We Built This

Designed specifically for neurodivergent developers:

ADHD → Zero friction, immediate results
SDAM → Complete external memory
Dyschronometria → Time-anchored context
Aphantasia → Visual, concrete outputs

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Ideas for Contributions

🎯 New extraction patterns
🔧 Additional hooks
📚 More skills
🌍 Translations
🎨 Better documentation
🧪 Tests

📝 Advanced Usage

Custom Decision Patterns

Edit ~/.config/claude-code/hooks/stop-extract-memories.sh:

# Add your own patterns
local decision_patterns="using|chose|decided|MY_PATTERN"

Pieces.app Integration

Three integration options:

Auto-save code to Pieces
Export memories to Pieces
Use Pieces API as backend

See Pieces Integration Guide

Project-Specific Hooks

Create .claude/hooks/ in your project for custom automation.

🐛 Troubleshooting

Hooks Not Firing?

# Check hooks are executable
ls -l ~/.config/claude-code/hooks/*.sh

# Fix permissions
chmod +x ~/.config/claude-code/hooks/*.sh

Context Not Appearing?

# Verify memory index
cat ~/.claude-memories/index.json
jq '.total_memories' ~/.claude-memories/index.json

More help: Troubleshooting Guide

📜 License

MIT License - see LICENSE

🙏 Acknowledgments

Built for the neurodivergent developer community.

If this helps you:

⭐ Star this repo
🐛 Report issues
💡 Suggest improvements
🤝 Contribute code

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions
Docs: Complete Guide

🎯 Problem → Solution

For ADHD Developers

Before ❌	After ✅
Context lost between sessions	Context auto-restored
Forget to track decisions	Decisions auto-extracted
Manual memory = friction	Zero manual work

For SDAM (No Episodic Memory)

Before ❌	After ✅
Can't remember past decisions	Perfect external memory
"What did we decide?" unanswerable	All decisions saved
Repeat same mistakes	Past solutions auto-recalled

For All Developers

Before ❌	After ✅
Context loss = productivity drain	Zero context loss
Manual "hi-ai" every session	Automatic restoration
No session continuity	Seamless continuation

🚀 Status

✅ Production Ready - Fully tested ✅ Actively Maintained - Regular updates ✅ Community Driven - Contributions welcome

📈 Quick Stats

12 automation hooks (5 core + 7 integrations)
8 Claude Skills (5 core + 3 new)
<500ms overhead
<100MB disk usage/year
Zero maintenance required
100% neurodivergent-optimized

Zero friction. Zero context loss. Forever.

Built with ❤️ for the neurodivergent developer community

Star History

If this project helps you, please consider starring it! ⭐