AgentSkillsCN

requirements-wizard

提供基于IPA标准的需求定义编写与评审指南，分享业务分析、流程建模、数据建模以及评审 checklist 的最佳实践。

SKILL.md
--- frontmatter
name: requirements-wizard
description: Guide for creating and reviewing requirements definitions based on IPA standards. Provides best practices for business analysis, process mapping, data modeling, and review checklists.
status: implemented

Requirements Wizard (IPA-Standard)

This skill provides expert guidance for Requirement Definition (RD) phases, leveraging IPA (Information-technology Promotion Agency, Japan) best practices.

Capabilities

1. Best Practice Advisory

Consult the IPA-aligned knowledge base for advice on:

  • •Business Requirements: Stakeholder mapping, objective structuring (Why/What/How).
  • •Process Visualization: Hierarchical workflow design (Business vs. System levels).
  • •Data Modeling: Conceptual ER diagrams and CRUD analysis.
  • •UI/UX Design: UI standards and screen transitions.
  • •Non-Functional Requirements: Using IPA grades and defining metrics.

2. Document Review

The skill uses structured checklists to audit requirements documents following the knowledge/orchestration/knowledge-protocol.md:

  • •Hybrid Lookup: Checks knowledge/ (Public) AND knowledge/confidential/ (Private).
  • •Precedence: Internal confidential policies override general IPA/FISC standards.
  • •Safety: Proprietary details found in the confidential tier must be summarized or masked when generating public reports.

Knowledge Base Locations

  • •IPA Best Practices: knowledge/requirements-guide/ipa_best_practices.md
  • •AI Best Practices: knowledge/ai-engineering/best_practices.md
  • •Review Checklists:
    • •General: knowledge/requirements-guide/review_checklist.md
    • •AI-Specific: knowledge/ai-engineering/review_checklist.md

Usage Examples

  • •"Review my current requirements definition in docs/rd.md using the IPA checklist."
  • •"How should I structure my business process flow according to the IPA guide?"
  • •"Help me define the non-functional requirements for a high-availability banking API."

Workflow Focus

  1. •Analyze: Understand the current context and project scope.
  2. •Refer: Retrieve relevant best practices from the knowledge base.
  3. •Advise/Verify: Provide specific improvements or check for gaps using the review checklist.

Knowledge Protocol

  • •This skill adheres to the knowledge/orchestration/knowledge-protocol.md. It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.