first commit

文档润色流和知识库构建流/claude-scholar/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,104 @@
+name: Bug report
+description: Report an installation, runtime, compatibility, or behavior bug in Claude Scholar.
+title: "[Bug]: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug.
+
+        Please keep this report concrete. The fastest bug reports for Claude Scholar include:
+        - the client and branch,
+        - the exact command or prompt,
+        - the full warning or traceback,
+        - and a short reproduction path.
+
+  - type: checkboxes
+    id: preflight
+    attributes:
+      label: Before submitting
+      options:
+        - label: I checked the README / setup docs for the branch I am using.
+          required: true
+        - label: I included the exact error text instead of paraphrasing it.
+          required: true
+
+  - type: dropdown
+    id: client
+    attributes:
+      label: Client
+      options:
+        - Claude Code
+        - Codex
+        - OpenCode
+        - Other / unsure
+    validations:
+      required: true
+
+  - type: dropdown
+    id: branch
+    attributes:
+      label: Branch
+      options:
+        - main
+        - codex
+        - opencode
+        - unsure
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Include only the details that matter for reproducing the issue.
+      placeholder: |
+        OS: macOS 15.4
+        Shell: zsh
+        Install mode: scripts/setup.sh
+        Client version: Claude Code 2.1.42
+    validations:
+      required: true
+
+  - type: textarea
+    id: exact_action
+    attributes:
+      label: Exact command or exact prompt
+      placeholder: |
+        bash scripts/setup.sh
+
+        or
+
+        Review my Zotero collection on brain foundation models.
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual_behavior
+    attributes:
+      label: Actual behavior
+      description: Describe what happened, then paste the full error or terminal output below.
+    validations:
+      required: true
+
+  - type: textarea
+    id: error_output
+    attributes:
+      label: Full error / terminal output
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction_steps
+    attributes:
+      label: Reproduction steps
+      placeholder: |
+        1. Clone branch ...
+        2. Run ...
+        3. Start client ...
+        4. Observe ...
+    validations:
+      required: true

文档润色流和知识库构建流/claude-scholar/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Claude Scholar setup docs
+    url: https://github.com/Galaxy-Dawn/claude-scholar#quick-start
+    about: Please check the Quick Start section before opening an installation issue.
+  - name: Claude Scholar branch guide
+    url: https://github.com/Galaxy-Dawn/claude-scholar#why-claude-scholar
+    about: Confirm that you are using the correct branch for Claude Code, Codex, or OpenCode.

文档润色流和知识库构建流/claude-scholar/.github/ISSUE_TEMPLATE/docs_problem.yml

@@ -0,0 +1,65 @@
+name: Documentation problem
+description: Report outdated, inconsistent, unclear, or incorrect documentation.
+title: "[Docs]: "
+labels:
+  - documentation
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template for documentation issues such as:
+        - wrong commands or paths,
+        - branch-specific instructions that drifted,
+        - unclear wording,
+        - or setup docs that no longer match actual behavior.
+
+  - type: dropdown
+    id: doc_surface
+    attributes:
+      label: Affected document
+      options:
+        - README
+        - MCP_SETUP
+        - OBSIDIAN_SETUP
+        - CLAUDE / AGENTS docs
+        - Skill documentation
+        - Installer instructions
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: branch
+    attributes:
+      label: Affected branch
+      options:
+        - main
+        - codex
+        - opencode
+        - multiple branches
+        - unsure
+    validations:
+      required: true
+
+  - type: textarea
+    id: location
+    attributes:
+      label: Problematic location
+      description: Quote the current text, command, path, or section title.
+    validations:
+      required: true
+
+  - type: textarea
+    id: issue
+    attributes:
+      label: What is wrong
+    validations:
+      required: true
+
+  - type: textarea
+    id: suggested_fix
+    attributes:
+      label: Suggested fix
+      description: If you already know the corrected wording or command, propose it here.
+    validations:
+      required: false

文档润色流和知识库构建流/claude-scholar/.github/ISSUE_TEMPLATE/workflow_gap.yml

@@ -0,0 +1,60 @@
+name: Workflow gap
+description: Report a missing, weak, or awkward handoff in a research workflow, even if nothing is technically broken.
+title: "[Workflow gap]: "
+labels:
+  - workflow
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this template when Claude Scholar technically works, but the workflow is still incomplete.
+
+        Examples:
+        - the workflow stops too early,
+        - a handoff between stages is weak,
+        - the current output is not enough for real research use,
+        - or an expected research step is missing.
+
+  - type: dropdown
+    id: stage
+    attributes:
+      label: Workflow stage
+      options:
+        - Ideation
+        - Literature review
+        - Zotero / paper intake
+        - Obsidian / project memory
+        - Experiment tracking
+        - Results analysis
+        - Publication artifacts (figures / tables)
+        - Results reporting
+        - Paper writing
+        - Rebuttal / review response
+        - Post-acceptance
+        - Cross-stage handoff
+    validations:
+      required: true
+
+  - type: textarea
+    id: gap
+    attributes:
+      label: Current gap
+      description: What is missing, awkward, or incomplete in the current workflow?
+    validations:
+      required: true
+
+  - type: textarea
+    id: desired_outcome
+    attributes:
+      label: Desired outcome
+      description: What should Claude Scholar help you produce, decide, or hand off here?
+    validations:
+      required: true
+
+  - type: textarea
+    id: example
+    attributes:
+      label: Concrete example
+      description: Provide a representative prompt, artifact path, or research situation.
+    validations:
+      required: true