Token导航 LogoToken导航TokenDH.com
开发规范需要联网github未标认证来源可访问许可证需确认审计通过

ba-best-practices巴最佳实践

Agent Skill

ba-best-practices 用于记录任务执行中的错误、用户纠正、经验和能力缺口,适合在 Codex、Claude、Cursor、Gemini CLI 中希望让 Agent 持续沉淀问题、修正和最佳实践时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

6,535

周安装

169

GitHub Stars

公开资料未说明

下载量

2,449
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:ba-best-practices(巴最佳实践)
来源仓库:https://github.com/danhvb/my-ba-skills
仓库路径:skills/ba-best-practices
安装命令:
npx skills add https://github.com/danhvb/my-ba-skills --skill 'BA Best Practices'
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/danhvb/my-ba-skills --skill 'BA Best Practices'

简介

ba-best-practices 指导 AI 助手遵循专业业务分析规范,提升需求质量和协作效率。

  • 适用于在 Codex、Claude、Cursor、Gemini CLI 中撰写清晰、完整、一致的业务需求文档。
  • 强调语言简洁明确、单条陈述、具体可测,并提供常见错误示例与改进建议。
  • 安装方式:npx skills add https://github.com/danhvb/my-ba-skills --skill 'BA Best Practices'。
  • 使用前需确认权限范围、维护状态,并注意是否会触发联网、命令执行或文件读写操作。

SKILL.md

BA Best Practices Skill

Purpose

Guide AI assistants in applying professional BA best practices to ensure high-quality requirements, effective collaboration, and successful project outcomes.

Requirements Quality Attributes

1. Clear

  • Use simple, unambiguous language
  • Avoid jargon without definition
  • One requirement per statement
  • Specific and concrete

❌ Bad: "System should be user-friendly" ✅ Good: "System shall complete checkout process in maximum 3 clicks"

2. Complete

  • All necessary information included
  • Edge cases addressed
  • Exceptions documented
  • Success and failure scenarios covered

3. Consistent

  • No contradictions with other requirements
  • Consistent terminology throughout
  • Aligned with business objectives
  • Follows documentation standards

4. Testable

  • Can be verified through testing
  • Measurable acceptance criteria
  • Observable outcomes
  • Objective pass/fail determination

❌ Bad: "System should load quickly" ✅ Good: "System shall load homepage in < 3 seconds on 4G connection"

5. Traceable

  • Linked to business need
  • Source documented
  • Unique identifier
  • Impact analysis possible

6. Feasible

  • Technically achievable
  • Within budget constraints
  • Realistic timeline
  • Resources available

Documentation Standards

Naming Conventions

Requirements IDs:

  • Format: [TYPE]-[MODULE]-[NUMBER]
  • Examples: FR-AUTH-001, NFR-PERF-005, BR-PRICING-003

Documents:

  • BRD_ProjectName_v1.0.pdf
  • FRS_ModuleName_v2.1.pdf
  • UseCases_FeatureName_v1.0.pdf

Version Control

Semantic Versioning:

  • Major.Minor.Patch (1.0.0)
  • Major: Significant changes, restructuring
  • Minor: New sections, requirements added
  • Patch: Corrections, clarifications

Change Log:

DateVersionAuthorChangesReason
2026-01-151.0JohnInitialNew project
2026-01-201.1JaneAdded FR-005-010Stakeholder feedback

Document Structure

Standard Sections:

  1. Document Control (version, approvals, distribution)
  2. Table of Contents
  3. Introduction (purpose, scope, audience)
  4. Main Content
  5. Appendices (glossary, references, diagrams)

Requirements Traceability Matrix (RTM)

Purpose: Link requirements to business needs, design, and tests

Req IDBusiness NeedDesign ElementTest CaseStatus
FR-001BN-001DES-UI-001TC-001, TC-002Implemented
FR-002BN-001DES-API-003TC-003In Progress

Benefits:

  • Ensure all business needs addressed
  • Impact analysis for changes
  • Test coverage verification
  • Audit trail

Change Management

Change Request Process

  1. Request Submission

- Change description - Business justification - Impact assessment - Priority

  1. Impact Analysis

- Requirements affected - Design impact - Development effort - Testing impact - Timeline impact - Cost impact

  1. Review & Approval

- Change Control Board (CCB) review - Stakeholder approval - Budget approval (if needed)

  1. Implementation

- Update requirements - Update design - Communicate changes - Update traceability

  1. Verification

- Validate changes implemented correctly - Update documentation - Close change request

Change Request Template

# Change Request CR-001

**Date**: 2026-01-20
**Requested By**: Marketing Manager
**Priority**: High

## Change Description
Add social login (Google, Facebook) to registration process

## Business Justification
- Reduce registration friction
- Increase conversion by estimated 25%
- Competitive parity

## Impact Analysis
**Requirements**: Add FR-AUTH-015, FR-AUTH-016
**Design**: New OAuth integration components
**Development**: 2 weeks (40 hours)
**Testing**: 1 week UAT
**Timeline**: Delay release by 2 weeks
**Cost**: $8,000

## Approval
- [ ] Product Owner
- [ ] Technical Lead
- [ ] Project Manager

## Decision
☐ Approved  ☐ Rejected  ☐ Deferred

**Reason**: _____________________

Review & Approval Workflows

Requirements Review Checklist

