docs: add issue templates and contributing guidelines

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,69 @@
+name: '🐛 Bug report'
+description: Create a report to help us improve Tiny Robot
+title: '🐛 [Bug]: '
+labels: ['🐛 bug']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please fill out the following carefully in order to better fix the problem.
+  - type: input
+    id: tiny-robot-version
+    attributes:
+      label: Tiny Robot Version
+      description: |
+        ### **Check if the issue is reproducible with the latest stable version.**
+        You can use the command `npm ls @opentiny/tiny-robot` to view it
+      placeholder: latest
+    validations:
+      required: true
+  - type: input
+    id: vue-version
+    attributes:
+      label: Vue Version
+      placeholder: latest
+    validations:
+      required: true
+  - type: textarea
+    id: minimal-repo
+    attributes:
+      label: Link to minimal reproduction
+      description: |
+        **Whenever possible, provide a minimal reproduction using the TinyRobot Playground at https://playground.opentiny.design/tiny-robot.html. Please do not paste random links, as this will lead to the issue being closed.**
+      placeholder: Please Input
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: |
+        **What actions should we perform to reproduce the bug? Clear and concise steps can help us locate the problem more quickly. Please clearly describe the steps to reproduce the issue. Issues without clear reproduction steps will not be addressed. Issues marked with 'need reproduction' that do not provide relevant steps within 7 days will be closed.**
+      placeholder: Please Input
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What is expected
+      placeholder: Please Input
+  - type: textarea
+    id: actually
+    attributes:
+      label: What is actually happening
+      placeholder: Please Input
+  - type: input
+    id: project-name
+    attributes:
+      label: What is your project name
+      description: We also welcome you to share more detailed project information here to help us understand your scenario better.
+      placeholder: Please Input
+    validations:
+      required: true
+  - type: textarea
+    id: additional-comments
+    attributes:
+      label: Any additional comments (optional)
+      description: |
+        **Some background / context of how you ran into this bug.**
+      placeholder: Please Input

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,6 @@
+blank_issues_enabled: true
+
+contact_links:
+  - name: 💬 Questions & Discussions
+    url: https://github.com/opentiny/tiny-robot/discussions
+    about: Ask questions or discuss ideas (not bugs or features)

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,31 @@
+name: ✨ Feature Request
+description: Propose new features to Tiny Robot to improve it.
+title: '✨ [Feature]: '
+labels: ['✨ feature']
+body:
+  - type: textarea
+    id: feature-solve
+    attributes:
+      label: What problem does this feature solve
+      description: |
+        Explain your use case, context, and rationale behind this feature request. More importantly, what is the end user experience you are trying to build that led to the need for this feature?
+      placeholder: Please Input
+    validations:
+      required: true
+  - type: textarea
+    id: feature-api
+    attributes:
+      label: What does the proposed API look like
+      description: |
+        Describe how you propose to solve the problem and provide code samples of how the API would work once implemented. Note that you can use Markdown to format your code blocks.
+      placeholder: Please Input
+    validations:
+      required: true
+  - type: input
+    id: project-name
+    attributes:
+      label: What is your project name
+      description: We also welcome you to share more detailed project information here to help us understand your scenario better.
+      placeholder: Please Input
+    validations:
+      required: true

CONTRIBUTING.md

