Logoskills for everything
Agent Skill
2/7/2026

repo-analyzer

Code repository analysis and technical documentation generation skill

C
chaorenex1
1GitHub Stars
1Views
npx skills add chaorenex1/coding-workflow

SKILL.md

Namerepo-analyzer
DescriptionCode repository analysis and technical documentation generation skill

Coding Workflow - AI 智能工作流系统

Claude Code 插件工具库，提供可组合的 Skills、Agents 和 Slash Commands，用于把分析、规划、实现、审查和文档同步组织成可执行工作流。

Python License Version

项目概述

Coding Workflow 是一个面向 Claude Code 的插件式工作流系统。它不提供单一的大而全代理，而是通过一组可自动发现的技能、代理和命令，把常见开发任务拆成可复用的执行单元。

当前版本聚焦三件事：

  • 多后端协作：为规划、实现、审查等阶段选择合适的 AI 后端
  • 工作流编排：通过命令和代理把复杂任务拆解成可跟踪步骤
  • 组织化治理：通过 Hive 机制把代理提升为可调度团队

当前组件

仓库当前公开的核心组件规模：

  • 14 个 skills
  • 20 个 agents
  • 19 个 commands
  • 2 个 hooks

这些组件通过目录约定自动发现，不依赖额外注册表。

核心能力

  • 需求分析与实施规划
  • 多后端实现编排
  • TDD 驱动的开发流程
  • 质量审查与安全检查
  • 仓库级分析和接口级分析
  • 文档同步与知识沉淀
  • Hive 团队协作治理

快速开始

方式 1：通过 Claude Code Plugin Marketplace 安装

在 Claude Code 中运行：

claude plugin marketplace add chaorenex1/coding-workflow

然后在 Claude Code 插件界面安装插件。

方式 2：本地开发模式

git clone https://github.com/chaorenex1/coding-workflow.git
cd coding-workflow

依赖安装

本仓库当前要求以下依赖：

npm install -g memex-cli
pip install chardet pyyaml

依赖会在 SessionStart 阶段通过 hooks/hooks.json 中定义的检查逻辑自动验证。

本地验证

python -m json.tool .claude-plugin/plugin.json
claude code --plugin-dir .
memex-cli --version
python -c "import chardet, yaml; print('OK')"

目录结构

coding-workflow/
├── .claude-plugin/            # 插件元数据
├── agents/                    # 专业代理
├── commands/                  # Slash Commands
│   ├── scaffold/
│   └── workflow-suite/
├── docs/
│   ├── REPO/                  # 仓库级分析文档
│   └── kb/                    # 知识库与设计文档
├── hooks/                     # SessionStart / PreToolUse hooks
├── prompts/                   # 提示词模板、Codex 说明与 catalog
├── .agents/skills/            # Codex 兼容技能镜像（由 skills/ 同步生成）
├── skills/                    # 可自动发现的技能模块
├── .hive/                     # Hive 状态与模板资产
├── CLAUDE.md                  # 仓库内开发约定
└── README.md

关键模块

Skills

当前 skills 目录包含面向不同场景的能力模块，例如：

Agents

当前 agents 体系已收敛到偏治理与执行编排的角色，例如：

Commands

当前 workflow-suite 主要命令包括以下核心入口，完整列表可直接查看 commands/ 目录：

Hive 协作系统

Hive 是当前版本最重要的组织层能力。它不是替换现有 agents，而是在现有能力之上增加一个团队调度与治理层。

详细设计见：

Hive 公开入口

命令作用
/hive启动团队化任务编排
/hive-status查看 Hive 状态、波次和团队进度

Hive 当前公开契约

Hive 设计目标

  • 把现有 agents 组织成可复用团队
  • 用统一任务包和状态协议管理协作
  • 为复杂任务提供中央调度、状态跟踪和决策关口
  • 在不重写现有 agents 的前提下复用当前仓库资产

推荐工作流

需求不清晰时的标准规划到实现

如果需求本身还不清晰：

  1. 使用 /deep-interview 先做意图澄清与边界收敛，并按需保存 versioned brief
  2. 如需稍后再保存或修订 brief，可使用 /deep-interview-save
  3. 使用 /coding-plan 生成实施计划
  4. 使用 /tdd-coder 执行测试优先实现
  5. 使用 /quality-review 做提交前审查

已明确需求的标准规划到实现

  1. 使用 /coding-plan 生成实施计划
  2. 使用 /tdd-coder 执行测试优先实现
  3. 使用 /quality-review 做提交前审查

多后端规划到实现

  1. 使用 /mult-coding-plan 生成多后端计划
  2. 使用 /mult-tdd-coder 执行多后端 TDD 实现
  3. 使用 /quality-review 和相关质量流程收尾

仓库理解与文档同步

  1. 使用 /repo-analyst 生成仓库级分析
  2. 使用 /interface-analyst 生成接口级分析
  3. 使用 /sync-docs 更新说明文档

团队化复杂任务

  1. 使用 /hive 启动任务
  2. 使用 /hive-status 跟踪编排进度

文档索引

开发说明

自动发现约定

  • skills：skills/*/SKILL.md
  • Codex 兼容技能镜像：.agents/skills/*/SKILL.md
  • agents：agents/*.md
  • commands：commands/**/*.md

只要遵循目录结构和 frontmatter 规范，Claude Code 即可自动发现这些组件。

对于 Codex：

  • skills/ 是主资产
  • .agents/skills/ 是兼容镜像
  • 映射定义在 prompts/catalog.yaml
  • 同步命令：python scripts/sync_codex_skill_mirror.py

Hooks

当前启用两个 hook：

  • SessionStart：执行依赖检查
  • PreToolUse：执行工具调用前检查

对应配置见 hooks/hooks.json。

版本变化说明

3.1.0 版本完成了一次明显的体系收敛：

  • 移除了旧的 BMAD 和 quick-code 工作流资产
  • 引入 Hive 协作治理层
  • 收敛 workflow-suite 命令集到更直接的规划、实现、审查与分析路径
  • 补充了 docs/kb 与 docs/REPO 作为新的知识和结构说明入口

贡献

欢迎提交 issue、文档修正和新能力模块。

基本流程：

  1. Fork 仓库
  2. 创建分支
  3. 提交变更
  4. 发起 Pull Request

如果改动涉及 agent、command 或 skill，建议同步更新相应文档和 README 中的公开入口说明。

许可证

本项目采用 MIT 许可证，详见 LICENSE。

致谢

联系方式

  • 问题反馈：GitHub Issues

从一句话需求到可执行工作流，Coding Workflow 关注的不只是生成代码，而是把协作、验证和沉淀一起组织起来。

Skills Info
Original Name:repo-analyzerAuthor:chaorenex1
Download
View on GitHub