mirror of
https://github.com/CJackHwang/ds2api.git
synced 2026-05-03 16:05:26 +08:00
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# AGENTS.md
|
|
|
|
These rules apply to all agent-made changes in this repository.
|
|
|
|
## PR Gate
|
|
|
|
- Before opening or updating a PR, run the same local gates as `.github/workflows/quality-gates.yml`.
|
|
- Required commands:
|
|
- `./scripts/lint.sh`
|
|
- `./tests/scripts/check-refactor-line-gate.sh`
|
|
- `./tests/scripts/run-unit-all.sh`
|
|
- `npm run build --prefix webui`
|
|
|
|
## Go Lint Rules
|
|
|
|
- Run `gofmt -w` on every changed Go file before commit or push.
|
|
- Do not ignore error returns from I/O-style cleanup calls such as `Close`, `Flush`, `Sync`, or similar methods.
|
|
- If a cleanup error cannot be returned, log it explicitly.
|
|
|
|
## Change Scope
|
|
|
|
- Keep changes additive and tightly scoped to the requested feature or bugfix.
|
|
- Do not mix unrelated refactors into feature PRs unless they are required to make the change pass gates.
|
|
|
|
## Documentation Sync
|
|
|
|
- When business logic or user-visible behavior changes, update the corresponding documentation in the same change.
|
|
- `docs/prompt-compatibility.md` is the source-of-truth document for the “API -> pure-text web-chat context” compatibility flow.
|
|
- If a change affects message normalization, tool prompt injection, prompt-visible tool history, file/reference handling, history split, or completion payload assembly, update `docs/prompt-compatibility.md` in the same change.
|