docs: 添加项目文档和代理配置文件

添加完整的用户文档系统，包括快速开始指南、配置说明和使用手册。同时添加.claude/agents目录下的专业代理配置文件，涵盖多种技术领域的专业代理配置模板。

文档内容包括：
- 项目介绍和核心特性
- 安装和快速开始指南
- 配置系统说明（主题、权限等）
- 使用指南（Slash命令、Subagents系统等）
- 参考文档（CLI命令、工具列表）

代理配置文件包含：
- 多种技术领域的专业代理模板（前端、后端、AI、数据库等）
- 每个代理的详细描述和使用指南
- 代理的输入输出规范和最佳实践

Author: echoVic

.claude/agents

@@ -0,0 +1,70 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+## Our Standards
+
+### Acceptable Behavior
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+- Contributing constructively to discussions about AI agents and development
+
+### Unacceptable Behavior
+
+The following behaviors are considered harassment and are unacceptable:
+
+- **Hate speech**: The use of abusive or threatening speech that expresses prejudice against a particular group, especially on the basis of race, religion, gender, sexual orientation, or other characteristics
+- **Discriminatory language**: Slurs, offensive comments, or language targeting protected characteristics
+- **Personal attacks**: Insulting, demeaning, or hostile comments directed at individuals
+- **Harassment**: Deliberate intimidation, stalking, following, or threatening
+- **Doxxing**: Publishing private information without consent
+- **Spam**: Excessive off-topic content, promotional material, or repetitive posts
+- **Trolling**: Deliberately inflammatory or disruptive behavior
+- **Sexual harassment**: Unwelcome sexual attention or advances
+
+## Enforcement
+
+### Reporting
+
+If you experience or witness unacceptable behavior, please report it by:
+- Creating an issue with the `moderation` label
+- Contacting the repository maintainers directly
+- Using GitHub's built-in reporting mechanisms
+
+### Consequences
+
+Community leaders will follow these guidelines in determining consequences:
+
+1. **Warning**: First offense or minor violation
+2. **Temporary restriction**: Temporary loss of interaction privileges
+3. **Permanent ban**: Severe or repeated violations
+
+### Enforcement Actions
+
+- **Immediate removal**: Hate speech, threats, or doxxing will result in immediate content removal and user blocking
+- **Issue/PR closure**: Inappropriate content will be closed and locked
+- **Account blocking**: Repeat offenders will be blocked from the repository
+
+## Scope
+
+This Code of Conduct applies within all community spaces, including:
+- Issues and pull requests
+- Discussions and comments
+- Wiki and documentation
+- External representations of the project
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.
+
+## Contact
+
+Questions about the Code of Conduct can be directed to the repository maintainers through GitHub issues or discussions.

.claude/agents/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,125 @@
+# Contributing to Agents
+
+Thank you for your interest in contributing to this collection of Claude Code subagents! This guide will help you contribute effectively while maintaining a positive community environment.
+
+## Before You Contribute
+
+1. **Read our [Code of Conduct](.github/CODE_OF_CONDUCT.md)** - All interactions must follow our community standards
+2. **Search existing issues** - Check if your suggestion or bug report already exists
+3. **Use appropriate templates** - Follow the provided issue and PR templates
+
+## Types of Contributions
+
+### Subagent Improvements
+- Bug fixes in existing agent prompts
+- Performance optimizations
+- Enhanced capabilities or instructions
+- Documentation improvements
+
+### New Subagents
+- Well-defined specialized agents for specific domains
+- Clear use cases and examples
+- Comprehensive documentation
+- Integration with existing workflows
+
+### Infrastructure
+- GitHub Actions improvements
+- Template enhancements
+- Community tooling
+
+## Contribution Process
+
+### 1. Issues First
+- **Always create an issue before starting work** on significant changes
+- Use the appropriate issue template
+- Provide clear, detailed descriptions
+- Include relevant examples or use cases
+
+### 2. Pull Requests
+- Fork the repository and create a feature branch
+- Follow existing code style and formatting
+- Include tests or examples where appropriate
+- Reference the related issue in your PR description
+- Use clear, descriptive commit messages
+
+### 3. Review Process
+- All PRs require review from maintainers
+- Address feedback promptly and professionally
+- Be patient - reviews may take time
+
+## Content Guidelines
+
+### What We Accept
+- ✅ Constructive feedback and suggestions
+- ✅ Well-researched feature requests
+- ✅ Clear bug reports with reproduction steps
+- ✅ Professional, respectful communication
+- ✅ Documentation improvements
+- ✅ Specialized domain expertise
+
+### What We Don't Accept
+- ❌ Hate speech, discrimination, or harassment
+- ❌ Spam, promotional content, or off-topic posts
+- ❌ Personal attacks or inflammatory language
+- ❌ Duplicate or low-effort submissions
+- ❌ Requests for malicious or harmful capabilities
+- ❌ Copyright infringement
+
+## Quality Standards
+
+### For Subagents
+- Clear, specific domain expertise
+- Well-structured prompt engineering
+- Practical use cases and examples
+- Appropriate safety considerations
+- Integration with existing patterns
+
+### For Documentation
+- Clear, concise writing
+- Accurate technical information
+- Consistent formatting and style
+- Practical examples
+
+## Community Guidelines
+
+### Communication
+- **Be respectful** - Treat all community members with dignity
+- **Be constructive** - Focus on improving the project
+- **Be patient** - Allow time for responses and reviews
+- **Be helpful** - Share knowledge and assist others
+
+### Collaboration
+- **Give credit** - Acknowledge others' contributions
+- **Share knowledge** - Help others learn and grow
+- **Stay focused** - Keep discussions on topic
+- **Follow up** - Respond to feedback and requests
+
+## Getting Help
+
+- 📖 **Documentation**: Check existing README files and agent descriptions
+- 💬 **Discussions**: Use GitHub Discussions for questions and brainstorming
+- 🐛 **Issues**: Report bugs or request features through issue templates
+- 📧 **Direct Contact**: Reach out to maintainers for sensitive matters
+
+## Recognition
+
+Contributors who consistently provide high-quality submissions and maintain professional conduct will be:
+- Acknowledged in release notes
+- Given priority review for future contributions
+- Potentially invited to become maintainers
+
+## Enforcement
+
+Violations of these guidelines may result in:
+1. **Warning** - First offense or minor issues
+2. **Temporary restrictions** - Suspension of contribution privileges
+3. **Permanent ban** - Severe or repeated violations
+
+Reports of violations should be made through:
+- GitHub's built-in reporting tools
+- Issues tagged with `moderation`
+- Direct contact with maintainers
+
+---
+
+Thank you for helping make this project a welcoming, productive environment for everyone!

