Compare commits

..

2 Commits
v4.5 ... v4.6

Author SHA1 Message Date
cexll
c96c07be2a update dev workflow 2025-11-25 22:26:56 +08:00
cexll
cee467fc0e update dev workflow 2025-11-25 21:31:31 +08:00
4 changed files with 70 additions and 72 deletions

View File

@@ -44,6 +44,7 @@ make install
|--------|-------------|--------------| |--------|-------------|--------------|
| **[bmad-agile-workflow](docs/BMAD-WORKFLOW.md)** | Complete BMAD methodology with 6 specialized agents | `/bmad-pilot` | | **[bmad-agile-workflow](docs/BMAD-WORKFLOW.md)** | Complete BMAD methodology with 6 specialized agents | `/bmad-pilot` |
| **[requirements-driven-workflow](docs/REQUIREMENTS-WORKFLOW.md)** | Streamlined requirements-to-code workflow | `/requirements-pilot` | | **[requirements-driven-workflow](docs/REQUIREMENTS-WORKFLOW.md)** | Streamlined requirements-to-code workflow | `/requirements-pilot` |
| **[dev-workflow](dev-workflow/README.md)** | Extreme lightweight end-to-end development workflow | `/dev` |
| **[development-essentials](docs/DEVELOPMENT-COMMANDS.md)** | Core development slash commands | `/code` `/debug` `/test` `/optimize` | | **[development-essentials](docs/DEVELOPMENT-COMMANDS.md)** | Core development slash commands | `/code` `/debug` `/test` `/optimize` |
| **[advanced-ai-agents](docs/ADVANCED-AGENTS.md)** | GPT-5 deep reasoning integration | Agent: `gpt5` | | **[advanced-ai-agents](docs/ADVANCED-AGENTS.md)** | GPT-5 deep reasoning integration | Agent: `gpt5` |
| **[requirements-clarity](docs/REQUIREMENTS-CLARITY.md)** | Automated requirements clarification with 100-point scoring | Auto-activated skill | | **[requirements-clarity](docs/REQUIREMENTS-CLARITY.md)** | Automated requirements clarification with 100-point scoring | Auto-activated skill |

View File

@@ -44,6 +44,7 @@ make install
|------|------|---------| |------|------|---------|
| **[bmad-agile-workflow](docs/BMAD-WORKFLOW.md)** | 完整 BMAD 方法论包含6个专业智能体 | `/bmad-pilot` | | **[bmad-agile-workflow](docs/BMAD-WORKFLOW.md)** | 完整 BMAD 方法论包含6个专业智能体 | `/bmad-pilot` |
| **[requirements-driven-workflow](docs/REQUIREMENTS-WORKFLOW.md)** | 精简的需求到代码工作流 | `/requirements-pilot` | | **[requirements-driven-workflow](docs/REQUIREMENTS-WORKFLOW.md)** | 精简的需求到代码工作流 | `/requirements-pilot` |
| **[dev-workflow](dev-workflow/README.md)** | 极简端到端开发工作流 | `/dev` |
| **[development-essentials](docs/DEVELOPMENT-COMMANDS.md)** | 核心开发斜杠命令 | `/code` `/debug` `/test` `/optimize` | | **[development-essentials](docs/DEVELOPMENT-COMMANDS.md)** | 核心开发斜杠命令 | `/code` `/debug` `/test` `/optimize` |
| **[advanced-ai-agents](docs/ADVANCED-AGENTS.md)** | GPT-5 深度推理集成 | 智能体: `gpt5` | | **[advanced-ai-agents](docs/ADVANCED-AGENTS.md)** | GPT-5 深度推理集成 | 智能体: `gpt5` |
| **[requirements-clarity](docs/REQUIREMENTS-CLARITY.md)** | 自动需求澄清100分制质量评分 | 自动激活技能 | | **[requirements-clarity](docs/REQUIREMENTS-CLARITY.md)** | 自动需求澄清100分制质量评分 | 自动激活技能 |

View File

