faion-sdd

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Entry point:
/faion-net
— invoke this skill for automatic routing to the appropriate domain.

入口点：
/faion-net
— 调用此Skill以自动路由到对应领域。

SDD Domain Skill (Orchestrator)

Communication: User's language. Docs/code: English.

沟通语言：用户使用的语言。文档/代码：英文。

Philosophy

理念

"Intent is the source of truth" - specification is the main artifact, code is just its implementation.

No Time Estimates: Use complexity levels (Low/Medium/High) and token estimates (~Xk) instead.

“意图是唯一真理” - 规格说明是核心产物，代码只是其实现方式。

不做时间估算： 改用复杂度等级（低/中/高）和Token估算（约Xk）。

Context Discovery

上下文发现

Auto-Investigation

自动调查

Check for existing SDD structure:

Signal	How to Check	What It Tells Us
`.aidocs/`	`Glob("**/.aidocs/")`	SDD structure exists
`constitution.md`	`Read(".aidocs/constitution.md")`	Tech stack, standards defined
`roadmap.md`	`Read(".aidocs/roadmap.md")`	Features planned
`backlog/`	`Glob("*/.aidocs/backlog/")`	Features in queue
`todo/`	`Glob("*/.aidocs/todo/")`	Ready features
`in-progress/`	`Glob("*/.aidocs/in-progress/")`	Active work
`memory/`	`Glob("*/.aidocs/memory/")`	Learning artifacts

Read existing artifacts:

constitution.md for constraints and standards
Any existing specs/designs for patterns
memory/patterns.md for learned patterns

检查现有SDD结构：

信号	检查方式	说明信息
`.aidocs/`	`Glob("**/.aidocs/")`	存在SDD结构
`constitution.md`	`Read(".aidocs/constitution.md")`	已定义技术栈与标准
`roadmap.md`	`Read(".aidocs/roadmap.md")`	已规划功能
`backlog/`	`Glob("*/.aidocs/backlog/")`	功能待处理队列
`todo/`	`Glob("*/.aidocs/todo/")`	功能已就绪
`in-progress/`	`Glob("*/.aidocs/in-progress/")`	功能正在开发
`memory/`	`Glob("*/.aidocs/memory/")`	存在学习产物

读取现有产物：

从constitution.md获取约束条件与标准
从现有规格说明/设计文档获取模式
从memory/patterns.md获取已学习的模式

Discovery Questions

发现问题

Q1: SDD Phase

Q1：SDD阶段

yaml

question: "What phase of SDD workflow are you in?"
header: "Phase"
multiSelect: false
options:
  - label: "Starting new project (need constitution)"
    description: "Bootstrap SDD structure"
  - label: "Planning a feature (spec/design)"
    description: "Write spec, design, impl-plan"
  - label: "Ready to execute (have tasks)"
    description: "Implement planned tasks"
  - label: "Reviewing/improving"
    description: "Quality gates, code review"

Routing:

"Starting" → constitution-guidelines, project bootstrap
"Planning" →
```
Skill(faion-sdd-planning)
```

"Execute" →

Skill(faion-sdd-execution)

Skill(faion-feature-executor)

"Reviewing" →
```
Skill(faion-sdd-execution)
```
→ quality-gates

yaml

question: "What phase of SDD workflow are you in?"
header: "Phase"
multiSelect: false
options:
  - label: "Starting new project (need constitution)"
    description: "Bootstrap SDD structure"
  - label: "Planning a feature (spec/design)"
    description: "Write spec, design, impl-plan"
  - label: "Ready to execute (have tasks)"
    description: "Implement planned tasks"
  - label: "Reviewing/improving"
    description: "Quality gates, code review"

路由规则：

"启动新项目" → 章程指南、项目初始化
"规划功能" →
```
Skill(faion-sdd-planning)
```

"执行任务" →

Skill(faion-sdd-execution)

或

Skill(faion-feature-executor)

"评审/优化" →
```
Skill(faion-sdd-execution)
```
→ 质量关卡

Q2: Document Type (if planning)

Q2：文档类型（若处于规划阶段）

yaml

