AgentSkillsCN

speckit.specify

根据自然语言描述的功能需求,创建或更新功能规格。在进行任何设计或实施工作之前,先明确“功能究竟应该做什么”。

SKILL.md
--- frontmatter
name: speckit.specify
description: Create or update the feature specification from a natural language feature description. Use when defining WHAT a feature should do before any design or implementation work.

Speckit Specify Command Executor

This skill executes the official GitHub Speckit /speckit.specify command.

Execution Protocol

When this skill is invoked, you MUST:

1. Load the Original Command File

Read and parse .opencode/commands/speckit.specify.md from the current project directory.

2. Process OpenCode Command Syntax

The command file uses special syntax that MUST be processed before execution:

SyntaxAction
$ARGUMENTSReplace with user-provided arguments (the feature description)
$1, $2, etc.Replace with positional arguments
@filepathRead the file at filepath and insert its full contents
!command``Execute the shell command and insert its stdout

3. Execute the Processed Instructions

After syntax processing, follow all instructions in the command file exactly as written, including:

  • Running .specify/scripts/powershell/create-new-feature.ps1 as specified
  • Reading .specify/templates/spec-template.md for structure
  • Creating the spec file at the designated location
  • Creating quality validation checklist

4. Maintain Speckit Workflow Integrity

  • Honor the handoffs defined in the command's YAML frontmatter
  • Suggest /speckit.clarify or /speckit.plan as next steps
  • Preserve all Speckit conventions (branch naming, file paths, structure)

User Input

text
$ARGUMENTS

Fallback

If .opencode/commands/speckit.specify.md does not exist, check for:

  • .opencode/command/speckit.specify.md (legacy path)

If no command file is found, report an error and suggest running specify init first.