spec-architect

Translate vague feature ideas into auditable engineering specifications.

69|19|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/alffei/skill_share --skill spec-architect-alffei
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-architect
Source: https://github.com/alffei/skill_share/tree/main/spec-architect
Command: npx skills add https://github.com/alffei/skill_share --skill spec-architect-alffei

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

你在把模糊的功能设想带入实现阶段时,缺乏可审核的工程文档和统一的工作流程。Spec-Architect 提供从需求到设计再到任务拆解的规范化流程,确保跨团队的理解一致,并在每个阶段产生可审阅的产物。

Core Features & Use Cases

  • Spec-driven workflow: 将需求、设计和任务拆解规范化,确保各阶段可追溯。
  • 阶段化产出: 产出明确的需求文档、架构设计和原子化任务清单,便于审批和执行。
  • Use Case: 当你需要为新功能制定明确的实现方案时,激活技能启动 Phase 1,生成需求文档并等待你逐步确认进入设计与任务拆解。

Quick Start

启动 Spec-Architect,进入 Phase 1:需求定义,生成 .agent/specs/{feature_name}/requirements.md,并按流程等待用户审核后继续。

Frequently Asked Questions about spec-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I translate vague feature ideas into auditable engineering specifications?▼

To translate vague feature ideas into auditable engineering specifications, use a structured Spec process that defines scope across requirements, architecture, and task planning. This enables stepwise approval and produces concrete artifacts for cross-team alignment.

What is the best way to create requirements, design, and task planning documents for a new software feature?▼

Creating requirements, design, and task planning documents is best handled through a spec-driven workflow that generates phase-specific files like requirements.md, design.md, and tasks.md. This ensures each stage remains traceable and reviewable before proceeding.

How does stepwise approval work when planning software architecture and breaking down tasks?▼

Stepwise approval in software architecture planning works by pausing after each phase to await user confirmation. The process generates phase-specific documents, stopping after requirements definition and architecture design so you can review before task breakdown begins.

Can I use a spec-driven workflow to ensure cross-team understanding during feature implementation?▼

Yes, you can use a spec-driven workflow to ensure cross-team understanding during feature implementation. It standardizes the flow from requirements to design to task breakdown, producing reviewable artifacts that maintain alignment across all teams involved.

What do I need to start generating structured specification documents for my software project?▼

To start generating structured specification documents for your software project, you need a vague feature idea to input. The process initiates Phase 1 to produce a requirements document and pauses, requiring your review before advancing to architecture and task planning phases.

Why do I need phase-specific documents like requirements.md and design.md during development?▼

You need phase-specific documents like requirements.md and design.md during development to provide auditable engineering documentation and a unified workflow. They prevent vague ideas from entering implementation without structured, traceable scope and architecture definitions.