name: requirement-assistant
scope: universal
description: |
Guide requirement writing, user story creation, and feature specification.
Use when: writing requirements, user stories, issues, feature planning.
Keywords: requirement, user story, issue, feature, specification, 需求, 功能規劃, 規格.

Requirement Assistant

Language: English | 繁體中文

Version: 1.0.0
Last Updated: 2025-12-24
Applicability: Claude Code Skills

Purpose

This skill provides guidance on writing clear, complete, and actionable requirements.

Quick Reference

User Story Format (INVEST)

As a [role],
I want [feature],
So that [benefit].

INVEST Criteria

Requirement Priority Levels

Detailed Guidelines

For complete standards, see:
- Requirement Writing Guide
- Requirement Checklist

Quick Templates

Simple Issue Template

## Problem
[What problem are we solving?]

## Proposed Solution
[How should we solve it?]

## Acceptance Criteria
- [ ] [Criterion 1]
- [ ] [Criterion 2]
- [ ] [Criterion 3]

Feature Request Template

## Summary
[One-line description]

## Motivation
[Why is this needed? Who benefits?]

## Detailed Description
[Full description of the feature]

## Acceptance Criteria
- [ ] [Measurable criterion 1]
- [ ] [Measurable criterion 2]

## Out of Scope
- [What this feature does NOT include]

Bug Report Template

## Description
[Brief description of the bug]

## Steps to Reproduce
1. [Step 1]
2. [Step 2]
3. [Step 3]

## Expected Behavior
[What should happen]

## Actual Behavior
[What actually happens]

## Environment
- OS: [e.g., Windows 11]
- Version: [e.g., v1.2.3]

Acceptance Criteria Guidelines

Good Acceptance Criteria

• Specific: Clear, unambiguous
• Measurable: Can verify pass/fail
• Achievable: Technically feasible
• Relevant: Related to the requirement
• Testable: Can write a test for it

Examples

Good:

- [ ] User can upload files up to 10MB
- [ ] System responds within 500ms for 95th percentile
- [ ] Error message displays when upload fails

Bad:

- [ ] System should be fast  # Not measurable
- [ ] Make it user-friendly  # Too vague
- [ ] Fix the bug            # No specific criteria

Requirement Completeness Checklist

When writing requirements, ensure you cover:

• [ ] What: Clear description of the feature
• [ ] Why: Business value / problem solved
• [ ] Who: Target users / personas
• [ ] When: Priority / timeline
• [ ] How: High-level approach (if known)
• [ ] Acceptance: Criteria for completion
• [ ] Scope: What's NOT included

Configuration Detection

This skill supports project-specific requirement templates.

Detection Order

1. Check CONTRIBUTING.md for "Disabled Skills" section
2. If this skill is listed, it is disabled for this project
3. Check CONTRIBUTING.md for "Requirement Language" section
4. Check for .github/ISSUE_TEMPLATE/ directory
5. Check for docs/templates/ directory
6. If not found, default to English and use default templates

First-Time Setup

If no templates found:

1. Ask the user: "This project doesn't have requirement templates. Which language should I use? (English / 中文)"
2. After user selection, suggest documenting in CONTRIBUTING.md:

## Requirement Language

This project uses **[chosen option]** for requirements and issues.
<!-- Options: English | 中文 -->

1. Suggest appropriate template based on project type

Configuration Example

In project's CONTRIBUTING.md:

## Requirement Language

This project uses **English** for requirements and issues.
<!-- Options: English | 中文 -->

### Issue Templates Location
`.github/ISSUE_TEMPLATE/`

Related Standards

• Spec-Driven Development
• Checkin Standards

Version History

License

This skill is released under CC BY 4.0.

Source: universal-dev-standards