# Send Spec Flow to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "spec-flow",
    "name": "Spec Flow",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/echoVic/spec-flow",
    "canonicalUrl": "https://clawhub.ai/echoVic/spec-flow",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/spec-flow",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spec-flow",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CONTRIBUTING.md",
      "README.md",
      "SKILL.md",
      "references/ears-format.md",
      "references/examples/feature-example.md",
      "references/execution-modes.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "spec-flow",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T06:56:21.406Z",
      "expiresAt": "2026-05-08T06:56:21.406Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spec-flow",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spec-flow",
        "contentDisposition": "attachment; filename=\"spec-flow-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "spec-flow"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/spec-flow"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/spec-flow",
    "downloadUrl": "https://openagent3.xyz/downloads/spec-flow",
    "agentUrl": "https://openagent3.xyz/skills/spec-flow/agent",
    "manifestUrl": "https://openagent3.xyz/skills/spec-flow/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/spec-flow/agent.md"
  }
}
```
## Documentation

### Spec-Flow - Structured Development Workflow

Structured workflow for complex feature development. Creates living documentation that guides implementation and serves as team reference.

### Core Principles

One phase at a time — NEVER generate documents for subsequent phases in advance
Mandatory confirmation — After each phase, STOP and wait for user confirmation
User-driven progression — Only proceed when user says "continue"/"ok"/"next"/"继续"/"好"

### Parameters

参数说明--fast跳过逐阶段确认，一次性生成所有文档（最后整体确认）--skip-design跳过 Design 阶段（简单功能，架构显而易见时）

### Language Rule

所有生成的 .md 文件必须使用中文。

### Interaction Rules

Load references/interaction-rules.md for detailed confirmation templates and prohibited behaviors.

### Five-Phase Workflow

Copy this checklist and check off items as you complete them:

### Spec-Flow Progress:

Phase 0: Initialize ⚠️ REQUIRED

 0.1 Run scripts/init-spec-flow.sh <feature-name> or create .spec-flow/active/<feature>/
 0.2 Check if .spec-flow/steering/ exists — if so, read for project context
 0.3 问自己：这个功能的核心价值是什么？用一句话能说清吗？



 Phase 1: Proposal ⚠️ REQUIRED

 1.1 Create .spec-flow/active/<feature>/proposal.md using templates/proposal.md.template
 1.2 包含：Background, Goals, Non-Goals, Scope, Risks, Open Questions
 1.3 问自己：有没有隐含的需求没写出来？
 1.4 问自己：Non-Goals 是否足够明确？能防止 scope creep 吗？
 1.5 ⏸️ 确认节点 — 等待用户确认后继续



 Phase 2: Requirements

 2.1 Create .spec-flow/active/<feature>/requirements.md using templates/requirements.md.template
 2.2 Load references/ears-format.md — 使用 EARS 格式编写需求
 2.3 包含：FR-xxx 功能需求, NFR-xxx 非功能需求, AC-xxx 验收标准
 2.4 问自己：每条需求都是可测试的吗？
 2.5 问自己：边界情况覆盖了吗？错误场景呢？
 2.6 ⏸️ 确认节点 — 等待用户确认后继续



 Phase 3: Design（除非 --skip-design）

 3.1 Create .spec-flow/active/<feature>/design.md using templates/design.md.template
 3.2 包含：Architecture (Mermaid), Components, API, Data Model, Error Handling
 3.3 问自己：这个设计能满足所有 requirements 吗？逐条对照
 3.4 问自己：有没有更简单的方案？过度设计了吗？
 3.5 ⏸️ 确认节点 — 等待用户确认后继续



 Phase 4: Tasks

 4.1 Create .spec-flow/active/<feature>/tasks.md using templates/tasks.md.template
 4.2 Load references/task-decomposition.md — 遵循任务拆解规范
 4.3 每个任务：1-2 tool calls 可完成，标注复杂度 Low/Medium/High
 4.4 分组：Setup → Implementation → Testing → Documentation
 4.5 问自己：任务之间的依赖关系对吗？有没有可以并行的？
 4.6 ⏸️ 确认节点 — 等待用户确认后继续



 Phase 5: Implementation

 5.1 Load references/execution-modes.md — 确认执行模式
 5.2 默认 Step Mode（逐任务确认），用户可切换 Batch/Phase Mode
 5.3 每个任务执行前：读 tasks.md → 检查依赖 → 读 design.md
 5.4 每个任务执行后：更新 tasks.md 状态（- [ ] → - [x]）
 5.5 全部完成后：归档到 .spec-flow/archive/

### Directory Structure

.spec-flow/
├── steering/           # 全局项目上下文（可选）
│   ├── constitution.md
│   ├── product.md
│   ├── tech.md
│   └── structure.md
├── active/             # 进行中
│   └── <feature>/
│       ├── proposal.md
│       ├── requirements.md
│       ├── design.md
│       └── tasks.md
└── archive/            # 已完成

### Steering Documents (Optional)

DocumentPurposeTemplateconstitution.md项目治理原则templates/steering/constitution.md.templateproduct.md产品愿景、目标用户templates/steering/product.md.templatetech.md技术栈、约束templates/steering/tech.md.templatestructure.md代码组织、命名规范templates/steering/structure.md.template

### Phase Transitions

FromToConditionProposalRequirementsProposal approved, questions resolvedRequirementsDesignRequirements complete, testableRequirementsTasks--skip-design, simple featureDesignTasksDesign approvedTasksImplementationTasks confirmedImplementationDoneAll tasks complete → archive

### Compatibility

Works with any AI agent that supports Skills format: Claude Code, Blade, OpenClaw, Cursor, Windsurf, etc.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: echoVic
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T06:56:21.406Z
- Expires at: 2026-05-08T06:56:21.406Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/spec-flow)
- [Send to Agent page](https://openagent3.xyz/skills/spec-flow/agent)
- [JSON manifest](https://openagent3.xyz/skills/spec-flow/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/spec-flow/agent.md)
- [Download page](https://openagent3.xyz/downloads/spec-flow)