Update Chinese README and requirements-pilot command to align with latest workflow

- Updated Chinese README to match English version terminology
- Changed from spec-workflow to requirements-pilot throughout documentation
- Updated quality thresholds from 95% to 90% for consistency
- Replaced Sub-Agent terminology with Requirements-Driven workflow
- Updated agent names from spec-* to requirements-* pattern
- Improved requirements-pilot command structure with clearer phase separation
- Added mandatory user approval gate before implementation phase

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
ben chen
2025-08-04 14:23:25 +08:00
parent 1d45442249
commit 18042ae72e
2 changed files with 130 additions and 195 deletions

View File

@@ -15,8 +15,8 @@
**现在**: 一键自动化专家工作流
```bash
/spec-workflow "实现JWT用户认证系统"
# 30分钟自动执行95%质量门控,零人工干预
/requirements-pilot "实现JWT用户认证系统"
# 30分钟自动执行90%质量门控,零人工干预
```
## 🎯 核心价值主张
@@ -30,31 +30,30 @@
## 📋 两种主要使用模式
### 1. 🏭 Sub-Agent 工作流(自动化专家团队)
### 1. 🏭 Requirements-Driven 工作流(自动化专家团队)
**架构**: 并行专家协调与质量门控
**架构**: 需求导向工作流与质量门控
```
spec-generation → spec-executor → spec-validation → (≥95%?) → spec-testing
↑ ↓ (<95%)
←←←←←← 自动优化循环,直到质量达标 ←←←←←←
requirements-generate → requirements-code → requirements-review → (≥90%?) → requirements-testing
↑ ↓ (<90%)
←←←←←← 自动优化循环 ←←←←←←
```
**使用方法**:
```bash
# 一条命令完成完整开发工作流
/spec-workflow "构建用户管理系统支持RBAC权限控制"
/requirements-pilot "构建用户管理系统支持RBAC权限控制"
# 高级多阶段工作流
先使用 spec-generation,然后 spec-executor再用 spec-validation
如果评分 ≥95% 则使用 spec-testing最后用 optimize 优化
先使用 requirements-generate,然后 requirements-code再用 requirements-review
如果评分 ≥90% 则使用 requirements-testing
```
**质量评分体系** (总分100%):
- 需求符合度 (30%)
- 代码质量 (25%)
- 安全性 (20%)
- 功能性 (40%)
- 集成性 (25%)
- 代码质量 (20%)
- 性能 (15%)
- 测试覆盖 (10%)
### 2. 🎛️ 自定义命令(手动编排)
@@ -95,7 +94,7 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
**完整功能开发**:
```bash
/spec-workflow "实现OAuth2认证支持刷新令牌"
/requirements-pilot "实现OAuth2认证支持刷新令牌"
```
**手动开发流程**:
@@ -108,10 +107,11 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
### 3. 预期输出
**自动化工作流结果**:
-完整规格说明 (requirements.md, design.md, tasks.md)
-生产就绪代码,遵循安全最佳实践
-全面测试套件 (单元 + 集成 + 安全测试)
-95%+ 质量验证评分
-需求确认90+质量评分
-实现就绪技术规格
-生产就绪代码,遵循最佳实践
-全面测试套件 (单元 + 集成 + 功能测试)
- ✅ 90%+ 质量验证评分
## 🏗️ 架构概览
@@ -126,10 +126,12 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
- **运维工具**: `/deploy-check`, `/cicd`
#### **Agents 目录** (`/agents/`)
- **spec-generation**: 自动化规格说明工作流
- **spec-executor**: 带进度跟踪的实现协调器
- **spec-validation**: 多维度质量评分 (0-100%)
- **spec-testing**: 全面测试策略协调
- **requirements-generate**: 为代码生成优化的技术规格生成
- **requirements-code**: 最小架构开销的直接实现智能体
- **requirements-review**: 专注功能性和可维护性的实用代码审查
- **requirements-testing**: 专注功能验证的实用测试智能体
- **bugfix**: 分析和修复软件缺陷的错误解决专家
- **bugfix-verify**: 客观评估的修复验证专家
- **code**: 直接实现的开发协调器
- **debug**: UltraThink系统化问题分析
- **optimize**: 性能优化协调
@@ -137,14 +139,14 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
### 多智能体协调系统
**4个核心专家**:
1. **规格生成专家** - 需求、设计、实现规划
2. **实现执行专家** - 带任务跟踪的代码开发
3. **质量验证专家** - 多维度评分与可执行反馈
4. **测试协调专家** - 全面测试策略与执行
1. **需求生成专家** - 实现就绪的技术规格
2. **代码实现专家** - 直接、实用的代码实现
3. **质量审查专家** - 实用质量审查与评分
4. **测试协调专家** - 功能验证和测试
**关键特性**:
- **独立上下文**: 专家间无上下文污染
- **质量门控**: 95%阈值自动进展判断
- **质量门控**: 90%阈值自动进展判断
- **迭代改进**: 自动优化循环
- **可追溯性**: 完整规格 → 代码 → 测试追溯链
@@ -154,27 +156,27 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
**输入**:
```bash
/spec-workflow "企业JWT认证系统支持RBAC500并发用户集成现有LDAP"
/requirements-pilot "企业JWT认证系统支持RBAC500并发用户集成现有LDAP"
```
**自动化执行过程**:
1. **第1轮** (质量: 83/100) - 基础实现
- 问题: JWT密钥硬编码缺少密码复杂度验证
- **决策**: <95%,重新开始并改进
1. **需求确认** (质量: 92/100) - 交互式澄清
- 功能清晰度、技术特定性、实现完整性
- **决策**: ≥90%,进入实现阶段
2. **第2** (质量: 91/100) - 安全改进
- 问题: 异常处理不完善,性能未优化
- **决策**: <95%继续优化
2. **第1** (质量: 83/100) - 基础实现
- 问题: 错误处理不完整,集成问题
- **决策**: <90%重新开始并改进
3. **第3** (质量: 97/100) - 生产就绪
- **决策**: ≥95%,进入全面测试阶段
3. **第2** (质量: 93/100) - 生产就绪
- **决策**: ≥90%,进入功能测试
**最终交付物**:
- 完整EARS格式需求文档
- 安全加固的JWT实现
-角色层级的RBAC
- 带错误处理的LDAP集成
- 全面测试套件(单元 + 集成 + 安全)
- 质量评估的需求确认
- 实现就绪技术规格
-RBAC的实用JWT实现
-正确错误处理的LDAP集成
- 专注关键路径的功能测试套件
### API网关开发
@@ -224,10 +226,10 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
## 🎯 效益与影响
| 维度 | 传统Slash命令 | Sub-Agent自动工作流 |
| 维度 | 手动命令 | Requirements-Driven工作流 |
|------|-------------|------------------|
| **复杂度** | 手动触发每个步骤 | 一键启动完整流水线 |
| **质量** | 主观评估 | 95%客观评分 |
| **质量** | 主观评估 | 90%客观评分 |
| **上下文** | 污染,需要/clear | 隔离,无污染 |
| **专业性** | AI角色切换 | 专注的专家 |
| **错误处理** | 手动发现/修复 | 自动优化 |
@@ -239,7 +241,7 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
每个智能体在独立上下文中专注各自领域专业知识,避免角色切换导致的质量下降。
### 2. **智能质量门控**
95%客观评分,自动决策工作流进展或优化循环。
90%客观评分,自动决策工作流进展或优化循环。
### 3. **完全自动化**
一条命令触发端到端开发工作流,最少人工干预。
@@ -267,9 +269,9 @@ spec-generation → spec-executor → spec-validation → (≥95%?) → spec-tes
## 📖 命令参考
### 规格说明工作流
- `/spec` - 交互式需求 → 设计 → 任务
- `/spec-workflow` - 自动化端到端规格 + 实现
### Requirements 工作流
- `/requirements-pilot` - 完整的需求驱动开发工作流
- 交互式需求确认 → 技术规格 实现 → 测试
### 开发命令
- `/ask` - 架构咨询(不修改代码)
@@ -309,12 +311,12 @@ MIT许可证 - 详见[LICENSE](LICENSE)文件。
准备好转换你的开发工作流了吗?从这里开始:
```bash
/spec-workflow "在这里描述你的第一个功能"
/requirements-pilot "在这里描述你的第一个功能"
```
看着你的一行请求变成完整、经过测试、生产就绪的实现95%质量保证。
看着你的一行请求变成完整、经过测试、生产就绪的实现90%质量保证。
**记住**: 好的软件来自好的流程好的流程来自专业的团队。Sub-agents让你拥有一个永不疲倦、始终专业的虚拟开发团队。
**记住**: 专业软件来自专业流程。需求驱动工作流为您提供一个永不疲倦、始终专业的虚拟开发团队。
*让专业的AI做专业的事 - 开发从此变得优雅而高效。*
@@ -335,9 +337,9 @@ MIT许可证 - 详见[LICENSE](LICENSE)文件。
5. /optimize 性能优化 → 手动优化
```
**Sub-Agents方式** (30分钟自动):
**Requirements-Driven方式** (30分钟自动):
```bash
/spec-workflow "企业用户管理系统500人规模RBAC权限OA系统集成"
/requirements-pilot "企业用户管理系统500人规模RBAC权限OA系统集成"
```
**自动化执行结果**:
@@ -401,13 +403,13 @@ AI会深入询问
```bash
# 第一阶段:基础功能
/spec-workflow "用户注册登录基础功能"
/requirements-pilot "用户注册登录基础功能"
# 第二阶段:权限管理
/spec-workflow "在现有基础上添加RBAC权限系统"
/requirements-pilot "在现有基础上添加RBAC权限系统"
# 第三阶段:系统集成
/spec-workflow "集成LDAP和SSO单点登录"
/requirements-pilot "集成LDAP和SSO单点登录"
```
### 3. 质量优先策略
@@ -439,7 +441,7 @@ AI扮演产品经理 → 架构师 → 开发者 → 测试工程师 → 优化
每个决策点都可能中断,需要重新组织思路
```
### Sub-Agents解决方案
### Requirements-Driven解决方案
**专业化隔离**: 每个专家在独立上下文中工作
```
@@ -449,18 +451,18 @@ AI扮演产品经理 → 架构师 → 开发者 → 测试工程师 → 优化
**自动化决策**: 基于客观指标的自动流程控制
```
质量评分 ≥95% → 自动进入下一阶段
质量评分 <95% → 自动返回优化,无需人工判断
质量评分 ≥90% → 自动进入下一阶段
质量评分 <90% → 自动返回优化,无需人工判断
```
## 🚀 开始你的AI工厂
从手工作坊升级到自动化工厂,只需要:
1. **配置一次**: 设置Sub-Agents和自定义命令
1. **配置一次**: 设置Requirements-Driven智能体和自定义命令
2. **使用一生**: 每个项目都能享受专业AI团队服务
3. **持续改进**: 工作流模式不断优化,开发效率持续提升
**记住**: 在AI时代Sub-Agents让你拥有了一个永不疲倦、始终专业的虚拟开发团队。
**记住**: 在AI时代Requirements-Driven工作流让你拥有了一个永不疲倦、始终专业的虚拟开发团队。
*让专业的AI做专业的事开发从此变得优雅而高效。*