跳到正文
cccskills
免费在 GitHub 公开

requirements-specification

Master requirements gathering, user story writing, acceptance criteria definition, and scope management. Transform insights into clear, actionable specifications.

中文简介正在准备中。当前显示原文说明。

查看安装方法

包含的文件(4)

  • SKILL.md7.8 KB
  • assets/config.yaml36 B
  • references/GUIDE.md21 B
  • scripts/helper.py90 B

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Requirements & Specification Skill

Transform customer insights into clear, detailed specifications that engineering can build from. Master user story writing, define acceptance criteria, and manage scope ruthlessly.

User Story Writing (INVEST Format)

INVEST Principles

I - Independent (minimal dependencies) N - Negotiable (details can be discussed) V - Valuable (delivers customer value) E - Estimable (team can estimate effort) S - Small (can complete in 1-2 sprints) T - Testable (clear success criteria)

User Story Template

As a [user role]
I want [action/capability]
So that [benefit/outcome]

Acceptance Criteria:
Given [context]
When [user action]
Then [expected result]

Good vs Bad Examples

Bad Story:

As a user
I want a better dashboard
So that I can see my data

Problem: Too vague, not testable, too large

Good Story:

As a project manager
I want to see all tasks assigned to me in the last 24 hours
So that I can track what happened while I was offline

Acceptance Criteria:
Given I'm logged in
When I view the Home dashboard
Then I see a "Recent Tasks" section
And it shows tasks assigned to me from last 24 hours
And tasks are sorted by assignment time (newest first)
And clicking a task opens the task detail page

Acceptance Criteria (BDD Format)

Scenario Template

Scenario: [Specific user action]
Given [initial context/state]
When [user performs action]
Then [expected result]
And [additional verification]

Example: Password Reset Feature

Scenario: User resets password with valid email
Given I'm on the login page
And I'm not logged in
When I click "Forgot Password?"
And enter my email address
And click "Send Reset Email"
Then I see message "Check your email for reset link"
And a password reset email is sent to that address
And the email contains a valid reset link

Scenario: User uses expired reset link
Given I received a password reset email
And the reset link is more than 24 hours old
When I click the reset link
Then I see "Link has expired"
And I'm offered to request a new reset link

Scenario: Password doesn't meet requirements
Given I'm on password reset page
When I enter password "123"
Then I see error "Password must be 8+ characters"
And the form doesn't submit

Requirements Document Structure

Executive Summary (1 page)

  • Overview of feature/product
  • Business goal/context
  • Key benefits
  • Timeline
  • Success metrics

Requirements Overview (5-10 pages)

Functional Requirements

  • What the system must do
  • Features and capabilities
  • User interactions
  • Data handling

Non-Functional Requirements

  • Performance (response time < 2s)
  • Scalability (support 10K concurrent users)
  • Security (encrypt PII)
  • Availability (99.9% uptime)
  • Accessibility (WCAG AA compliance)

Business Requirements

  • Why we're building this
  • Business metrics
  • Customer need
  • Competitive advantage

Constraints

  • Technical constraints
  • Budget constraints
  • Timeline constraints
  • Resource constraints

User Stories & Epics (20-50 pages)

Structure:

  • Epic: Large initiative grouping related stories
  • User Stories: Individual features (10-20 stories per epic)
  • Tasks: Engineering breakdown (if needed)

Each Story Includes:

  • Story ID and title
  • As a... I want... so that...
  • Acceptance criteria (3-8 scenarios)
  • Story points estimate
  • Dependencies
  • Design reference (wireframe/mockup)
  • Note/clarifications

Use Cases & Flows (10-20 pages)

Use Case Template:

Use Case: [Use Case Name]
Primary Actor: [User role]
Precondition: [State before action]

Main Flow:
1. User does X
2. System responds with Y
3. User does Z
4. System returns result

Alternative Flows:
3a. If data invalid
    - System shows error
    - User corrects and resubmits

Data Models (10 pages)

Entity Relationship Diagram

  • Entities (User, Post, Comment)
  • Relationships (User creates Posts)
  • Attributes (Post title, content, creation_date)
  • Primary keys, foreign keys

UI/Wireframes (Attached)

  • User interface mockups
  • User flows and navigation
  • Key interactions

Scope Management

MVP vs Nice-to-Have

MoSCoW Method:

MUST Have (Non-negotiable)

  • Core functionality
  • Without these: product won't work
  • Must launch with these
  • Example: User login, basic content view

SHOULD Have (Important but not critical)

  • Enhance user experience
  • Value add
  • If time allows
  • Example: Advanced search, saved preferences

