qwen-code/.github
Shaojin Wen 7e56bd0657
docs(autofix): add an operator guide for /takeover from N (#9622)
* docs(autofix): add an operator guide for `/takeover from N`

`qwen-autofix.md` records why each line of the workflow is the way it is,
indexed by code site — af-007 for the `from N` parser, af-016 for the
marker it writes. That answers "why is this code shaped like this", but a
maintainer deciding whether to seed a takeover has a different question:
what do I type, what number do I pick, and what happens next. Nothing
answered that.

This adds a task-oriented sibling guide covering the problem the seed
solves, how to choose N (with a table of remaining suggestion budget per
seed), the three semantics that surprise people — the seed is a floor for
an empty window rather than an offset added to every round, it dies with
its counting window so `/retry` and a bare `/takeover` both return the
counter to zero, and it is clamped strictly below the round cap while the
audit record still cites the number that was typed — and the two things
it deliberately does not do: seed the growth brake, or change what
Critical-only keeps flowing.

Every row of the accepted/rejected command table was produced by
replaying the merged parser fragment verbatim, so the doc records
observed behaviour rather than intent: `from 04` and `from 08` seed 4 and
8 rather than tripping octal, `from 0` engages as the explicit no-seed
spelling, and `stop from 4`, a doubled space, a 3-digit number, and a
prefixed or suffixed body all fail closed to no label and no seed.

Cross-linked both ways: the design record's preamble now points at
task-oriented guides, and the parser keeps its af-007 pointer with an
operator-guide line beside it. The workflow grows by 64 bytes, which the
size gate covers.

* docs(autofix): align the round-seed guide with the workflow behavior

Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>

---------

Co-authored-by: qwen-code-dev-bot <qwen-code-dev-bot@users.noreply.github.com>
Co-authored-by: Qwen-Coder <qwen-coder@alibabacloud.com>
2026-08-21 07:44:59 +00:00
..
actions ci: run Windows merge queue tests on ECS (#8386) 2026-08-05 12:14:42 +00:00
assets fix(cli): echo resume command to main screen on exit (#8455) 2026-08-08 04:29:31 +00:00
ISSUE_TEMPLATE chore: re-organize labels for better triage results (#819) 2025-10-17 19:49:11 +08:00
scripts fix(autofix): bind the sandbox image to its pulled digest (#9527) 2026-08-21 06:46:52 +00:00
workflows docs(autofix): add an operator guide for /takeover from N (#9622) 2026-08-21 07:44:59 +00:00
actionlint.yaml ci: add Windows runner smoke test (#8008) 2026-07-29 08:44:36 +00:00
CODEOWNERS chore(ci): Disable install scripts in release CI and guard security-checks workflow (#9577) 2026-08-21 03:48:03 +00:00
dependabot.yml Limit dependabot PRs to security updates (#6657) 2025-08-20 22:24:43 +00:00
issue-owners.json feat(ci): auto-assign issues to area owners from labels (#8668) 2026-08-08 23:01:03 +00:00
pull_request_template.md docs(agents,pr-template): add Working Principles and restructure PR template (#4496) 2026-05-25 19:15:35 +08:00
release.yml ci: auto-skip internal CI changes in release notes (#7251) 2026-07-20 11:10:55 +00:00
spam-blocklist.txt ci: auto-minimize comments from org-blocked users (#7899) 2026-07-29 23:37:42 +00:00