update readme

This commit is contained in:
cexll
2025-11-24 21:52:24 +08:00
parent b5183c7711
commit 9a18a03061
3 changed files with 105 additions and 105 deletions

View File

@@ -2,7 +2,7 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![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) [![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) [![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 > Enterprise-grade agile development automation with AI-powered multi-agent orchestration

View File

@@ -2,7 +2,7 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![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) [![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) [![Plugin Ready](https://img.shields.io/badge/Plugin-Ready-purple)](https://docs.claude.com/en/docs/claude-code/plugins)
> 企业级敏捷开发自动化与 AI 驱动的多智能体编排 > 企业级敏捷开发自动化与 AI 驱动的多智能体编排

View File

@@ -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 (25 tasks)
Codex 测试验证≥90%覆盖率) Codex testing & verification (≥90% coverage)
完成(生成总结) Done (generate summary)
``` ```
## 6个步骤 ## The 6 Steps
### 1. 需求澄清 ### 1. Clarify Requirements
- 使用 **AskUserQuestion** 直接问用户 - Use **AskUserQuestion** to ask the user directly
- 无评分系统,无复杂逻辑 - No scoring system, no complex logic
- 2-3 轮问答直到需求明确 - 23 rounds of Q&A until the requirement is clear
### 2. Codex 分析 ### 2. Codex Analysis
- 调用 codex 分析需求 - Call codex to analyze the request
- 提取核心功能、技术要点、任务列表2-5个 - Extract: core functions, technical points, task list (25 items)
- 输出结构化分析结果 - Output a structured analysis
### 3. 生成开发文档 ### 3. Generate Dev Doc
- 调用 **develop-doc-generator** agent - Call the **develop-doc-generator** agent
- 生成 `dev-plan.md`(单一开发文档) - Produce a single `dev-plan.md`
- 包含:任务分解、文件范围、依赖关系、测试命令 - Include: task breakdown, file scope, dependencies, test commands
### 4. 并发开发 ### 4. Concurrent Development
- 基于 dev-plan.md 的任务列表 - Work from the task list in dev-plan.md
- 无依赖任务 → 并发执行 - Independent tasks → run in parallel
- 有冲突任务 → 串行执行 - Conflicting tasks → run serially
### 5. 测试验证 ### 5. Testing & Verification
- 每个 codex 任务自己: - Each codex task:
- 实现功能 - Implements the feature
- 编写测试 - Writes tests
- 运行覆盖率 - Runs coverage
- 报告结果(≥90% - Reports results (≥90%)
### 6. 完成 ### 6. Complete
- 汇总任务状态 - Summarize task status
- 记录覆盖率 - Record coverage
## 使用方法 ## Usage
```bash ```bash
/dev "实现用户登录功能,支持邮箱和密码验证" /dev "Implement user login with email + password"
``` ```
**无选项**,流程固定,开箱即用。 **No options**, fixed workflow, works out of the box.
## 输出结构 ## Output Structure
``` ```
.claude/specs/{feature_name}/ .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
### 工具 ### Tools
- **AskUserQuestion**:交互式需求澄清 - **AskUserQuestion**: interactive requirement clarification
- **codex**:分析、开发、测试 - **codex**: analysis, development, testing
- **develop-doc-generator**生成开发文档subagent节省上下文 - **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
### ✅ 极简编排 ### ✅ Minimal Orchestration
- orchestrator 直接控制流程 - Orchestrator controls the flow directly
- 只用 3 个工具/组件 - Only three tools/components
- 步骤清晰易懂 - Steps are straightforward
### ✅ 并发能力 ### ✅ Concurrency
- 2-5 个任务并行 - 25 tasks in parallel
- 自动检测依赖和冲突 - Auto-detect dependencies and conflicts
- codex 独立执行 - Codex executes independently
### ✅ 质量保证 ### ✅ Quality Assurance
- 强制 90% 覆盖率 - Enforces 90% coverage
- codex 自己测试和验证 - Codex tests and verifies its own work
- 失败自动重试 - Automatic retry on failure
## 示例 ## Example
```bash ```bash
# 触发 # Trigger
/dev "添加用户登录功能" /dev "Add user login feature"
# 步骤 1: 需求澄清 # Step 1: Clarify requirements
Q: 支持哪些登录方式? Q: What login methods are supported?
A: 邮箱 + 密码 A: Email + password
Q: 需要记住登录状态吗? Q: Should login be remembered?
A: 是,使用 JWT token A: Yes, use JWT token
# 步骤 2: Codex 分析 # Step 2: Codex analysis
输出: Output:
- 核心功能:邮箱密码登录 + JWT认证 - Core: email/password login + JWT auth
- 任务 1后端 API - Task 1: Backend API
- 任务 2密码加密 - Task 2: Password hashing
- 任务 3前端表单 - Task 3: Frontend form
# 步骤 3: 生成文档 # Step 3: Generate doc
dev-plan.md 已生成 dev-plan.md generated
# 步骤 4-5: 并发开发 # Step 4-5: Concurrent development
[task-1] 后端API → 测试 → 92% ✓ [task-1] Backend API → tests → 92% ✓
[task-2] 密码加密 → 测试 → 95% ✓ [task-2] Password hashing → tests → 95% ✓
[task-3] 前端表单 → 测试 → 91% ✓ [task-3] Frontend form → tests → 91% ✓
``` ```
## 目录结构 ## Directory Structure
``` ```
dev-workflow/ dev-workflow/
├── README.md # 本文档 ├── README.md # This doc
├── commands/ ├── commands/
│ └── dev.md # 工作流定义 │ └── dev.md # Workflow definition
└── agents/ └── 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**:保持简单愚蠢 1. **KISS**: keep it simple
2. **即用即抛**:无持久化配置 2. **Disposable**: no persistent config
3. **质量优先**:强制 90% 覆盖率 3. **Quality first**: enforce 90% coverage
4. **并发优先**:充分利用 codex 能力 4. **Concurrency first**: leverage codex
5. **无历史包袱**:全新设计,不受其他项目影响 5. **No legacy baggage**: clean-slate design
--- ---
**哲学**:像 Linus 一样对复杂度零容忍,交付能立刻用的最小方案。 **Philosophy**: zero tolerance for complexity—ship the smallest usable solution, like Linus would.