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.