Content Review:

  • All requirements follow quality attributes
  • Business rules clearly documented
  • Assumptions explicitly stated
  • Constraints identified
  • Dependencies mapped
  • Acceptance criteria defined

Technical Review:

  • Technically feasible
  • Integration points identified
  • Performance requirements realistic
  • Security requirements addressed
  • Scalability considered

Business Review:

  • Aligned with business objectives
  • Business value clear
  • Stakeholder needs addressed
  • Priorities appropriate
  • Budget and timeline realistic

Approval Levels

Document TypeApproversTimeline
BRDBusiness Owner, Product Manager, Finance1 week
FRSTechnical Lead, Architect, BA3 days
User StoriesProduct Owner, Scrum Master1 day
Change RequestsCCB, Affected Stakeholders2-5 days

Communication Best Practices

Stakeholder Communication

Frequency:

  • Executive: Monthly status updates
  • Product Owner: Weekly sync
  • Development Team: Daily standup, sprint ceremonies
  • End Users: Milestone demos, UAT sessions

Communication Channels:

  • Formal: Email, official documents, presentations
  • Informal: Chat (Slack, Teams), quick calls
  • Collaborative: Workshops, working sessions
  • Broadcast: Newsletters, town halls

Meeting Best Practices

Before Meeting:

  • Clear agenda sent 24 hours ahead
  • Pre-read materials shared
  • Objectives defined
  • Right participants invited

During Meeting:

  • Start and end on time
  • Follow agenda
  • Take notes and action items
  • Encourage participation
  • Park off-topic items

After Meeting:

  • Share notes within 24 hours
  • Distribute action items with owners and due dates
  • Follow up on commitments

Collaboration Techniques

Hybrid Team Collaboration

Challenges:

  • Time zone differences
  • Communication gaps
  • Tool fragmentation
  • Cultural differences

Solutions:

  • Overlap hours for real-time collaboration
  • Async communication (Lark, Notion)
  • Single source of truth for documentation
  • Regular video calls for relationship building
  • Clear documentation of decisions

Conflict Resolution

When stakeholders disagree:

  1. Understand Both Perspectives

- Listen actively to each side - Ask clarifying questions - Document concerns

  1. Find Common Ground

- Identify shared objectives - Focus on business value - Separate positions from interests

  1. Explore Options

- Brainstorm alternatives - Consider compromises - Evaluate trade-offs

  1. Use Data

- Customer feedback - Analytics - Competitive analysis - Cost-benefit analysis

  1. Escalate if Needed

- Document the conflict - Present options with pros/cons - Let decision-maker decide - Accept and move forward

Common Pitfalls & How to Avoid

Pitfall 1: Gold Plating

Problem: Adding unnecessary features Solution: Always tie requirements to business value, challenge "nice-to-haves"

Pitfall 2: Scope Creep

Problem: Uncontrolled growth of requirements Solution: Formal change management process, clear scope boundaries

Pitfall 3: Analysis Paralysis

Problem: Over-analyzing, never finishing Solution: Time-box analysis, "good enough" vs. perfect, iterative approach

Pitfall 4: Assuming Understanding

Problem: Not validating requirements with stakeholders Solution: Always confirm understanding, use prototypes, get sign-off

Pitfall 5: Ignoring Non-Functional Requirements

Problem: Focus only on features, ignore performance, security Solution: Explicitly elicit NFRs, include in DoD

Pitfall 6: Poor Documentation

Problem: Incomplete, outdated, or unclear documentation Solution: Documentation standards, version control, regular reviews

Pitfall 7: Weak Stakeholder Engagement

Problem: Stakeholders not involved or committed Solution: Regular communication, show value, involve in decisions

Continuous Improvement

Retrospectives

After Each Project/Sprint:

  • What went well?
  • What could be improved?
  • What will we do differently?
  • Action items for improvement

Metrics to Track

Requirements Quality:

  • % requirements changed after approval
  • defects traced to requirements
  • Requirements review cycle time

Stakeholder Satisfaction:

  • Survey scores
  • Feedback themes
  • Engagement levels

Delivery:

  • % requirements delivered on time
  • % requirements delivered in scope
  • Rework rate

Professional Development

Certifications:

  • CBAP (Certified Business Analysis Professional)
  • PMI-PBA (Professional in Business Analysis)
  • IIBA Certifications
  • Agile certifications (CSPO, CSM)

Continuous Learning:

  • Industry conferences
  • Webinars and workshops
  • Professional communities
  • Reading (BABOK, industry blogs)

Tools & Templates

Recommended Tools

Documentation:

  • Lark Docs (collaborative)
  • Notion (knowledge base)
  • Confluence (enterprise)

Diagrams:

  • Figma (UI/UX)
  • Miro (collaboration)
  • Lucidchart (process flows)
  • Mermaid (code-based diagrams)

Requirements Management:

  • Jira (Agile)
  • Azure DevOps
  • Lark Base (flexible)

Communication:

  • Lark (all-in-one)
  • Slack/Teams (chat)
  • Zoom (video)

References

  • BABOK® Guide (IIBA)
  • PMI-PBA Handbook
  • Agile Extension to BABOK®
  • IEEE 29148 Standards
  • Requirements Engineering by Klaus Pohl

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

33.98%
按下载量换算832

Claude

31.56%
按下载量换算773

Cursor

19.88%
按下载量换算487

Gemini CLI

9.92%
按下载量换算243

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills