spec-interview

Refine technical specifications through structured interviews and generate OpenSpec proposals.

16|1|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/bahayonghang/my-claude-code-settings --skill spec-interview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-interview
Source: https://github.com/bahayonghang/my-claude-code-settings/tree/main/skills/spec-interview
Command: npx skills add https://github.com/bahayonghang/my-claude-code-settings --skill spec-interview

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

通过结构化访谈将模糊需求转化为清晰、可执行的技术规格,并在访谈完成后自动创建 OpenSpec 提案。 也帮助团队在需求阶段减少返工、提升可追溯性与一致性。

Core Features & Use Cases

  • 系统性需求访谈与细化,确保关键问题被覆盖
  • 读取 plan.md 或指定文档,自动提炼需求并设计技术方案
  • 使用 AskUserQuestionTool 进行多维度访谈,收集并对比备选方案
  • 进行工程原则审查(KISS、YAGNI、DRY、SOLID),并给出权衡建议
  • 自动生成 OpenSpec proposal、任务清单和规格差异(delta),便于跟踪和实现
  • 与 OpenSpec 工作流无缝对接,提升协作与审查效率

Quick Start

  • 提供草案计划 plan.md 以启动访谈。
  • 通过系统提示进行结构化提问,澄清需求与技术约束。
  • 访谈完成后自动创建 OpenSpec proposal,并生成 openspec 目录结构与输出。

Frequently Asked Questions about spec-interview

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

FAQPage Schema
How do I convert vague project requirements into a structured technical specification?

Structured requirement interviews convert vague project ideas into clear technical specifications by systematically detailing system design and engineering principles. The process uses multi-step questioning to refine constraints and outputs an OpenSpec proposal.

What is the best way to generate OpenSpec proposals from a plan document?

Generating OpenSpec proposals from a plan document involves reading the plan.md file, automatically extracting requirements, and conducting multidimensional interviews. The system outputs a proposal, task list, and delta specs in a structured OpenSpec format.

How does structured interview-driven development improve requirement traceability?

Structured interview-driven development improves requirement traceability by enforcing engineering principles like KISS, YAGNI, DRY, and SOLID during the questioning phase. It ensures constraints are explicitly documented, reducing rework and maintaining consistency across the generated specs.

Can I use AskUserQuestionTool to compare alternative technical solutions during system design?

Yes, you can use AskUserQuestionTool to compare alternative technical solutions during system design. It facilitates multi-step, multidimensional interviews to collect, evaluate, and contrast different architectural approaches before finalizing the specification proposal.

Do I need an existing plan.md file to start a specification interview?

You need a draft plan document like plan.md to start a specification interview. The tool reads the provided document to automatically extract initial requirements and identify technical constraints before guiding you through the structured questioning process.

What outputs should I expect from a specification-driven development workflow?

From a specification-driven development workflow, you should expect an OpenSpec proposal, a comprehensive task list, and specification deltas. These outputs integrate seamlessly into OpenSpec workflows to enhance team collaboration and review efficiency.