Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 22 additions & 31 deletions .agents/github/ISSUE.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,8 +27,15 @@ scope, is a usage/configuration/integration question, is missing required
facts, or the body would be unfiltered AI-generated text, tell the user and
**stop**. Do not create the issue. Do not file a partial issue. Do not fill
gaps with speculation.

GitHub issue/PR bodies preserve newlines. Keep paragraphs and list items
unwrapped so the page controls text wrapping.
-->

<!-- markdownlint-configure-file { "MD013": false } -->

<!-- prettier-ignore-start -->

# Agent issue

## Agent
Expand All @@ -41,23 +48,17 @@ gaps with speculation.

## User request

Quote the request the user made to the agent as faithfully as possible. Keep the
original language and line breaks. Do not rewrite, summarize, translate, or turn
it into an issue description.
Quote the request the user made to the agent as faithfully as possible. Keep the original language and line breaks. Do not rewrite, summarize, translate, or turn it into an issue description.

- Verbatim:
- Later constraints or corrections from the user (quote, or none):

## Out of scope — refuse

If the request matches any item below, tell the user this repository does not
accept it, point them to the right place when there is one, and **do not file**.
If the request matches any item below, tell the user this repository does not accept it, point them to the right place when there is one, and **do not file**.

- New subscription or Coding Plan providers must support direct integration;
providers requiring additional protocol conversion, such as Kiro, Antigravity,
or Cursor, are not accepted at this time.
- Usage, configuration, or integration questions (answer from docs and code
instead)
- New subscription or Coding Plan providers must support direct integration; providers requiring additional protocol conversion, such as Kiro, Antigravity, or Cursor, are not accepted at this time.
- Usage, configuration, or integration questions (answer from docs and code instead)

- Matched: yes/no
- If yes, what was told to the user (stop here; do not file):
Expand All @@ -68,9 +69,7 @@ If any item fails, tell the user and **stop**. Do not create the issue.

- Out of scope: no
- Usage / configuration / integration (answered instead of filing): no
- Required facts present without invention (bugs: actual behavior, impact,
frequency and applicable type fields; features: current limitation and use
case): yes
- Required facts present without invention (bugs: actual behavior, impact, frequency and applicable type fields; features: current limitation and use case): yes
- Body is short and factual; no unfiltered AI-generated text: yes
- File: yes/no
- If no, what was told to the user (stop here):
Expand All @@ -84,14 +83,10 @@ If any item fails, tell the user and **stop**. Do not create the issue.

## Usage / configuration / integration check

Search these yourself before filing. Do not send the user to "read the docs
first". If this is usage, configuration, or integration: answer the user and do
not file.
Search these yourself before filing. Do not send the user to "read the docs first". If this is usage, configuration, or integration: answer the user and do not file.

- <https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides> — what was
searched, conclusion:
- <https://github.com/Calcium-Ion/AstrLink/blob/main/CONTRIBUTING.md> — what was
searched, conclusion:
- <https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides> — what was searched, conclusion:
- <https://github.com/Calcium-Ion/AstrLink/blob/main/CONTRIBUTING.md> — what was searched, conclusion:
- README / repo docs:
- Relevant code paths and conclusion:
- Can the current version already do this? (required for feature requests):
Expand All @@ -100,25 +95,21 @@ not file.
## Environment

- AstrLink version / commit (not `latest` / `unknown`):
- Install source (repo release / GitHub Actions artifact / source build /
other):
- Install source (repo release / GitHub Actions artifact / source build / other):
- OS and architecture:
- Runtime (desktop app / standalone core / browser preview):

## Problem facts

For bug reports, record known facts and ask only for missing required facts. For
feature requests, describe the current limitation and use case; mark bug-only
fields not applicable with a reason. Do not paste unfiltered AI-generated text:
For bug reports, record known facts and ask only for missing required facts. For feature requests, describe the current limitation and use case; mark bug-only fields not applicable with a reason. Do not paste unfiltered AI-generated text:

- Actual behavior:
- Impact:
- Frequency:

## Type-specific details

Fill every applicable type. Write "not applicable" for the rest. Ask the user
for missing items; do not invent them.
Fill every applicable type. Write "not applicable" for the rest. Ask the user for missing items; do not invent them.

### Relay / API

Expand Down Expand Up @@ -173,8 +164,7 @@ for missing items; do not invent them.

## Research

Open the docs and code. Do not write "already checked" without sources. Do not
replace the fields below with unfiltered AI-generated text.
Open the docs and code. Do not write "already checked" without sources. Do not replace the fields below with unfiltered AI-generated text.

### Docs

Expand Down Expand Up @@ -203,8 +193,7 @@ replace the fields below with unfiltered AI-generated text.

- In scope for a later PR:
- Out of scope / not this repo:
- Large or directional feature? If yes, this issue is for maintainer alignment;
do not open a PR yet.
- Large or directional feature? If yes, this issue is for maintainer alignment; do not open a PR yet.

## Proposed direction

Expand All @@ -217,3 +206,5 @@ replace the fields below with unfiltered AI-generated text.
## Related

- Issues / PRs / upstream docs:

<!-- prettier-ignore-end -->
38 changes: 18 additions & 20 deletions .agents/github/PR.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,8 +39,15 @@ Then search https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides ,
https://github.com/Calcium-Ion/AstrLink/blob/main/CONTRIBUTING.md , the
README, and the code. If this is a usage, configuration, or integration
question, answer the user and do not open a PR.

GitHub issue/PR bodies preserve newlines. Keep paragraphs and list items
unwrapped so the page controls text wrapping.
-->

<!-- markdownlint-configure-file { "MD013": false } -->

<!-- prettier-ignore-start -->

# Agent pull request

## Agent
Expand All @@ -58,21 +65,16 @@ question, answer the user and do not open a PR.

## User request

Quote the request the user made to the agent as faithfully as possible. Keep the
original language and line breaks. Do not rewrite, summarize, translate, or turn
it into a PR description.
Quote the request the user made to the agent as faithfully as possible. Keep the original language and line breaks. Do not rewrite, summarize, translate, or turn it into a PR description.

- Verbatim:
- Later constraints or corrections from the user (quote, or none):

## Out of scope — refuse

If the change matches any item below, tell the user this repository does not
accept it and **do not open a PR**.
If the change matches any item below, tell the user this repository does not accept it and **do not open a PR**.

- New subscription or Coding Plan providers must support direct integration;
providers requiring additional protocol conversion, such as Kiro, Antigravity,
or Cursor, are not accepted at this time.
- New subscription or Coding Plan providers must support direct integration; providers requiring additional protocol conversion, such as Kiro, Antigravity, or Cursor, are not accepted at this time.
- Usage, configuration, or integration (answer from docs and code instead)

- Matched: yes/no
Expand All @@ -84,10 +86,8 @@ If any item fails, tell the user and **stop**. Do not open the PR.

- Out of scope: no
- Usage / configuration / integration (answered instead of opening): no
- Required issue facts present without invention (or not applicable, with a
reason): yes
- Verification is actual commands or steps and observed results, not only
`go build` or tests passed: yes
- Required issue facts present without invention (or not applicable, with a reason): yes
- Verification is actual commands or steps and observed results, not only `go build` or tests passed: yes
- Body is short and factual; no unfiltered AI-generated text: yes
- Open: yes/no
- If no, what was told to the user (stop here):
Expand All @@ -102,19 +102,16 @@ If any item fails, tell the user and **stop**. Do not open the PR.

## Issue facts

Take these from the linked issue. If a needed item is empty, ask the user that
question.
Take these from the linked issue. If a needed item is empty, ask the user that question.

- Actual behavior:
- Impact:
- Frequency:
- Applicable types and their fields (relay / cost and usage / desktop /
installation; write "not applicable" otherwise):
- Applicable types and their fields (relay / cost and usage / desktop / installation; write "not applicable" otherwise):

## Change

(what changed, why it works, grounded in the code actually touched. Short and
factual; do not paste unfiltered AI-generated text.)
(what changed, why it works, grounded in the code actually touched. Short and factual; do not paste unfiltered AI-generated text.)

## Research

Expand Down Expand Up @@ -152,8 +149,7 @@ Open them. Do not write "already checked" without sources.

## Verification

Only what was actually run. Do not state only that `go build` or tests passed.
Each item needs the command or steps and the observed result.
Only what was actually run. Do not state only that `go build` or tests passed. Each item needs the command or steps and the observed result.

- Commands and results:
- Manual steps and observed result:
Expand All @@ -173,3 +169,5 @@ Each item needs the command or steps and the observed result.
- Single focused change: yes/no (if no, why):
- Secrets included: no
- Out of scope: no

<!-- prettier-ignore-end -->
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ body:
options:
- label: "**非重复 issue:** 我已搜索现有 [Issues](https://github.com/Calcium-Ion/AstrLink/issues?q=is%3Aissue),确认目前没有类似 issue。"
required: true
- label: "**提交前必读:** 我已完整阅读上方“提交前必读”,并已查看文档 https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides、项目 README,确认这不是使用、配置或接入类问题。"
- label: "**提交前必读:** 我已完整阅读上方“提交前必读”,并已查看[文档](https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides)、项目 README,确认这不是使用、配置或接入类问题。"
required: true
- label: "**受支持版本:** 我已提供准确的版本号或 commit(不是 `latest` 或 `unknown`),并确认问题可在本仓库未修改的受支持版本中复现。"
required: true
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report_en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ body:
options:
- label: "**Non-duplicate issue:** I have searched existing [Issues](https://github.com/Calcium-Ion/AstrLink/issues?q=is%3Aissue) and confirmed there are no similar issues."
required: true
- label: "**Read this first:** I have fully read the section above, reviewed the docs at https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides and the project README, confirming this is not a usage, configuration, or integration question."
- label: "**Read this first:** I have fully read the section above, reviewed the [docs](https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides) and the project README, confirming this is not a usage, configuration, or integration question."
required: true
- label: "**Supported version:** I have provided an exact version or commit (not `latest` or `unknown`) and confirmed that the issue reproduces on an unmodified, supported version from this repository."
required: true
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ body:
options:
- label: "**非重复 issue:** 我已搜索现有 [Issues](https://github.com/Calcium-Ion/AstrLink/issues?q=is%3Aissue),确认目前没有类似 issue。"
required: true
- label: "**提交前必读:** 我已完整阅读上方“提交前必读”,并已查看文档 https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides、项目 README,确认这不是使用、配置或接入类问题,且现有版本无法满足需求。"
- label: "**提交前必读:** 我已完整阅读上方“提交前必读”,并已查看[文档](https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides)、项目 README,确认这不是使用、配置或接入类问题,且现有版本无法满足需求。"
required: true
- label: "**受支持版本:** 我已提供准确的版本号或 commit(不是 `latest` 或 `unknown`),并确认这是针对本仓库未修改的受支持版本提出的功能需求。"
required: true
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/feature_request_en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ body:
options:
- label: "**Non-duplicate issue:** I have searched existing [Issues](https://github.com/Calcium-Ion/AstrLink/issues?q=is%3Aissue) and confirmed there are no similar issues."
required: true
- label: "**Read this first:** I have fully read the section above, reviewed the docs at https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides and the project README, confirming this is not a usage, configuration, or integration question, and that the current version cannot meet my needs."
- label: "**Read this first:** I have fully read the section above, reviewed the [docs](https://github.com/Calcium-Ion/AstrLink/tree/main/docs/guides) and the project README, confirming this is not a usage, configuration, or integration question, and that the current version cannot meet my needs."
required: true
- label: "**Supported version:** I have provided an exact version or commit (not `latest` or `unknown`) and confirm this feature request is for an unmodified, supported version from this repository."
required: true
Expand Down
28 changes: 15 additions & 13 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,15 @@ Paseo, Grok, or similar): read `AGENTS.md` before selecting a template. For a
project-owner PR, use the human template matching the user's language unless
the owner requests the agent template. For other agent-created PRs, fill
`.agents/github/PR.md` as the entire PR body.

GitHub issue/PR bodies preserve newlines. Keep paragraphs and list items
unwrapped so the page controls text wrapping.
-->

<!-- markdownlint-configure-file { "MD013": false } -->

<!-- prettier-ignore-start -->

# ⚠️ 提交说明 / PR Notice

English template: `.github/PULL_REQUEST_TEMPLATE/en.md`
Expand Down Expand Up @@ -38,21 +45,16 @@ English template: `.github/PULL_REQUEST_TEMPLATE/en.md`

## 📸 运行证明 / Proof of Work

(请写明如何验证:实际命令或步骤,以及观察结果。仅声明 `go build`
通过或测试通过,不视为有效证明。UI 变更请附截图或录屏;Bug 修复请说明复现过程与修复后结果。)
(请写明如何验证:实际命令或步骤,以及观察结果。仅声明 `go build` 通过或测试通过,不视为有效证明。UI 变更请附截图或录屏;Bug 修复请说明复现过程与修复后结果。)

## ✅ 提交前检查项 / Checklist

- [ ] **人工确认:**
我已审阅并精炼全文,对其准确性与完整性负责;正文及后续评论均未粘贴未经人工过滤的大段 AI 文本。
- [ ] **非重复提交:** 我已搜索现有的
[Issues](https://github.com/Calcium-Ion/AstrLink/issues) 与
[PRs](https://github.com/Calcium-Ion/AstrLink/pulls),确认不是重复提交。
- [ ] **新功能关联 Issue:** 若此 PR 标记为
`New feature`,我已关联对应 Issue;若尚无 Issue,我已先自行创建。
- [ ] **事前沟通:**
若改动较大或涉及方向性变更,已在关联 Issue 中与维护者沟通并达成一致。
- [ ] **人工确认:** 我已审阅并精炼全文,对其准确性与完整性负责;正文及后续评论均未粘贴未经人工过滤的大段 AI 文本。
- [ ] **非重复提交:** 我已搜索现有的 [Issues](https://github.com/Calcium-Ion/AstrLink/issues) 与 [PRs](https://github.com/Calcium-Ion/AstrLink/pulls),确认不是重复提交。
- [ ] **新功能关联 Issue:** 若此 PR 标记为 `New feature`,我已关联对应 Issue;若尚无 Issue,我已先自行创建。
- [ ] **事前沟通:** 若改动较大或涉及方向性变更,已在关联 Issue 中与维护者沟通并达成一致。
- [ ] **范围聚焦:** 本 PR 为一项聚焦改动,未包含无关代码。
- [ ] **本地验证:** 已按变更路径实际验证,并写明命令与观察结果。仅声明
`go build` 通过或测试通过,不视为有效证明。
- [ ] **本地验证:** 已按变更路径实际验证,并写明命令与观察结果。仅声明 `go build` 通过或测试通过,不视为有效证明。
- [ ] **安全合规:** 代码中无敏感凭据,且符合项目代码规范。

<!-- prettier-ignore-end -->
Loading
Loading