COULD Have (Nice-to-have)

  • Polish features
  • Low priority
  • Do if extra time/budget
  • Example: Dark mode, animations

WON'T Have (Explicitly out of scope)

  • Clear for future
  • Helps say "no" to stakeholders
  • Plan for later version
  • Example: Mobile app (launching web first)

Scope Creep Prevention

Red Flags:

  • "Can we just add...?"
  • "This would be better if..."
  • "What about also including..."
  • "One more thing..."

Responses:

  • "That's a great idea. Let's add it to the roadmap for Q2."
  • "That would add 3 weeks. What would you deprioritize?"
  • "That's outside current scope. Document for next phase."

Change Management

Change Request Process:

  1. Document the change
  2. Assess impact (time, complexity)
  3. Present trade-offs
  4. Get stakeholder decision
  5. Update requirements document
  6. Communicate to team

Common Pitfalls

Too Vague

❌ "Improve performance" ✅ "Reduce page load time from 4s to under 2s"

No Success Criteria

❌ "Build dashboard" ✅ "Build dashboard showing active users in last 24h with 95% accuracy"

Missing Context

❌ "Fix the bug" ✅ "When searching with special characters, results show error. Fix to handle special chars."

Over-Specifying

❌ "Use Redux with saga middleware for state management" ✅ "State changes must be traceable and debuggable"

Ambiguous Acceptance Criteria

❌ "System should be fast" ✅ "API response time < 200ms for 95th percentile"

Requirements Review Checklist

  • ✓ Each requirement is testable
  • ✓ No requirement specifies implementation
  • ✓ Dependencies identified and documented
  • ✓ Acceptance criteria clear and complete
  • ✓ Engineering has estimated effort
  • ✓ Design mockups provided
  • ✓ Data models documented
  • ✓ Edge cases considered
  • ✓ Scope clearly defined (MVP vs future)
  • ✓ Success metrics identified
  • ✓ Timeline realistic
  • ✓ Reviewed by engineering lead
  • ✓ Reviewed by design lead
  • ✓ Stakeholder aligned

Troubleshooting

Yaygın Hatalar & Çözümler

HataOlası SebepÇözüm
Story çok büyükEpic olarak yazıldıStory breakdown
AC belirsizVague criteriaGiven/When/Then format
Scope creepChange mgmt yokChange request process
Missing edge casesHappy path focusEdge case workshop

Debug Checklist

[ ] Her story INVEST criteria geçiyor mu?
[ ] Acceptance criteria testable mı?
[ ] Non-functional requirements tanımlı mı?
[ ] Dependencies documented mı?
[ ] Engineering review yapıldı mı?

Recovery Procedures

  1. Ambiguous Requirements → Clarification meeting
  2. Scope Creep → Trade-off matrix
  3. Missing Feasibility → Engineering spike

Write clear requirements and avoid 90% of project problems!

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Comprehensive China A-share stock analysis covering fundamental analysis, technical analysis, policy impact assessment, and market-specific features (T+1 trading, price limits, northbound capital flow). Use when user asks about A股分析, Chinese mainland stocks, Shanghai/Shenzhen listed stocks, or needs analysis considering China market characteristics.

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

Screen and filter A-share stocks based on fundamental metrics, technical indicators, capital flow, and custom criteria. Support multiple screening strategies including value investing, growth investing, momentum trading, and dividend hunting. Use when user wants to find stocks meeting specific criteria like "低PE高ROE股票", "北向资金加仓股", "突破年线的股票".

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

Generate high-converting ad copy for Google Ads, Meta (Facebook/Instagram), LinkedIn, and TikTok. Creates multiple variations with A/B testing in mind. Includes headlines, descriptions, CTAs, and platform-specific formats. Use when creating ads, generating ad variations, or A/B testing ad copy.

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

Add new skills to an existing workflow and update all related documentation. Use when user wants to add skills from GitHub URLs to a workflow (e.g., "add this skill to the workflow", "为工作流添加技能"). Triggers on adding skills to workflows, updating workflow documentation after skill additions.

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

agile

免费

Agile product management, Scrum practices, and team collaboration for iterative product development.

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

Plan and execute effective sprints using Agile methodologies. Define sprint goals, estimate user stories, manage sprint backlog, and facilitate daily standups to maximize team productivity and deliver value incrementally.

中文简介正在准备中。当前显示原文说明。

nicepkg/ai-workflow2882026年1月20日 更新

查看 nicepkg 的全部技能

报告此技能的问题