@@ -0,0 +1,100 @@
+# Contributing
+
+We are glad that you are willing to contribute to the Tiny Robot open source project. There are many forms of contribution, and you can choose one or more of them according to your strengths and interests:
+
+- Report [new defect](https://github.com/opentiny/tiny-robot/issues/new?template=bug_report.yml)
+- Provide more detailed information for [existing defects](https://github.com/opentiny/tiny-robot/labels/bug), such as supplementary screenshots, more detailed reproduction steps, minimum reproducible demo links, etc.
+- Submit Pull Requests to fix typos in the document or make the document clearer and better
+
+When you become familiar with Tiny Robot, you can try to do something more challenging, such as:
+
+- Fix defects
+- Implement new features
+- Improve unit testing
+- Translate the document
+- Participate in code review
+
+## Bug Reports
+
+If you encounter problems while using Tiny Robot components, you are welcome to submit an Issue. Before submitting, please read the relevant documentation carefully to confirm whether this is a defect or an unimplemented feature.
+
+If it is a defect, select the [Bug report](https://github.com/opentiny/tiny-robot/issues/new?template=bug_report.yml) template when creating a new Issue. The title should follow the format `[componentName] defect description`. For example: `[bubble] message content is not updated when data changes`.
+
+Issue that reports defects should mainly include:
+
+- Version numbers of `@opentiny/tiny-robot` and `vue`.
+- The performance of the defect can be illustrated by screenshot; if there is an error, the error message can be posted.
+- Defect reproduction steps, preferably with a minimum reproducible demo link.
+
+If it is a new feature, select the [Feature request](https://github.com/opentiny/tiny-robot/issues/new?template=feature_request.yml) template. The title should follow the format `[componentName] new feature description`. For example: `[sender] hope to support custom placeholder`.
+
+The following information is required for a new feature Issue:
+
+- What problems does this feature mainly solve for users?
+- What is the API of this feature?
+
+## Pull Requests
+
+Before submitting a pull request, please make sure that your submission is in line with the overall plan of Tiny Robot. Generally, issues marked as [bug](https://github.com/opentiny/tiny-robot/labels/bug) are encouraged for pull requests. If you are not sure, you can create a [Discussion](https://github.com/opentiny/tiny-robot/discussions) for discussion.
+
+### Pull Request Specification
+
+#### Commit Message
+
+The commit message should be in the form of `type(scope): description`, e.g. `fix(components): [bubble] fix xxx bug`.
+
+1. **type**: must be one of build, chore, ci, docs, feat, fix, perf, refactor, revert, release, style, test, improvement.
+
+2. **scope** (optional): package or component name, e.g. `components`, `kit`, `bubble`, `sender`, `docs`, etc.
+
+#### Pull Request Title
+
+The title should follow the same convention as the commit message, in the form of `type(scope): description`.
+
+#### Pull Request Description
+
+Please fill in the relevant information of the PR, including:
+
+- PR checklist: whether the commit message follows the specifications, whether E2E/test cases are supplemented if needed, and whether documentation is updated if needed
+- PR type: Bugfix / Feature / Code style update / Refactoring / Docs / etc.
+- Related Issue number (if any)
+- Does this PR introduce a breaking change?
+
+### Local Startup Steps
+
+- Fork the [Tiny Robot](https://github.com/opentiny/tiny-robot) repository to your personal account.
+- Clone your fork to local.
+- Add the upstream remote to sync with the latest code from the upstream repository.
+- Run `pnpm i` in the Tiny Robot root directory to install dependencies.
+- Run `pnpm dev` to start the docs and playground.
+- Open the browser to access the docs and playground.
+
+```shell
+# Replace username with your own GitHub username
+git clone git@github.com:username/tiny-robot.git
+cd tiny-robot
+
+# Add upstream remote
+git remote add upstream git@github.com:opentiny/tiny-robot.git
+
+# Install dependencies
+pnpm i
+
+# Start docs and playground
+pnpm dev
+```
+
+### Submit a PR
+
+- Make sure you have completed the local startup steps and can run the project normally.
+- Sync the latest code from the upstream `develop` branch: `git pull upstream develop`.
+- Create a new branch from the upstream `develop` branch: `git checkout -b username/feat-xxx upstream/develop` (or `username/fix-xxx` for bugfix). Branch name should be `username/feat-xxx` or `username/fix-xxx`.
+- Make your changes locally.
+- Commit following the [Conventional Commits](https://www.conventionalcommits.org/) specification. PRs that do not follow the specification may not be merged.
+- Push to your fork: `git push origin branchName`.
+- Open the [Pull requests](https://github.com/opentiny/tiny-robot/pulls) page of the Tiny Robot repository and click **New pull request** to submit the PR.
+- Fill in the PR description (checklist, type, related Issue, breaking change).
+- After the maintainers review and comment, update the code as needed. New commits on the branch will automatically appear in the same PR.
+- After approval, a maintainer will merge the PR.
+
+Thank you for your contribution!

CONTRIBUTING_zh.md

@@ -0,0 +1,101 @@
+# 贡献指南
+
+很高兴你有意愿参与 Tiny Robot 开源项目的贡献，参与贡献的形式有很多种，你可以根据自己的特长和兴趣选择其中的一个或多个：
+
+- 报告[新缺陷](https://github.com/opentiny/tiny-robot/issues/new?template=bug_report.yml)
+- 为[已有缺陷](https://github.com/opentiny/tiny-robot/labels/bug)提供更详细的信息，比如补充截图、提供更详细的复现步骤、提供最小可复现 demo 链接等
+- 提交 Pull Requests 修复文档中的错别字或让文档更清晰和完善
+
+当你对 Tiny Robot 逐渐熟悉之后，可以尝试做一些更有挑战的事情，比如：
+
+- 修复缺陷
+- 实现新特性
+- 完善单元测试
+- 翻译文档
+- 参与代码检视
+
+## 提交 Issue
+
+如果你在使用 Tiny Robot 组件过程中遇到问题，欢迎给我们提交 Issue。提交 Issue 之前，请先仔细阅读相关文档，确认这是一个缺陷还是尚未实现的功能。
+
+如果是一个缺陷，创建新 Issue 时选择 [Bug report](https://github.com/opentiny/tiny-robot/issues/new?template=bug_report.yml) 模板，标题遵循 `[componentName] 缺陷简述` 的格式，比如：`[bubble] 数据变化时消息内容未更新`。
+
+报告缺陷的 Issue 主要需要填写以下信息：
+
+- `@opentiny/tiny-robot` 和 `vue` 的版本号
+- 缺陷的表现，可截图辅助说明，如果有报错可贴上报错信息
+- 缺陷的复现步骤，最好能提供一个最小可复现 demo 链接
+
+如果是一个新特性，则选择 [Feature request](https://github.com/opentiny/tiny-robot/issues/new?template=feature_request.yml) 模板，标题遵循 `[componentName] 新特性简述` 的格式，比如：`[sender] 希望能支持自定义 placeholder`。
+
+新特性的 Issue 主要需要填写以下信息：
+
+- 该特性主要解决用户的什么问题
+- 该特性的 API 是什么样的
+
+## 提交 PR
+
+提交 PR 之前，请先确保你提交的内容符合 Tiny Robot 整体规划。一般已经标记为 [bug](https://github.com/opentiny/tiny-robot/labels/bug) 的 Issue 是鼓励提交 PR 的，如果你不是很确定，可以创建一个 [Discussion](https://github.com/opentiny/tiny-robot/discussions) 进行讨论。
+
+### Pull Request 规范
+
+#### Commit 信息
+
+commit 信息要以 `type(scope): 描述信息` 的形式填写，例如 `fix(components): [bubble] fix xxx bug`。
+
+1. **type**：必须是 build、chore、ci、docs、feat、fix、perf、refactor、revert、release、style、test、improvement 其中的一个。
+
+2. **scope**（可选）：包名或组件名，如 `components`、`kit`、`bubble`、`sender`、`docs` 等。
+
+#### Pull Request 的标题
+
+标题的规范与 commit 信息一样，以 `type(scope): 描述信息` 的形式填写。
+
+#### Pull Request 的描述
+
+请填写 PR 相关信息，主要包括：
+
+- PR 自检项：Commit 信息是否符合规范、是否在需要时补充了 E2E/测试用例、是否更新了文档
+- PR 类型：缺陷修复、新特性、代码格式调整、重构、文档等
+- 关联的 Issue 编号（如有）
+- 是否包含破坏性变更
+
+### 本地启动步骤
+
+- 点击 [Tiny Robot](https://github.com/opentiny/tiny-robot) 代码仓库右上角的 Fork 按钮，将上游仓库 Fork 到个人仓库
+- Clone 个人仓库到本地
+- 关联上游仓库，方便同步上游仓库最新代码
+- 在 Tiny Robot 根目录下运行 `pnpm i`，安装依赖
+- 运行 `pnpm dev`，启动文档和演练场
+- 打开浏览器访问文档和演练场
+
+```shell
+# username 为你的 GitHub 用户名，执行前请替换
+git clone git@github.com:username/tiny-robot.git
+cd tiny-robot
+
+# 关联上游仓库
+git remote add upstream git@github.com:opentiny/tiny-robot.git
+
+# 安装依赖
+pnpm i
+
+# 启动文档和演练场
+pnpm dev
+```
+
+### 提交 PR 的步骤
+
+- 请确保你已经完成本地启动中的步骤，并能正常运行项目
+- 同步上游仓库 develop 分支最新代码：`git pull upstream develop`
+- 从上游仓库 develop 分支创建新分支：`git checkout -b username/feat-xxx upstream/develop`（修复缺陷可用 `username/fix-xxx`），分支名建议为 `username/feat-xxx` / `username/fix-xxx`
+- 本地编码
+- 遵循 [Conventional Commits](https://www.conventionalcommits.org/zh-hans/v1.0.0/) 规范进行提交，不符合提交规范的 PR 将不会被合并
+- 提交到远程仓库：`git push origin branchName`
+- 打开 Tiny Robot 代码仓库的 [Pull requests](https://github.com/opentiny/tiny-robot/pulls) 链接，点击 **New pull request** 按钮提交 PR
+- 填写 PR 描述（自检项、类型、关联 Issue、是否破坏性变更）
+- 项目维护者进行 Code Review 并提出意见
+- PR 作者根据意见调整代码，请注意一个分支发起了 PR 后，后续的 commit 会自动同步，无需重新提交 PR
+- 项目维护者合并 PR
+
+贡献流程结束，感谢你的贡献！

README.md

@@ -175,13 +175,7 @@ MIT License - see [LICENSE](./LICENSE) file for details.
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
-4. Push to the branch (`git push origin feature/AmazingFeature`)
-5. Open a Pull Request
+Contributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) to understand the recommended workflow, commit message conventions, and how to submit Issues and Pull Requests.
 
 ## 📞 Support
 

README_zh.md

@@ -175,13 +175,7 @@ MIT 许可证 - 查看 [LICENSE](./LICENSE) 文件了解详情。
 
 ## 🤝 贡献
 
-欢迎贡献！请随时提交 Pull Request。
-
-1. Fork 本仓库
-2. 创建你的功能分支（`git checkout -b feature/AmazingFeature`）
-3. 提交你的更改（`git commit -m 'Add some AmazingFeature'`）
-4. 推送到分支（`git push origin feature/AmazingFeature`）
-5. 发起 Pull Request
+欢迎贡献！请阅读[贡献指南](./CONTRIBUTING_zh.md)了解推荐的工作流程、Commit 规范以及如何提交 Issue 和 Pull Request。
 
 ## 📞 支持