convez.ai
SkillAutomaçãoAvançado
xiaoheiDTF

Claude Code Hooks & Skills

xiaoheiDTF/claude-hk

Automação completa do Claude Code com hooks, skills e backend Go

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework completo de automação para Claude Code CLI com 29 eventos de ciclo de vida, 24 skills pré-construídos e backend Go. Implementa pipelines de hooks, gerenciamento de issues, workflows Git e processos de desenvolvimento (BDD/TDD) totalmente automatizados.

Instalação

$npx convez-ai xiaoheiDTF/claude-hk

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
3
Contribuidores
1

Casos de uso

  • Automação de fluxos de trabalho de desenvolvimento (BDD/TDD/CDD)
  • Gerenciamento integrado de issues e pull requests no GitHub
  • Normalização e controle de commits com validação de mensagens
  • Interceptação e análise de tráfego de API com rastreamento JSONL
  • Configuração automática de projetos com inicialização one-click

Veredito

Projeto maduro e bem-estruturado para times que querem automatizar completamente o ciclo de desenvolvimento com Claude Code. A qualidade da documentação em português e a cobertura de 24 skills especializados compensam a curva de aprendizado elevada. Recomendado para projetos Go/CLI com fluxos complexos.

README

A tradução para o português deste README ainda está na fila.

claude-hk

Claude Code 配置与文档项目。为 Claude Code CLI 构建了一套完整的 Hooks 管道、Skill 技能系统和自动化初始化流程,搭配 Go 语言实现的反向代理与后端服务。

功能概览

  • Hooks 管道 — 29 个生命周期事件自动调度,两层架构可扩展
  • Skill 系统 — 24 个内置技能,覆盖 Issue 管理、开发流程(BDD/TDD/CDD)、Git 工作流等
  • Go 后端服务 — 反向代理(API 流量拦截 + JSONL 追踪 + Token 统计)+ HTTP 后端(Issue/Session 管理,15 个端点)
  • 自动初始化 — 一键配置 Python、UTF-8、目录结构,支持 Windows/macOS/Linux
  • 开发流程 — 003 系列技能实现从功能树分析到 E2E 测试的完整 BDD/TDD 流水线
  • Git 工作流 — 规范化 commit + push,中文提交信息,按类型分组
  • 中文文档 — Claude Code CLI 完整中文翻译文档(130+ 篇)

更多功能详见 功能文档。

快速开始

# 1. 克隆仓库
git clone https://github.com/xiaoheiDTF/claude-hk.git
cd claude-hk

# 2. 用 Claude Code 打开(自动触发初始化)
claude

# 3. 使用内置 Skill
/001-2-issue              # 创建 GitHub Issue
/003-1-develop-feature-tree  # 功能点与功能树分析
/999-2-git-push            # 规范化提交并推送

Go 后端服务(可选)

cd claude_tap_plus
go build -o claude-tap-plus ./cmd/claude-tap

# 代理模式(拦截 API 流量,记录 JSONL 追踪)
claude-tap-plus --tap-profile glm

# 后端服务(Issue 管理 + 会话管理)
go run ./cmd/claude-tap backend

安装要求

依赖必需说明
Claude Code CLI是安装指南
Git是版本控制
Bash是Windows 自带(Git Bash)
GitHub CLI (gh)部分Issue/PR 相关 Skill 需要
Python 3.x可选无环境时自动下载嵌入版
Go 1.21+可选仅编译 claude_tap_plus 时需要

文档导航

层面目录回答的问题
架构设计doc/redeme/系统架构、流程图、数据模型
功能介绍doc/features/有哪些功能?怎么用?
功能机制doc/mechanisms/怎么实现的?设计原理是什么?
项目治理doc/project/CHANGELOG、贡献指南
中文翻译doc/claude-code-cli-doc/Claude Code CLI 完整中文文档

项目结构

claude-hk/
├── .claude/                # 自动化机制核心
│   ├── hooks/              # 29 个生命周期事件
│   ├── skills/             # 24 个内置 Skill
│   └── settings.json       # Hooks 注册入口
├── .github/                # Issue/PR/Discussion 模板
├── claude_tap_plus/        # Go 后端服务
│   ├── cmd/                # CLI 入口(代理/后端/会话管理)
│   └── internal/           # 代理管线 + 后端 API + 持久化
├── doc/                    # 文档 + Skill 运行时输出
│   ├── redeme/             # 架构设计文档与流程图
│   ├── claude-code-cli-doc/  # Claude Code 中文文档(130+ 篇)
│   ├── otherDoc/           # 归档文档(按日期)
│   └── testcode/           # Python 测试脚本
└── CLAUDE.md               # Claude Code 项目指令

详细结构解析见 目录结构文档。

Skill 概览

001 Issue 工作流(9 个)

Skill命令说明
001-1-issue-init/001-1-issue-init初始化 issue 标签体系(一次性)
001-2-issue/001-2-issue创建 GitHub Issue
001-3-issue-discuss/001-3-issue-discuss讨论 Issue 内容
001-4-issue-claim/001-4-issue-claim原子领取 Issue
001-5-issue-fix/001-5-issue-fix创建分支并开始开发
001-6-issue-done/001-6-issue-done标记开发完成
001-7-issue-pr/001-7-issue-pr创建 PR
001-8-issue-test/001-8-issue-test执行 Test Plan
001-9-issue-review/001-9-issue-review审核并合并/打回

002 文档工具(2 个)

Skill命令说明
002-1-doc-otherdoc/002-1-doc-otherdoc文档归档(按日期)
002-2-doc-testcode-python/002-2-doc-testcode-pythonPython 测试脚本

003 开发流程(8 个)

Skill命令说明
003-1-develop-feature-tree/003-1-develop-feature-tree功能点与功能树分析
003-2-develop-bdd-scenario/003-2-develop-bdd-scenarioBDD 场景规范
003-3-1-backend-bdd/003-3-1-backend-bdd后端 BDD
003-3-2-frontend-bdd/003-3-2-frontend-bdd前端 BDD
003-4-api-contract/003-4-api-contractAPI 契约
003-5-1-backend-tdd-java/003-5-1-backend-tdd-java后端 TDD(Java/SpringBoot)
003-6-1-ui-state-definition/003-6-1-ui-state-definitionUI 状态定义
003-6-2-frontend-cdd/003-6-2-frontend-cdd前端 CDD
003-7-e2e-test/003-7-e2e-test端到端测试

999 Git 与工具(4 个)

Skill命令说明
999-1-git-commit/999-1-git-commit规范化提交(仅 commit)
999-2-git-push/999-2-git-push规范化提交并推送
999-other-110-requirement-planning/999-other-110-requirement-planning需求规划(PRD 文档)
999-other-120-learn/999-other-120-learn学习进化

许可证

MIT License

Ver o original no GitHub

Bom para