diff --git a/README.md b/README.md index 4d4eb1e..101bbf5 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![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)](https://claude.ai/code) -[![Version](https://img.shields.io/badge/Version-3.2-green)](https://github.com/cexll/myclaude) +[![Version](https://img.shields.io/badge/Version-4.4-green)](https://github.com/cexll/myclaude) [![Plugin Ready](https://img.shields.io/badge/Plugin-Ready-purple)](https://docs.claude.com/en/docs/claude-code/plugins) > Enterprise-grade agile development automation with AI-powered multi-agent orchestration diff --git a/README_CN.md b/README_CN.md index 93059de..4dbe118 100644 --- a/README_CN.md +++ b/README_CN.md @@ -2,7 +2,7 @@ [![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)](https://claude.ai/code) -[![Version](https://img.shields.io/badge/Version-3.2-green)](https://github.com/cexll/myclaude) +[![Version](https://img.shields.io/badge/Version-4.4-green)](https://github.com/cexll/myclaude) [![Plugin Ready](https://img.shields.io/badge/Plugin-Ready-purple)](https://docs.claude.com/en/docs/claude-code/plugins) > 企业级敏捷开发自动化与 AI 驱动的多智能体编排 diff --git a/dev-workflow/README.md b/dev-workflow/README.md index f330442..109d7ef 100644 --- a/dev-workflow/README.md +++ b/dev-workflow/README.md @@ -1,163 +1,163 @@ -# /dev - 极简开发工作流 +# /dev - Minimal Dev Workflow -## 概述 +## Overview -全新设计的轻量级开发工作流,无历史包袱,专注快速交付高质量代码。 +A freshly designed lightweight development workflow with no legacy baggage, focused on delivering high-quality code fast. -## 工作流程 +## Flow ``` -/dev 触发 +/dev trigger ↓ -AskUserQuestion(需求澄清) +AskUserQuestion (requirements clarification) ↓ -Codex 分析(提取要点和任务) +Codex analysis (extract key points and tasks) ↓ -develop-doc-generator(生成开发文档) +develop-doc-generator (create dev doc) ↓ -Codex 并发开发(2-5个任务) +Codex concurrent development (2–5 tasks) ↓ -Codex 测试验证(≥90%覆盖率) +Codex testing & verification (≥90% coverage) ↓ -完成(生成总结) +Done (generate summary) ``` -## 6个步骤 +## The 6 Steps -### 1. 需求澄清 -- 使用 **AskUserQuestion** 直接问用户 -- 无评分系统,无复杂逻辑 -- 2-3 轮问答直到需求明确 +### 1. Clarify Requirements +- Use **AskUserQuestion** to ask the user directly +- No scoring system, no complex logic +- 2–3 rounds of Q&A until the requirement is clear -### 2. Codex 分析 -- 调用 codex 分析需求 -- 提取:核心功能、技术要点、任务列表(2-5个) -- 输出结构化分析结果 +### 2. Codex Analysis +- Call codex to analyze the request +- Extract: core functions, technical points, task list (2–5 items) +- Output a structured analysis -### 3. 生成开发文档 -- 调用 **develop-doc-generator** agent -- 生成 `dev-plan.md`(单一开发文档) -- 包含:任务分解、文件范围、依赖关系、测试命令 +### 3. Generate Dev Doc +- Call the **develop-doc-generator** agent +- Produce a single `dev-plan.md` +- Include: task breakdown, file scope, dependencies, test commands -### 4. 并发开发 -- 基于 dev-plan.md 的任务列表 -- 无依赖任务 → 并发执行 -- 有冲突任务 → 串行执行 +### 4. Concurrent Development +- Work from the task list in dev-plan.md +- Independent tasks → run in parallel +- Conflicting tasks → run serially -### 5. 测试验证 -- 每个 codex 任务自己: - - 实现功能 - - 编写测试 - - 运行覆盖率 - - 报告结果(≥90%) +### 5. Testing & Verification +- Each codex task: + - Implements the feature + - Writes tests + - Runs coverage + - Reports results (≥90%) -### 6. 完成 -- 汇总任务状态 -- 记录覆盖率 +### 6. Complete +- Summarize task status +- Record coverage -## 使用方法 +## Usage ```bash -/dev "实现用户登录功能,支持邮箱和密码验证" +/dev "Implement user login with email + password" ``` -**无选项**,流程固定,开箱即用。 +**No options**, fixed workflow, works out of the box. -## 输出结构 +## Output Structure ``` .claude/specs/{feature_name}/ -├── dev-plan.md # 开发文档(agent生成) +└── dev-plan.md # Dev document generated by agent ``` -仅 2 个文件,极简清晰。 +Only one file—minimal and clear. -## 核心组件 +## Core Components -### 工具 -- **AskUserQuestion**:交互式需求澄清 -- **codex**:分析、开发、测试 -- **develop-doc-generator**:生成开发文档(subagent,节省上下文) +### Tools +- **AskUserQuestion**: interactive requirement clarification +- **codex**: analysis, development, testing +- **develop-doc-generator**: generate dev doc (subagent, saves context) -## 核心特性 +## Key Features -### ✅ 全新设计 -- 无历史项目残留 -- 无复杂评分逻辑 -- 无多余抽象层 +### ✅ Fresh Design +- No legacy project residue +- No complex scoring logic +- No extra abstraction layers -### ✅ 极简编排 -- orchestrator 直接控制流程 -- 只用 3 个工具/组件 -- 步骤清晰易懂 +### ✅ Minimal Orchestration +- Orchestrator controls the flow directly +- Only three tools/components +- Steps are straightforward -### ✅ 并发能力 -- 2-5 个任务并行 -- 自动检测依赖和冲突 -- codex 独立执行 +### ✅ Concurrency +- 2–5 tasks in parallel +- Auto-detect dependencies and conflicts +- Codex executes independently -### ✅ 质量保证 -- 强制 90% 覆盖率 -- codex 自己测试和验证 -- 失败自动重试 +### ✅ Quality Assurance +- Enforces 90% coverage +- Codex tests and verifies its own work +- Automatic retry on failure -## 示例 +## Example ```bash -# 触发 -/dev "添加用户登录功能" +# Trigger +/dev "Add user login feature" -# 步骤 1: 需求澄清 -Q: 支持哪些登录方式? -A: 邮箱 + 密码 -Q: 需要记住登录状态吗? -A: 是,使用 JWT token +# Step 1: Clarify requirements +Q: What login methods are supported? +A: Email + password +Q: Should login be remembered? +A: Yes, use JWT token -# 步骤 2: Codex 分析 -输出: -- 核心功能:邮箱密码登录 + JWT认证 -- 任务 1:后端 API -- 任务 2:密码加密 -- 任务 3:前端表单 +# Step 2: Codex analysis +Output: +- Core: email/password login + JWT auth +- Task 1: Backend API +- Task 2: Password hashing +- Task 3: Frontend form -# 步骤 3: 生成文档 -dev-plan.md 已生成 ✓ +# Step 3: Generate doc +dev-plan.md generated ✓ -# 步骤 4-5: 并发开发 -[task-1] 后端API → 测试 → 92% ✓ -[task-2] 密码加密 → 测试 → 95% ✓ -[task-3] 前端表单 → 测试 → 91% ✓ +# Step 4-5: Concurrent development +[task-1] Backend API → tests → 92% ✓ +[task-2] Password hashing → tests → 95% ✓ +[task-3] Frontend form → tests → 91% ✓ ``` -## 目录结构 +## Directory Structure ``` dev-workflow/ -├── README.md # 本文档 +├── README.md # This doc ├── commands/ -│ └── dev.md # 工作流定义 +│ └── dev.md # Workflow definition └── agents/ - └── develop-doc-generator.md # 文档生成器 + └── develop-doc-generator.md # Doc generator ``` -极简结构,只有 3 个文件。 +Minimal structure, only three files. -## 适用场景 +## When to Use -✅ **适合**: -- 任何规模的功能开发 -- 需要快速迭代 -- 需要高测试覆盖率 -- 希望并发提速 +✅ **Good for**: +- Any feature size +- Fast iterations +- High test coverage needs +- Wanting concurrent speed-up -## 设计原则 +## Design Principles -1. **KISS**:保持简单愚蠢 -2. **即用即抛**:无持久化配置 -3. **质量优先**:强制 90% 覆盖率 -4. **并发优先**:充分利用 codex 能力 -5. **无历史包袱**:全新设计,不受其他项目影响 +1. **KISS**: keep it simple +2. **Disposable**: no persistent config +3. **Quality first**: enforce 90% coverage +4. **Concurrency first**: leverage codex +5. **No legacy baggage**: clean-slate design --- -**哲学**:像 Linus 一样对复杂度零容忍,交付能立刻用的最小方案。 +**Philosophy**: zero tolerance for complexity—ship the smallest usable solution, like Linus would.