Initial commit

2025-11-30 09:05:29 +08:00
commit 91fde12a8b
51 changed files with 11738 additions and 0 deletions
--- a/commands/role-help.md
+++ b/commands/role-help.md
@@ -0,0 +1,276 @@
+## Role Help
+
+A selection guide and help system when you're unsure which role to use.
+
+### Usage
+
+```bash
+/role-help                      # General role selection guide
+/role-help <situation/problem>  # Recommended roles for specific situations
+/role-help compare <Role 1>,<Role 2> # Compare roles
+```
+
+### Basic Examples
+
+```bash
+# General guidance
+/role-help
+→ List of available roles and their characteristics
+
+# Situation-specific recommendation
+/role-help "Concerned about API security"
+→ Recommendation and usage of security role
+
+# Role comparison
+/role-help compare frontend,mobile
+→ Differences and appropriate usage between frontend and mobile roles
+```
+
+### Situation-Based Role Selection Guide
+
+### Security-Related
+
+```text
+Use security role for:
+✅ Implementation of login/authentication functions
+✅ Security vulnerability checks for APIs
+✅ Data encryption and privacy protection
+✅ Security compliance verification
+✅ Penetration testing
+
+Usage: /role security
+```
+
+### 🏗️ Architecture & Design
+
+```text
+Use architect role for:
+✅ Evaluation of overall system design
+✅ Microservices vs monolith decisions
+✅ Database design and technology selection
+✅ Scalability and extensibility considerations
+✅ Technical debt assessment and improvement planning
+
+Usage: /role architect
+```
+
+### ⚡ Performance Issues
+
+```text
+Use performance role for:
+✅ Slow applications
+✅ Database query optimization
+✅ Web page loading speed improvement
+✅ Memory and CPU usage optimization
+✅ Scaling and load countermeasures
+
+Usage: /role performance
+```
+
+### 🔍 Problem Root Cause Investigation
+
+```text
+Use analyzer role for:
+✅ Root cause analysis of bugs and errors
+✅ Investigation of system failures
+✅ Structural analysis of complex problems
+✅ Data analysis and statistical research
+✅ Understanding why problems occur
+
+Usage: /role analyzer
+```
+
+### 🎨 Frontend & UI/UX
+
+```text
+Use frontend role for:
+✅ User interface improvements
+✅ Accessibility compliance
+✅ Responsive design
+✅ Usability and ease of use enhancement
+✅ General web frontend technologies
+
+Usage: /role frontend
+```
+
+### 📱 Mobile App Development
+
+```text
+Use mobile role for:
+✅ iOS and Android app optimization
+✅ Mobile-specific UX design
+✅ Touch interface optimization
+✅ Offline support and synchronization functions
+✅ App Store and Google Play compliance
+
+Usage: /role mobile
+```
+
+### 👀 Code Review & Quality
+
+```text
+Use reviewer role for:
+✅ Code quality checks
+✅ Readability and maintainability evaluation
+✅ Coding convention verification
+✅ Refactoring proposals
+✅ PR and commit reviews
+
+Usage: /role reviewer
+```
+
+### 🧪 Testing & Quality Assurance
+
+```text
+Use qa role for:
+✅ Test strategy planning
+✅ Test coverage evaluation
+✅ Automated test implementation guidelines
+✅ Bug prevention and quality improvement measures
+✅ Test automation in CI/CD
+
+Usage: /role qa
+```
+
+### When Multiple Roles Are Needed
+
+### 🔄 multi-role (Parallel Analysis)
+
+```text
+Use multi-role for:
+✅ Evaluation from multiple professional perspectives
+✅ Creating integrated improvement plans
+✅ Comparing evaluations from different fields
+✅ Organizing contradictions and overlaps
+
+Example: /multi-role security,performance
+```
+
+### 🗣️ role-debate (Discussion)
+
+```text
+Use role-debate for:
+✅ Trade-offs between specialized fields
+✅ Divided opinions on technology selection
+✅ Making design decisions through discussion
+✅ Hearing debates from different perspectives
+
+Example: /role-debate security,performance
+```
+
+### 🤖 smart-review (Automatic Proposal)
+
+```text
+Use smart-review for:
+✅ Uncertainty about which role to use
+✅ Wanting to know the optimal approach for current situation
+✅ Choosing from multiple options
+✅ Beginner indecision
+
+Example: /smart-review
+```
+
+### Role Comparison Table
+
+### Security Category
+
+| Role     | Main Use                                 | Strengths                              | Weaknesses                           |
+| -------- | ---------------------------------------- | -------------------------------------- | ------------------------------------ |
+| security | Vulnerability and attack countermeasures | Threat analysis, authentication design | UX, performance                      |
+| analyzer | Root cause analysis                      | Logical analysis, evidence collection  | Preventive measures, future planning |
+
+### Design Category
+
+| Role      | Main Use      | Strengths                                   | Weaknesses                                    |
+| --------- | ------------- | ------------------------------------------- | --------------------------------------------- |
+| architect | System design | Long-term perspective, overall optimization | Detailed implementation, short-term solutions |
+| reviewer  | Code quality  | Implementation level, maintainability       | Business requirements, UX                     |
+
+### Performance Category
+
+| Role        | Main Use                           | Strengths                              | Weaknesses           |
+| ----------- | ---------------------------------- | -------------------------------------- | -------------------- |
+| performance | Speed improvement and optimization | Measurement, bottleneck identification | Security, UX         |
+| qa          | Quality assurance                  | Testing, automation                    | Design, architecture |
+
+### User Experience Category
+
+| Role     | Main Use  | Strengths              | Weaknesses       |
+| -------- | --------- | ---------------------- | ---------------- |
+| frontend | Web UI/UX | Browser, accessibility | Server-side, DB  |
+| mobile   | Mobile UX | Touch, offline support | Server-side, Web |
+
+### Decision Flowchart When Unsure
+
+```text
+What is the nature of the problem?
+├─ Security-related → security
+├─ Performance issues → performance
+├─ Bug/failure investigation → analyzer
+├─ UI/UX improvement → frontend or mobile
+├─ Design/architecture → architect
+├─ Code quality → reviewer
+├─ Testing-related → qa
+└─ Complex/composite → smart-review for proposal
+
+Spans multiple fields?
+├─ Want integrated analysis → multi-role
+├─ Discussion/trade-offs → role-debate
+└─ Unsure → smart-review
+```
+
+### Frequently Asked Questions
+
+### Q: What's the difference between frontend and mobile roles?
+
+```text
+A:
+frontend: Web browser-focused, HTML/CSS/JavaScript
+mobile: Mobile app-focused, iOS/Android native, React Native, etc.
+
+For issues related to both, multi-role frontend,mobile is recommended
+```
+
+### Q: How to choose between security and analyzer roles?
+
+```text
+A:
+security: Prevention of attacks and threats, security design
+analyzer: Analysis of causes of existing problems, investigation
+
+For security incident investigations, use multi-role security,analyzer
+```
+
+### Q: What's the difference between architect and performance roles?
+
+```text
+A:
+architect: Long-term design of entire systems, scalability
+performance: Specific speed and efficiency improvements
+
+For performance design of large-scale systems, use multi-role architect,performance
+```
+
+### Collaboration with Claude
+
+```bash
+# Combined with situation description
+/role-help
+"React app page loading is slow, receiving complaints from users"
+
+# Combined with file content
+cat problem-description.md
+/role-help
+"Recommend the most suitable role for this problem"
+
+# When unsure between specific options
+/role-help compare security,performance
+"Which role is appropriate for JWT token expiration issues?"
+```
+
+### Notes
+
+- For complex problems, combining multiple roles is more effective
+- For urgent matters, use single role for quick response
+- When unsure, it's recommended to use smart-review for automatic proposals
+- The final decision should be made by the user considering the nature of the problem