question: "What document do you need to create?"
header: "Document"
multiSelect: false
options:
  - label: "Specification (what to build)"
    description: "Requirements, success criteria"
  - label: "Design document (how to build)"
    description: "Architecture, API contracts"
  - label: "Implementation plan (tasks)"
    description: "Task breakdown, dependencies"
  - label: "All of the above"
    description: "Full planning cycle"

yaml

question: "What document do you need to create?"
header: "Document"
multiSelect: false
options:
  - label: "Specification (what to build)"
    description: "Requirements, success criteria"
  - label: "Design document (how to build)"
    description: "Architecture, API contracts"
  - label: "Implementation plan (tasks)"
    description: "Task breakdown, dependencies"
  - label: "All of the above"
    description: "Full planning cycle"

Q3: Feature Complexity

Q3：功能复杂度

yaml

question: "How complex is the feature?"
header: "Complexity"
multiSelect: false
options:
  - label: "Low (< 50k tokens)"
    description: "Single task, straightforward"
  - label: "Medium (50-150k tokens)"
    description: "Multiple tasks, some complexity"
  - label: "High (> 150k tokens)"
    description: "Many tasks, architectural changes"

Context impact:

"Low" → Single task, less formal docs
"Medium" → Standard SDD workflow
"High" → Detailed spec, parallel execution

yaml

question: "How complex is the feature?"
header: "Complexity"
multiSelect: false
options:
  - label: "Low (< 50k tokens)"
    description: "Single task, straightforward"
  - label: "Medium (50-150k tokens)"
    description: "Multiple tasks, some complexity"
  - label: "High (> 150k tokens)"
    description: "Many tasks, architectural changes"

对上下文的影响：

"低复杂度" → 单一任务，文档无需过于正式
"中复杂度" → 遵循标准SDD工作流
"高复杂度" → 详细规格说明、并行执行

Architecture

架构

This skill orchestrates 2 sub-skills:

Sub-Skill	Scope	Methodologies
faion-sdd-planning	Specs, design docs, impl-plans, tasks, templates, workflows	28
faion-sdd-execution	Quality gates, reflexion, patterns, memory, code review, context	20

Total: 48 methodologies

本Skill编排两个子Skill：

子Skill	覆盖范围	方法论数量
faion-sdd-planning	规格说明、设计文档、实施计划、任务、模板、工作流	28
faion-sdd-execution	质量关卡、反思、模式、记忆、代码评审、上下文	20

总计： 48种方法论

Workflow Overview

工作流概览

CONSTITUTION → SPEC → DESIGN → IMPL-PLAN → TASKS → EXECUTE → DONE
      |          |        |          |          |         |        |
   project    feature  technical   100k rule   atomic   agent    learn
   principles  intent   approach   compliance   units  execution reflect

CONSTITUTION → SPEC → DESIGN → IMPL-PLAN → TASKS → EXECUTE → DONE
      |          |        |          |          |         |        |
   project    feature  technical   100k rule   atomic   agent    learn
   principles  intent   approach   compliance   units  execution reflect

When to Use Which Sub-Skill

子Skill适用场景

Use faion-sdd-planning for:

适用faion-sdd-planning的场景：

Writing specifications (WHAT + WHY)
Creating design documents (HOW)
Breaking down implementation plans (TASKS)
Task creation from impl-plans
Template usage
Workflow navigation

编写规格说明（要做什么+为什么做）
创建设计文档（怎么做）
拆分实施计划（任务）
根据实施计划创建任务
使用模板
工作流导航

Use faion-sdd-execution for:

适用faion-sdd-execution的场景：

Task execution workflows
Quality gate validation (L1-L6)
Code review cycles
Reflexion learning (PDCA)
Pattern/mistake memory management
Context management strategies
Task parallelization analysis

任务执行工作流
质量关卡验证（L1-L6）
代码评审周期
反思学习（PDCA循环）
模式/错误记忆管理
上下文管理策略
任务并行化分析

Quick Decision Tree

快速决策树

If you need...	Invoke	Why
Write spec	faion-sdd-planning	Documentation phase
Write design doc	faion-sdd-planning	Documentation phase
Create impl-plan	faion-sdd-planning	Documentation phase
Create tasks	faion-sdd-planning	Documentation phase
Get templates	faion-sdd-planning	Templates stored there
Run quality gates	faion-sdd-execution	Validation phase
Execute tasks	faion-sdd-execution	Execution phase
Code review	faion-sdd-execution	Review phase
Learn patterns	faion-sdd-execution	Learning phase
Check mistakes	faion-sdd-execution	Learning phase
Parallelize tasks	faion-sdd-execution	Optimization phase

需求场景	调用Skill	原因
编写规格说明	faion-sdd-planning	文档编制阶段
编写设计文档	faion-sdd-planning	文档编制阶段
创建实施计划	faion-sdd-planning	文档编制阶段
创建任务	faion-sdd-planning	文档编制阶段
获取模板	faion-sdd-planning	模板存储于此
运行质量关卡	faion-sdd-execution	验证阶段
执行任务	faion-sdd-execution	执行阶段
代码评审	faion-sdd-execution	评审阶段
学习模式	faion-sdd-execution	学习阶段
检查错误	faion-sdd-execution	学习阶段
任务并行化	faion-sdd-execution	优化阶段

Directory Structure

目录结构

.aidocs/
├── constitution.md                    # Project principles
├── contracts.md                       # API contracts
├── roadmap.md                         # Milestones
└── features/
    ├── backlog/                       # Waiting for grooming
    ├── todo/                          # Ready for execution
    ├── in-progress/                   # Being worked on
    └── done/                          # Completed
        └── {NN}-{feature}/
            ├── spec.md                # WHAT and WHY
            ├── design.md              # HOW
            ├── implementation-plan.md # Tasks breakdown
            └── tasks/
                ├── backlog/
                ├── todo/              # Ready tasks
                ├── in-progress/       # Executing
                └── done/              # Completed

Lifecycle:

backlog/ → todo/ → in-progress/ → done/

.aidocs/
├── constitution.md                    # Project principles
├── contracts.md                       # API contracts
├── roadmap.md                         # Milestones
└── features/
    ├── backlog/                       # Waiting for grooming
    ├── todo/                          # Ready for execution
    ├── in-progress/                   # Being worked on
    └── done/                          # Completed
        └── {NN}-{feature}/
            ├── spec.md                # WHAT and WHY
            ├── design.md              # HOW
            ├── implementation-plan.md # Tasks breakdown
            └── tasks/
                ├── backlog/
                ├── todo/              # Ready tasks
                ├── in-progress/       # Executing
                └── done/              # Completed

生命周期：

backlog/ → todo/ → in-progress/ → done/

Agents

Agent	Purpose	Sub-Skill
faion-task-executor-agent	Execute SDD tasks autonomously	execution
faion-task-creator-agent	Create detailed TASK_*.md files	planning
faion-sdd-reviewer-agent	Quality gate reviews	execution
faion-hallucination-checker-agent	Validate task completion	execution

Agent	用途	子Skill
faion-task-executor-agent	自主执行SDD任务	execution
faion-task-creator-agent	创建详细的TASK_*.md文件	planning
faion-sdd-reviewer-agent	质量关卡评审	execution
faion-hallucination-checker-agent	验证任务完成情况	execution

Memory Storage

记忆存储

Location: Project-local

.aidocs/memory/

(not global)

.aidocs/memory/
├── patterns.md           # Learned patterns
├── mistakes.md           # Errors and solutions
├── decisions.md          # Key decisions
└── session.md            # Session state

存储位置： 项目本地的

.aidocs/memory/

（非全局）

.aidocs/memory/
├── patterns.md           # Learned patterns
├── mistakes.md           # Errors and solutions
├── decisions.md          # Key decisions
└── session.md            # Session state

Related Skills

关联Skills

Skill	Relationship
faion-net	Parent orchestrator
faion-feature-executor	Executes SDD tasks in sequence
faion-software-developer	Implements code from tasks
faion-product-manager	Provides product specs
faion-software-architect	Provides design documents

faion-sdd v4.0 (Orchestrator) Sub-skills: faion-sdd-planning (28) + faion-sdd-execution (20)

Skill	关系
faion-net	父编排器
faion-feature-executor	按顺序执行SDD任务
faion-software-developer	根据任务实现代码
faion-product-manager	提供产品规格说明
faion-software-architect	提供设计文档

faion-sdd v4.0（编排器） 子Skill：faion-sdd-planning（28） + faion-sdd-execution（20）