mirror of
https://github.com/cexll/myclaude.git
synced 2026-02-14 03:31:58 +08:00
update readme
This commit is contained in:
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
[](https://opensource.org/licenses/MIT)
|
[](https://opensource.org/licenses/MIT)
|
||||||
[](https://claude.ai/code)
|
[](https://claude.ai/code)
|
||||||
[](https://github.com/cexll/myclaude)
|
[](https://github.com/cexll/myclaude)
|
||||||
[](https://docs.claude.com/en/docs/claude-code/plugins)
|
[](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
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
[](https://opensource.org/licenses/MIT)
|
[](https://opensource.org/licenses/MIT)
|
||||||
[](https://claude.ai/code)
|
[](https://claude.ai/code)
|
||||||
[](https://github.com/cexll/myclaude)
|
[](https://github.com/cexll/myclaude)
|
||||||
[](https://docs.claude.com/en/docs/claude-code/plugins)
|
[](https://docs.claude.com/en/docs/claude-code/plugins)
|
||||||
|
|
||||||
> 企业级敏捷开发自动化与 AI 驱动的多智能体编排
|
> 企业级敏捷开发自动化与 AI 驱动的多智能体编排
|
||||||
|
|||||||
@@ -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. 需求澄清
|
### 1. Clarify Requirements
|
||||||
- 使用 **AskUserQuestion** 直接问用户
|
- Use **AskUserQuestion** to ask the user directly
|
||||||
- 无评分系统,无复杂逻辑
|
- No scoring system, no complex logic
|
||||||
- 2-3 轮问答直到需求明确
|
- 2–3 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 (2–5 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 个任务并行
|
- 2–5 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.
|
||||||
|
|||||||
Reference in New Issue
Block a user