chore: sync fork main with upstream OpenHands/software-agent-sdk

.agents/skills/debug-test-examples-workflow/SKILL.md

@@ -10,7 +10,6 @@ description: Guide for debugging failing example tests in the `test-examples` la
 The `run-examples.yml` workflow runs example scripts from `examples/` directory. Triggers:
 - Adding `test-examples` label to a PR
 - Manual workflow dispatch
-- Scheduled nightly runs
 
 ## Debugging Steps
 

.github/ISSUE_TEMPLATE/bug_template.yml

@@ -62,6 +62,16 @@ body:
               5. Error appears
       validations:
           required: false
+    - type: textarea
+      id: acceptance-criteria
+      attributes:
+          label: Acceptance Criteria
+          description: List the testable checklist item(s) that would prove this bug is fixed.
+          placeholder: |
+              - [ ] The reported error no longer occurs
+              - [ ] The fix works with a fresh agent instance
+      validations:
+          required: false
 
     - type: input
       id: installation

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -31,15 +31,26 @@ body:
           required: true
 
     - type: textarea
-      id: proposed-solution
+      id: desired-behavior
       attributes:
-          label: Proposed Solution
+          label: Desired Behavior
           description: Describe your ideal solution. What should this feature do? How should it work?
           placeholder: |
               Example - Add a StateManager class that allows saving and loading agent state to/from disk or database. Provide methods like save_state(), load_state(), and clear_state(). Support multiple backend options (JSON files, SQLite, Redis, etc.).
       validations:
           required: true
 
+    - type: textarea
+      id: acceptance-criteria
+      attributes:
+          label: Acceptance Criteria
+          description: List the testable checklist item(s) that would prove this feature is complete.
+          placeholder: |
+              - [ ] Saving agent state to disk works end-to-end
+              - [ ] A new Agent restores state from a previously saved snapshot
+      validations:
+          required: true
+
     - type: textarea
       id: alternatives
       attributes:

.github/PULL_REQUEST_TEMPLATE.md

@@ -48,6 +48,20 @@ Provide a video or screenshots of testing your PR. e.g. you added a new feature
 
 -->
 
+## Design Doc
+
+<!--
+Optional, encouraged for non-trivial PRs. Add a self-contained HTML design doc under the
+temporary `.pr/` directory (e.g. `.pr/design.html`) covering the code/API design and a
+before/after of your change, then link it here via htmlpreview so reviewers see it at a glance:
+
+  https://htmlpreview.github.io/?https://github.com/<your-fork>/<repo>/blob/<your-branch>/.pr/design.html
+
+The `.pr/` directory is temporary — it is removed automatically (on approval for
+same-repository PRs, right after merge for fork PRs). See CONTRIBUTING.md ("Design doc for
+non-trivial PRs") for details.
+-->
+
 ## Type
 
 - [ ] Bug fix