Loading...
Loading...
Compare original and translation side by side
| Input | Type | Required | Description |
|---|---|---|---|
| project_root | string | Yes | Root path of project to analyze |
| completed_artifact | string | No | ID of just-completed artifact (e.g., PRD-00) |
| focus_area | string | No | Optional filter: "core-workflow", "quality", "planning" |
| 输入项 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| project_root | string | 是 | 待分析项目的根路径 |
| completed_artifact | string | 否 | 刚完成的工件ID(例如:PRD-00) |
| focus_area | string | 否 | 可选筛选条件:"core-workflow"、"quality"、"planning" |
undefinedundefined
**Status Extraction**:
Extract status from Document Control section:
- Draft
- In Review
- Approved
- Superseded
- Deprecated
**Project State Model**:
```yaml
project_state:
scan_timestamp: 2025-11-29T14:30:00Z
artifacts_by_type:
BRD:
total: 3
approved: 2
draft: 1
latest: BRD-03
PRD:
total: 2
approved: 1
draft: 1
latest: PRD-00
EARS:
total: 0
# ... etc
total_artifacts: 25
approved_artifacts: 18
draft_artifacts: 7
**状态提取**:
从文档控制部分提取状态:
- Draft(草稿)
- In Review(审核中)
- Approved(已批准)
- Superseded(已取代)
- Deprecated(已废弃)
**项目状态模型**:
```yaml
project_state:
scan_timestamp: 2025-11-29T14:30:00Z
artifacts_by_type:
BRD:
total: 3
approved: 2
draft: 1
latest: BRD-03
PRD:
total: 2
approved: 1
draft: 1
latest: PRD-00
EARS:
total: 0
# ... etc
total_artifacts: 25
approved_artifacts: 18
draft_artifacts: 7workflow_layers:
layer_1:
type: BRD
name: Business Requirements
prerequisite: null
description: "Business objectives and stakeholder needs"
layer_2:
type: PRD
name: Product Requirements
prerequisite: BRD
description: "Product features and user needs"
layer_3:
type: EARS
name: Formal Requirements
prerequisite: PRD
description: "WHEN-THE-SHALL formal requirements"
layer_4:
type: BDD
name: Behavior Tests
prerequisite: EARS
description: "Gherkin acceptance scenarios"
layer_5:
type: ADR
name: Architecture Decisions
prerequisite: BDD
description: "Technical decision records"
layer_6:
type: SYS
name: System Requirements
prerequisite: ADR
description: "Technical system specifications"
layer_7:
type: REQ
name: Atomic Requirements
prerequisite: SYS
description: "Detailed atomic requirements"
layer_8:
type: IMPL
name: Implementation Plan
prerequisite: REQ
optional: true
description: "WHO/WHEN project management"
layer_9:
type: CTR
name: Interface Contracts
prerequisite: [IMPL, REQ]
optional: true
description: "API contracts and schemas"
layer_10:
type: SPEC
name: Technical Specifications
prerequisite: REQ
description: "YAML implementation specs"
layer_11:
type: TASKS
name: Implementation Tasks
prerequisite: SPEC
description: "Code generation task lists - flows to Code layer"workflow_position:
completed_layers: [1, 2] # BRD, PRD done
in_progress_layers: [3] # EARS in progress
blocked_layers: [4, 5, 6, 7, 10, 11] # Waiting on prerequisites
ready_layers: [3] # Can start now
optional_ready: [8, 9] # Optional, prereqs met
current_position:
layer: 3
type: EARS
status: in_progress
progress_percentage: 18% # 2 of 11 layers completeworkflow_layers:
layer_1:
type: BRD
name: Business Requirements
prerequisite: null
description: "Business objectives and stakeholder needs"
layer_2:
type: PRD
name: Product Requirements
prerequisite: BRD
description: "Product features and user needs"
layer_3:
type: EARS
name: Formal Requirements
prerequisite: PRD
description: "WHEN-THE-SHALL formal requirements"
layer_4:
type: BDD
name: Behavior Tests
prerequisite: EARS
description: "Gherkin acceptance scenarios"
layer_5:
type: ADR
name: Architecture Decisions
prerequisite: BDD
description: "Technical decision records"
layer_6:
type: SYS
name: System Requirements
prerequisite: ADR
description: "Technical system specifications"
layer_7:
type: REQ
name: Atomic Requirements
prerequisite: SYS
description: "Detailed atomic requirements"
layer_8:
type: IMPL
name: Implementation Plan
prerequisite: REQ
optional: true
description: "WHO/WHEN project management"
layer_9:
type: CTR
name: Interface Contracts
prerequisite: [IMPL, REQ]
optional: true
description: "API contracts and schemas"
layer_10:
type: SPEC
name: Technical Specifications
prerequisite: REQ
description: "YAML implementation specs"
layer_11:
type: TASKS
name: Implementation Tasks
prerequisite: SPEC
description: "Code generation task lists - flows to Code layer"workflow_position:
completed_layers: [1, 2] # BRD、PRD已完成
in_progress_layers: [3] # EARS进行中
blocked_layers: [4, 5, 6, 7, 10, 11] # 等待前置依赖
ready_layers: [3] # 可立即开始
optional_ready: [8, 9] # 可选,前置依赖已满足
current_position:
layer: 3
type: EARS
status: in_progress
progress_percentage: 18% # 11个层级中完成2个dependency_graph:
PRD-00:
completed: true
downstream_required:
- EARS (Layer 3) - formal requirements
- BDD (Layer 4) - test scenarios
downstream_optional:
- IMPL (Layer 8) - if complex project
EARS (to be created):
upstream_required:
- PRD-00 ✓ (completed)
will_enable:
- BDD (Layer 4)
- ADR (Layer 5)| Priority | Artifact | Rationale |
|---|---|---|
| P0 | EARS | Required downstream from PRD, blocks BDD and ADR |
| P1 | BDD | Can start once EARS begun, enables ADR |
| P2 | ADR | Requires BDD completion |
dependency_graph:
PRD-00:
completed: true
downstream_required:
- EARS(第3层)- 正式需求
- BDD(第4层)- 测试场景
downstream_optional:
- IMPL(第8层)- 若为复杂项目
EARS(待创建):
upstream_required:
- PRD-00 ✓(已完成)
will_enable:
- BDD(第4层)
- ADR(第5层)| 优先级 | 工件 | 理由 |
|---|---|---|
| P0 | EARS | PRD的下游必需工件,会阻塞BDD和ADR |
| P1 | BDD | EARS启动后即可开始,为ADR提供支持 |
| P2 | ADR | 需要完成BDD |
parallel_opportunities:
rule_1:
name: "EARS and BDD overlap"
condition: "EARS in progress"
parallel_work: "BDD scenarios for completed EARS"
benefit: "Faster progress through testing layer"
rule_2:
name: "Multiple feature tracks"
condition: "Multiple BRDs exist"
parallel_work: "PRD for each BRD"
benefit: "Parallel feature development"
rule_3:
name: "ADR independence"
condition: "Technical decisions needed"
parallel_work: "ADRs can be written in parallel"
benefit: "Architecture decisions don't block each other"parallel_opportunities:
can_parallelize:
- track: "Feature A"
current: EARS-01
parallel: "Start BDD-01 scenarios for EARS-01 requirements"
- track: "Feature B"
current: PRD-00 complete
parallel: "Start EARS-02 while Feature A progresses"
blocked_parallelization:
- item: "SPEC creation"
blocker: "REQ layer incomplete"
unblock_by: "Complete REQ-01 through REQ-05"parallel_opportunities:
rule_1:
name: "EARS与BDD重叠"
condition: "EARS进行中"
parallel_work: "为已完成的EARS编写BDD场景"
benefit: "加快测试层级的进度"
rule_2:
name: "多功能分支"
condition: "存在多个BRD"
parallel_work: "为每个BRD创建PRD"
benefit: "并行功能开发"
rule_3:
name: "ADR独立性"
condition: "需要技术决策"
parallel_work: "可并行编写ADR"
benefit: "架构决策互不阻塞"parallel_opportunities:
can_parallelize:
- track: "Feature A"
current: EARS-01
parallel: "为EARS-01的需求启动BDD-01场景编写"
- track: "Feature B"
current: PRD-00已完成
parallel: "在Feature A推进EARS/BDD的同时,启动EARS-02"
blocked_parallelization:
- item: "SPEC创建"
blocker: "REQ层级未完成"
unblock_by: "完成REQ-01至REQ-05"progress_report:
overall:
layers_complete: 2
total_layers: 12
percentage: 17%
by_layer:
- layer: 1 (BRD)
status: complete
artifacts: 3
approved: 2
- layer: 2 (PRD)
status: complete
artifacts: 2
approved: 1
- layer: 3 (EARS)
status: in_progress
artifacts: 0
target: 3 (based on PRD features)
- layer: 4 (BDD)
status: blocked
blocker: "EARS incomplete"
estimated_remaining:
artifacts: 25
layers: 10
critical_path:
- EARS (blocks BDD)
- BDD (blocks ADR)
- REQ (blocks SPEC)
- SPEC (blocks TASKS)progress_report:
overall:
layers_complete: 2
total_layers: 12
percentage: 17%
by_layer:
- layer: 1 (BRD)
status: complete
artifacts: 3
approved: 2
- layer: 2 (PRD)
status: complete
artifacts: 2
approved: 1
- layer: 3 (EARS)
status: in_progress
artifacts: 0
target: 3(基于PRD功能)
- layer: 4 (BDD)
status: blocked
blocker: "EARS未完成"
estimated_remaining:
artifacts: 25
layers: 10
critical_path:
- EARS(阻塞BDD)
- BDD(阻塞ADR)
- REQ(阻塞SPEC)
- SPEC(阻塞TASKS)recommendations:
context:
completed_artifact: PRD-00
workflow_position: Layer 2 complete
progress: 17%
next_steps:
- priority: P0
action: "Create EARS document"
artifact_type: EARS
skill: doc-ears
rationale: "Required downstream from PRD-00. EARS formalizes product features into WHEN-THE-SHALL requirements."
estimated_effort: "Medium (2-4 hours)"
blocks: [BDD, ADR]
- priority: P1
action: "Start BDD scenarios"
artifact_type: BDD
skill: doc-bdd
rationale: "Can begin once EARS started. Write scenarios for completed requirements."
estimated_effort: "Medium (2-4 hours)"
parallel_with: EARS
- priority: P2
action: "Consider ADR for key decisions"
artifact_type: ADR
skill: doc-adr
rationale: "If architectural decisions needed, document early. Requires BDD completion."
estimated_effort: "Low-Medium (1-3 hours)"
condition: "After BDD progress"
parallel_opportunities:
- "Feature B: Start PRD-03 while Feature A progresses through EARS/BDD"
- "Technical: Draft ADRs for known architecture decisions"
blocked_items:
- item: "SPEC creation"
reason: "Requires REQ completion (Layer 7)"
unblock_path: "Complete layers 3-7 first"
workflow_guidance:
current_focus: "EARS creation for PRD-00 features"
short_term: "Complete EARS → BDD → ADR sequence"
medium_term: "Progress through SYS → REQ → SPEC"
progress_summary:
completed: "BRD-01, BRD-02, BRD-03, PRD-01, PRD-00"
in_progress: "None"
next_milestone: "Complete Layer 3 (EARS)"
overall: "17% complete (2/12 layers)"recommendations:
context:
completed_artifact: PRD-00
workflow_position: 第2层已完成
progress: 17%
next_steps:
- priority: P0
action: "创建EARS文档"
artifact_type: EARS
skill: doc-ears
rationale: "PRD-00的下游必需工件。EARS将产品功能正式化为WHEN-THE-SHALL格式的需求。"
estimated_effort: "中等(2-4小时)"
blocks: [BDD, ADR]
- priority: P1
action: "启动BDD场景编写"
artifact_type: BDD
skill: doc-bdd
rationale: "EARS启动后即可开始。为已完成的需求编写场景。"
estimated_effort: "中等(2-4小时)"
parallel_with: EARS
- priority: P2
action: "考虑为关键决策创建ADR"
artifact_type: ADR
skill: doc-adr
rationale: "若需要架构决策,尽早文档化。需完成BDD。"
estimated_effort: "低-中等(1-3小时)"
condition: "BDD取得进展后"
parallel_opportunities:
- "Feature B:在Feature A推进EARS/BDD的同时,启动PRD-03"
- "技术层面:为已知的架构决策起草ADR"
blocked_items:
- item: "SPEC创建"
reason: "需要完成REQ(第7层)"
unblock_path: "先完成第3-7层"
workflow_guidance:
current_focus: "为PRD-00的功能创建EARS"
short_term: "完成EARS → BDD → ADR流程"
medium_term: "推进SYS → REQ → SPEC"
progress_summary:
completed: "BRD-01、BRD-02、BRD-03、PRD-01、PRD-00"
in_progress: "无"
next_milestone: "完成第3层(EARS)"
overall: "完成17%(12个层级中完成2个)"completed: PRD-00
position: Layer 2 complete
next_steps:
1. Create EARS-01 (P0)
- Formalize PRD-00 features into WHEN-THE-SHALL requirements
- Run: /skill doc-ears
2. Start BDD scenarios (P1)
- Can begin once EARS requirements defined
- Run: /skill doc-bdd
parallel_opportunity:
"If other BRDs exist, you can create their PRDs in parallel"
progress: "17% → 25% after EARS completion"completed: PRD-00
position: 第2层已完成
next_steps:
1. 创建EARS-01(P0)
- 将PRD-00的功能正式化为WHEN-THE-SHALL格式的需求
- 执行:/skill doc-ears
2. 启动BDD场景编写(P1)
- EARS需求定义完成后即可开始
- 执行:/skill doc-bdd
parallel_opportunity:
"若存在其他BRD,可并行创建其对应的PRD"
progress: "17% → 完成EARS后达到25%"project_status:
completed_layers:
- Layer 1 (BRD): 3 documents ✓
- Layer 2 (PRD): 2 documents ✓
in_progress:
- Layer 3 (EARS): 0 documents, target 5
blocked:
- Layers 4-11: Waiting on upstream completion
progress: 18%
critical_path:
EARS → BDD → ADR → SYS → REQ → SPEC → TASKS
recommended_focus:
"Complete EARS layer to unblock BDD and ADR"project_status:
completed_layers:
- 第1层(BRD):3个文档 ✓
- 第2层(PRD):2个文档 ✓
in_progress:
- 第3层(EARS):0个文档,目标5个
blocked:
- 第4-11层:等待上游完成
progress: 18%
critical_path:
EARS → BDD → ADR → SYS → REQ → SPEC → TASKS
recommended_focus:
"完成EARS层级以解除BDD和ADR的阻塞"current_tracks:
track_a:
name: "Core Platform"
position: EARS creation
next: BDD scenarios
track_b:
name: "Partner Integration"
position: BRD complete
next: PRD creation (independent of Track A)
parallel_work:
- "Track B PRD can proceed while Track A completes EARS"
- "ADRs for known decisions can be drafted early"
- "BDD scenarios can start once first EARS requirements defined"
sequential_requirements:
- "SPEC requires REQ completion - no parallel path"
- "TASKS requires SPEC - sequential"current_tracks:
track_a:
name: "Core Platform"
position: EARS创建中
next: BDD场景编写
track_b:
name: "Partner Integration"
position: BRD已完成
next: 创建PRD(独立于Track A)
parallel_work:
- "Track B的PRD可在Track A完成EARS的同时推进"
- "可为已知决策起草ADR"
- "首个EARS需求定义完成后即可启动BDD场景编写"
sequential_requirements:
- "SPEC需要REQ完成 - 无并行路径"
- "TASKS需要SPEC - 按顺序执行"| Integration | Description |
|---|---|
| context-analyzer | Provides artifact inventory and traceability data |
| skill-recommender | Receives workflow position for better skill suggestions |
| doc-flow | Can be invoked by doc-flow for workflow orchestration |
| project-mngt | Shares planning concepts (MVP, phases) |
| 集成对象 | 描述 |
|---|---|
| context-analyzer | 提供工件清单和可追溯性数据 |
| skill-recommender | 接收工作流位置信息以优化技能建议 |
| doc-flow | 可被doc-flow调用以实现工作流编排 |
| project-mngt | 共享规划概念(MVP、阶段) |
| Metric | Target |
|---|---|
| Analysis latency | <1s for 50 artifacts |
| Recommendation generation | <500ms |
| Progress calculation | <200ms |
| 指标 | 目标 |
|---|---|
| 分析延迟 | 50个工件时<1秒 |
| 建议生成时间 | <500毫秒 |
| 进度计算时间 | <200毫秒 |
@prd: PRD.000.004
@adr: ADR-000@prd: PRD.000.004
@adr: ADR-000| Source | Type | Reference |
|---|---|---|
| PRD-00 | Product Requirements | PRD-00 |
| ADR-000 | Architecture Decision | ADR-000 |
| 来源 | 类型 | 参考 |
|---|---|---|
| PRD-00 | 产品需求 | PRD-00 |
| ADR-000 | 架构决策 | ADR-000 |
| Artifact | Type | Reference |
|---|---|---|
| doc-flow | Skill Consumer | Workflow orchestration |
| project-mngt | Skill Consumer | Release planning integration |
| 工件 | 类型 | 参考 |
|---|---|---|
| doc-flow | 技能使用者 | 工作流编排 |
| project-mngt | 技能使用者 | 发布规划集成 |