.claude/agents/.github/CONTRIBUTING.md

@@ -0,0 +1 @@
+github: wshobson

.claude/agents/.github/FUNDING.yml

@@ -0,0 +1,75 @@
+---
+name: Bug Report
+description: Report a bug or issue with an existing subagent
+title: "[BUG] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug! Please fill out this template
+        to help us understand and resolve the issue.
+
+        **Important**: This template is for technical bugs only.
+        For questions, discussions, or general feedback, please use
+        GitHub Discussions instead.
+
+  - type: checkboxes
+    id: preliminary-checks
+    attributes:
+      label: Preliminary Checks
+      description: Please confirm you have completed these steps
+      options:
+        - label: I have read the [Code of Conduct](.github/CODE_OF_CONDUCT.md)
+          required: true
+        - label: >-
+            I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: This report contains only technical information about a bug
+
+  - type: input
+    id: subagent
+    attributes:
+      label: Affected Subagent
+      description: Which subagent is experiencing the issue?
+      placeholder: e.g., python-pro, frontend-developer, etc.
+    validations:
+      required: true
+
+  - type: textarea
+    id: bug-description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: Describe the unexpected behavior...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction-steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Use subagent for...
+        2. Provide input...
+        3. Observe output...
+        4. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen
+      placeholder: The subagent should have...
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, or examples
+      placeholder: Add any other context about the problem here...

.claude/agents/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,12 @@
+---
+blank_issues_enabled: false
+contact_links:
+  - name: GitHub Discussions
+    url: https://github.com/wshobson/agents/discussions
+    about: For questions, brainstorming, and general discussions about subagents
+  - name: Community Guidelines
+    url: https://github.com/wshobson/agents/blob/main/.github/CODE_OF_CONDUCT.md
+    about: Read our Code of Conduct and community standards
+  - name: Contributing Guide
+    url: https://github.com/wshobson/agents/blob/main/.github/CONTRIBUTING.md
+    about: Learn how to contribute effectively to this project

.claude/agents/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,81 @@
+---
+name: Feature Request
+description: Suggest an improvement or new feature for existing subagents
+title: "[FEATURE] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a feature! Please provide detailed
+        information to help us understand your request.
+
+        **Note**: For new subagent proposals, please use the
+        "New Subagent Proposal" template instead.
+
+  - type: checkboxes
+    id: preliminary-checks
+    attributes:
+      label: Preliminary Checks
+      description: Please confirm you have completed these steps
+      options:
+        - label: I have read the [Code of Conduct](.github/CODE_OF_CONDUCT.md)
+          required: true
+        - label: >-
+            I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: This is a constructive feature request for legitimate use cases
+          required: true
+
+  - type: input
+    id: subagent
+    attributes:
+      label: Target Subagent
+      description: Which subagent would this feature enhance?
+      placeholder: e.g., python-pro, frontend-developer, etc.
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem-description
+    attributes:
+      label: Problem Description
+      description: What problem does this feature solve?
+      placeholder: Currently, users need to... This is frustrating because...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Describe your preferred solution
+      placeholder: I would like the subagent to be able to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-cases
+    attributes:
+      label: Use Cases
+      description: Provide specific examples of how this would be used
+      placeholder: |
+        1. When developing...
+        2. For projects that...
+        3. To help with...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Other solutions you've considered
+      placeholder: I also considered... but this wouldn't work because...
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information
+      placeholder: Add any other context, examples, or screenshots here...