CorbinatorX/devops-ai-toolkit-claude-plugin

# Agentic Toolkit - Claude Code 插件 为 Claude Code 提供的 AI 驱动 DevOps 工作流：工作项管理、事件响应、结构化开发工作流以及自动化质量验证。 ## 安装 ### 用户范围（推荐） 在用户范围内安装，使该插件在所有项目中可用： ``` # 添加 marketplace（一次性） /plugin marketplace add CorbinatorX/agentic-toolkit # 在 user scope 安装 plugin /plugin install agentic-toolkit@agentic-toolkit --scope user ``` ### 项目范围（团队共享） 添加到项目的 `.claude/settings.json` 以便与团队成员共享： ``` { "extraKnownMarketplaces": { "agentic-toolkit": { "source": { "source": "github", "repo": "CorbinatorX/agentic-toolkit" } } }, "enabledPlugins": { "agentic-toolkit@agentic-toolkit": true } } ``` ## 每个仓库的配置 该插件从每个项目的 `.claude/` 目录读取配置，允许在使用相同全局安装插件的同时，为每个仓库设置不同的配置。 **配置文件：** - `.claude/config.json` - 项目架构、约定、模式 - `.claude/techops-config.json` - 工作项提供者设置、Teams 集成 在任何项目中运行 `/configure` 以交互方式设置配置。 ## 配置 当您在 `.claude/config.json` 中定义项目架构时，该插件效果最佳。这可以实现： - 感知架构的蓝图生成 - 与您的模式一致的代码放置 - 遵循约定的实现 - 基于标准的代码审查 ``` # 复制 example config cp .claude/config.example.json .claude/config.json # 为你的项目定制 # 编辑 .claude/config.json，填入你的： # - 项目结构（components, layers） # - Tech stack（frameworks, versions） # - 约定（naming, indentation） # - 模式（API, application, UI） # - 测试设置（commands, coverage） ``` 参阅 [`.claude/README.md`](.claude/README.md) 获取详细配置指南。 ## 功能 ### 工作项命令 - `/create-bug` - 在 Azure DevOps 中创建 Bug 工作项 - `/create-incident` - 创建事件工作项并通过 Teams 发送通知 - `/create-tech-debt` - 解析状态文件并创建技术债务项 - `/create-feature-request` - 创建功能请求工作项 ### 工作流技能 - **orchestrate** - 使用 Claude Code Agent Teams 和 Tech Lead 编排器进行自主多阶段功能交付 - **blueprint** - 为新服务/功能创建架构蓝图 - **pickup-bug** - 与 Azure DevOps 集成的 Bug 接取工作流 - **pickup-feature** - 用户故事的功能接取工作流 - **implement-task** - 用于执行阶段性任务的构建者模式 - **review-task** - 用于质量验证和评分的检查者模式 ### 文档命令 - `/create-post-mortem` - 在 Confluence 中创建事件事后分析 - `/update-code-summary` - 更新代码统计和覆盖率报告 - `/update-coverage` - 运行覆盖率分析并更新报告 ### 运维命令 - `/triage-504` - Azure Front Door 504 网关超时故障排查 - `/yarp-timeout-playbook` - YARP 反向代理超时分析 - `/afd-waf-troubleshoot` - WAF 和 Azure 边缘调试 ### 工作流命令 - `/blueprint-tasks` - 将蓝图转换为任务文件 - `/commit` - 使用约定式提交信息的智能提交 - `/create-pr` - 创建带有自动生成描述的 Pull Request - `/resume-orchestration` - 从检查点恢复中断的 Tech Lead 编排 ## 技能自动发现 技能基于自然语言自动触发： ``` # 编排（完全自主交付） "Orchestrate the full build of the payment service" "Deliver the notification system end to end" # Blueprint "I want to design a new payment service" # 领取 Bug "Pick up bug 25123" # 领取 Feature "Pick up user story 25200" # 实现 Task "Implement task phase1#2.1" # 审查 Task "Review task phase1#2.1" ``` ## 配置 ### 前置条件 - **Claude Code**: v2.0.12+ (需要插件市场支持) - **MCP 服务器**: - Azure DevOps MCP 服务器 (用于工作项操作) - Atlassian MCP 服务器 (用于 Confluence 集成) ### Azure DevOps 配置 确保您的 Azure DevOps MCP 服务器配置了以下内容： - **Organization**: `{organization}` - **Project**: `ERM` - **Area Path**: `ERM\\Devops` - **Iteration Path**: `ERM\\dops-backlog` ### Confluence 配置（可选） 用于创建事后分析： - **Space**: `Tech` - **Post Mortems Parent ID**: `287244316` ### Teams 通知（可选） 将 Teams webhook URL 添加到您仓库的 `.claude/config.json` 或团队配置中。 ## 共享模块 该插件包含通用模式的详细文档： - **Azure DevOps** (`shared/azure-devops/`) - 工作项 CRUD、身份解析、字段验证 - **Git** (`shared/git/`) - 分支 slug 生成、约定式提交 - **Teams** (`shared/teams/`) - MessageCard 模板、通知模式 - **Confluence** (`shared/confluence/`) - 事后分析模板、SLA 计算 - **Orchestration** (`shared/orchestration/`) - 状态管理、钩子以及 Agent Teams 的恢复模式 - **Work Items** (`shared/work-items/`) - 与提供者无关的工作项接口 (ADO, Notion, Jira) - **Worktree** (`shared/worktree/`) - 用于隔离开发的 Git worktree 模式 请参阅 `shared/` 中各模块的 README 以获取详细的使用模式。 ## Agent Teams 集成 该插件支持 **Claude Code Agent Teams** (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`) 用于自主多阶段功能交付： ``` # 启用 Agent Teams export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 # 编排一个 feature "Orchestrate the full build of the payment service" ``` **工作原理：** 1. 一个 **Tech Lead** agent 作为团队负责人，生成专家队友 2. **Architect** 队友设计蓝图（需计划批准） 3. **Builder** 队友并行实现任务（具有文件所有权） 4. **Reviewer** 队友验证质量（6 类评分） 5. 失败的审查触发返工循环（最多 2 次尝试） 6. 每个阶段生成一个 commit 和 PR 7. 状态被持久化以用于崩溃恢复 (`/resume-orchestration`) **如果没有 Agent Teams**，`orchestrate` 技能将回退为手动引导您完成顺序工作流。 有关详细信息，请参阅 `agents/workflow/tech-lead.md` 和 `skills/orchestrate/SKILL.md`。 ## 代理 该插件包含用于自动发现的专用代理： **工作流代理：** - **tech-lead** - 使用 Claude Code Agent Teams 进行自主多阶段交付的团队负责人编排器 - **software-architect** - 架构蓝图创建和领域建模 - **builder** - 具有严格范围纪律的专注任务实现 - **manager** - 具有自动化检查和评分的质量保证 **运维代理：** - **ops-triager** - 事件分类和日志分析 - **azure-edge-specialist** - Azure Front Door、WAF 和边缘网络问题 - **dotnet-performance-analyst** - .NET 应用程序性能和 YARP 调试 ## 优势 ✅ **整洁的仓库** - 每个项目中没有 `.claude/` 杂乱文件 ✅ **团队复用** - 一个插件，到处安装 ✅ **集中更新** - 一次更新插件，所有仓库受益 ✅ **自然语言** - 技能从对话中自动发现 ✅ **一致的工作流** - 所有团队仓库中相同的模式 ## 文档 - **技能参考**: 详见 `skills/*/SKILL.md` 获取详细的技能文档 - **共享模式**: 详见 `shared/*/README.md` 获取可复用模式 - **采用指南**: 详见 `ADOPTION.md` 获取团队安装说明 ## 支持 - **Issues**: https://github.com/CorbinatorX/devops-ai-toolkit-claude-plugin/issues - **文档**: 参阅各目录中的 README 文件 ## 许可证 MIT 许可证 - 详情请参阅 LICENSE 文件

标签：Agentic Workflow, AI 辅助开发, Azure DevOps, Blueprint 生成, Claude Code 插件, DevOps 自动化, LLM 工具集成, Microsoft Teams 集成, 代码审查, 团队协作, 威胁情报, 工作项管理, 开发者工具, 技术运营 (TechOps), 数据管道, 结构化开发工作流, 网络安全研究, 自动化质量验证, 软件供应链, 软件工程