@@ -20,35 +20,35 @@ Your output is a single file: `./.claude/specs/{feature_name}/dev-plan.md`
## Document Structure You Must Follow ## Document Structure You Must Follow
```markdown ```markdown
# {Feature Name} - 开发计划 # {Feature Name} - Development Plan
## 功能概述 ## Overview
[一句话描述核心功能] [One-sentence description of core functionality]
## 任务分解 ## Task Breakdown
### 任务 1: [任务名称] ### Task 1: [Task Name]
- **ID**: task-1 - **ID**: task-1
- **描述**: [具体要做什么] - **Description**: [What needs to be done]
- **文件范围**: [涉及的目录或文件,如 src/auth/**, tests/auth/] - **File Scope**: [Directories or files involved, e.g., src/auth/**, tests/auth/]
- **依赖**: [无 或 依赖 task-x] - **Dependencies**: [None or depends on task-x]
- **测试命令**: [如 pytest tests/auth --cov=src/auth --cov-report=term] - **Test Command**: [e.g., pytest tests/auth --cov=src/auth --cov-report=term]
- **测试重点**: [需要覆盖的场景] - **Test Focus**: [Scenarios to cover]
### 任务 2: [任务名称] ### Task 2: [Task Name]
... ...
2-5个任务) (2-5 tasks)
## 验收标准 ## Acceptance Criteria
- [ ] 功能点 1 - [ ] Feature point 1
- [ ] 功能点 2 - [ ] Feature point 2
- [ ] 所有单元测试通过 - [ ] All unit tests pass
- [ ] 代码覆盖率 ≥90% - [ ] Code coverage ≥90%
## 技术要点 ## Technical Notes
- [关键技术决策] - [Key technical decisions]
- [需要注意的约束] - [Constraints to be aware of]
``` ```
## Generation Rules You Must Enforce ## Generation Rules You Must Enforce
@@ -58,7 +58,7 @@ Your output is a single file: `./.claude/specs/{feature_name}/dev-plan.md`
- Clear ID (task-1, task-2, etc.) - Clear ID (task-1, task-2, etc.)
- Specific description of what needs to be done - Specific description of what needs to be done
- Explicit file scope (directories or files affected) - Explicit file scope (directories or files affected)
- Dependency declaration ("" or "依赖 task-x") - Dependency declaration ("None" or "depends on task-x")
- Complete test command with coverage parameters - Complete test command with coverage parameters
- Testing focus points (scenarios to cover) - Testing focus points (scenarios to cover)
3. **Task Independence**: Design tasks to be as independent as possible to enable parallel execution 3. **Task Independence**: Design tasks to be as independent as possible to enable parallel execution
@@ -78,7 +78,7 @@ Your output is a single file: `./.claude/specs/{feature_name}/dev-plan.md`
## Quality Checks Before Writing ## Quality Checks Before Writing
- [ ] Task count is between 2-5 - [ ] Task count is between 2-5
- [ ] Every task has all 6 required fields (ID, 描述, 文件范围, 依赖, 测试命令, 测试重点) - [ ] Every task has all 6 required fields (ID, Description, File Scope, Dependencies, Test Command, Test Focus)
- [ ] Test commands include coverage parameters - [ ] Test commands include coverage parameters
- [ ] Dependencies are explicitly stated - [ ] Dependencies are explicitly stated
- [ ] Acceptance criteria includes 90% coverage requirement - [ ] Acceptance criteria includes 90% coverage requirement
@@ -90,7 +90,7 @@ Your output is a single file: `./.claude/specs/{feature_name}/dev-plan.md`
- **Document Only**: You generate documentation. You do NOT execute code, run tests, or modify source files. - **Document Only**: You generate documentation. You do NOT execute code, run tests, or modify source files.
- **Single Output**: You produce exactly one file: `dev-plan.md` in the correct location - **Single Output**: You produce exactly one file: `dev-plan.md` in the correct location
- **Path Accuracy**: The path must be `./.claude/specs/{feature_name}/dev-plan.md` where {feature_name} matches the input - **Path Accuracy**: The path must be `./.claude/specs/{feature_name}/dev-plan.md` where {feature_name} matches the input
- **Chinese Language**: The document must be in Chinese (as shown in the structure) - **Language Matching**: Output language matches user input (Chinese input → Chinese doc, English input → English doc)
- **Structured Format**: Follow the exact markdown structure provided - **Structured Format**: Follow the exact markdown structure provided
## Example Output Quality ## Example Output Quality

View File

@@ -20,61 +20,57 @@ You are the /dev Workflow Orchestrator, an expert development workflow manager s
- Focus questions on functional boundaries, inputs/outputs, constraints, testing - Focus questions on functional boundaries, inputs/outputs, constraints, testing
- Iterate 2-3 rounds until clear; rely on judgment; keep questions concise - Iterate 2-3 rounds until clear; rely on judgment; keep questions concise
- **Step 2: Codex Analysis** - **Step 2: Codex Deep Analysis (Plan Mode Style)**
- Run:
```bash
uv run ~/.claude/skills/codex/scripts/codex.py "分析以下需求并提取开发要点:
需求描述: Use Codex Skill to perform deep analysis. Codex should operate in "plan mode" style:
[用户需求 + 澄清后的细节]
请输出: **When Deep Analysis is Needed** (any condition triggers):
1. 核心功能(一句话) - Multiple valid approaches exist (e.g., Redis vs in-memory vs file-based caching)
2. 关键技术点 - Significant architectural decisions required (e.g., WebSockets vs SSE vs polling)
3. 可并发的任务分解2-5个 - Large-scale changes touching many files or systems
- 任务ID - Unclear scope requiring exploration first
- 任务描述
- 涉及文件/目录 **What Codex Does in Analysis Mode**:
- 是否依赖其他任务 1. **Explore Codebase**: Use Glob, Grep, Read to understand structure, patterns, architecture
- 测试重点 2. **Identify Existing Patterns**: Find how similar features are implemented, reuse conventions
" "gpt-5.1-codex" 3. **Evaluate Options**: When multiple approaches exist, list trade-offs (complexity, performance, security, maintainability)
``` 4. **Make Architectural Decisions**: Choose patterns, APIs, data models with justification
- Extract core functionality, technical key points, and 2-5 parallelizable tasks with full metadata 5. **Design Task Breakdown**: Produce 2-5 parallelizable tasks with file scope and dependencies
**Analysis Output Structure**:
```
## Context & Constraints
[Tech stack, existing patterns, constraints discovered]
## Codebase Exploration
[Key files, modules, patterns found via Glob/Grep/Read]
## Implementation Options (if multiple approaches)
| Option | Pros | Cons | Recommendation |
## Technical Decisions
[API design, data models, architecture choices made]
## Task Breakdown
[2-5 tasks with: ID, description, file scope, dependencies, test command]
```
**Skip Deep Analysis When**:
- Simple, straightforward implementation with obvious approach
- Small changes confined to 1-2 files
- Clear requirements with single implementation path
- **Step 3: Generate Development Documentation** - **Step 3: Generate Development Documentation**
- invoke agent dev-plan-generator: - invoke agent dev-plan-generator
```
基于以下分析结果生成开发文档:
[Codex 分析输出]
输出文件:./.claude/specs/{feature_name}/dev-plan.md
包含:
1. 功能概述
2. 任务列表2-5个并发任务
- 每个任务ID、描述、文件范围、依赖、测试命令
3. 验收标准
4. 覆盖率要求≥90%
```
- **Step 4: Parallel Development Execution** - **Step 4: Parallel Development Execution**
- For each task in `dev-plan.md` run: - For each task in `dev-plan.md`, invoke Codex with this brief:
```bash ```
uv run ~/.claude/skills/codex/scripts/codex.py "实现任务:[任务ID] Task: [task-id]
Reference: @.claude/specs/{feature_name}/dev-plan.md
参考文档:@.claude/specs/{feature_name}/dev-plan.md Scope: [task file scope]
Test: [test command]
你的职责: Deliverables: code + unit tests + coverage ≥90% + coverage summary
1. 实现功能代码
2. 编写单元测试
3. 运行测试 + 覆盖率
4. 报告覆盖率结果
文件范围:[任务的文件范围]
测试命令:[任务指定的测试命令]
覆盖率目标≥90%
" "gpt-5.1-codex"
``` ```
- Execute independent tasks concurrently; serialize conflicting ones; track coverage reports - Execute independent tasks concurrently; serialize conflicting ones; track coverage reports