Repository navigation
docs(chapters): 写第十章《afk 离席模式》并更新路线图 - #11
Merged
Merged
Conversation
jasontopia
force-pushed
the
fm/learn-fm-ch10
branch
from
September 26, 2026 22:30
a9706f1 to
43c1bef
Compare
jasontopia
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Intent
继续 Learn FirstMate 教程，写第十章。前九章已写完或正在走质检流水线。README 的学习路线图里，第十章的定位是：船长离开键盘期间谁接手监督，离席期间它敢自己做什么、必须留着等船长什么，以及船长回来时怎么交接回来。
What Changed
chapters/10-afk-mode.md, a new tutorial chapter covering AFK mode: who supervises the crew while the captain is away, why/afkitself takes effect immediately without a confirmation gate, what the daemon may act on under standing authority versus what always still waits for the captain (merges, destructive/irreversible actions, security-sensitive choices), and how the return handoff is detected and reported before ordinary messages are processed.state/.afk-contractorstate/.afkor running/afk, plus expected answers and a git-diff-based verification method.README.md's chapter roadmap: link chapter 10 to the new file and flip its status from "待写" to "已写".🤖 Generated with Claude Code
Risk Assessment
✅ Low: Documentation-only change (one new chapter file plus a one-line README status/link update) that passes the repo's link-integrity and formatting-hygiene gate, follows established chapter conventions, satisfies all four required intent points, and introduces no code, state, or executable behavior.
Testing
This is a pure documentation repo (per AGENTS.md, no build/test/runtime surface) with a docs-only change: a new chapter file plus a one-line README roadmap update. The repo's only check,
python3 scripts/check-docs.py, already passed as baseline and was re-confirmed. No live-exercisable product surface exists for this test phase to drive; all three derived scenarios (rendered-link check, source-quote fidelity against the captain-private FirstMate checkout, and a live FirstMate AFK recap exercise) require tooling not available here. This matches round 1's assessment, which the user already chose to ignore rather than dispute, and the diff introduces no new surface beyond what round 1 covered, so that finding is not re-raised./afk-skill line in chapter 10 (supervision takeover,/afkas immediate go, non-expanding red lines, return/catch-up gate) matches the authoritative FirstMate source verbat…Pipeline
Updates from git push no-mistakes
✅ **intent** - passed
✅ No issues found.
✅ **Rebase** - passed
✅ No issues found.
✅ **Review** - passed
✅ No issues found.
✅ No issues found.
/afk-skill line in chapter 10 (daemon supervision takeover,/afkas immediate go, red-line non-expansion, return/catch-up gate) matches the authoritative source text verbatim: The local FirstMate checkout (AGENTS.md Supervision protocol / Away-mode stub, and the/afkskill) is captain-private and lives outside this git worktree at a path this repo deliberately never records; this test phase has no path to it and is instructed not to search the filesystem for it, so quote fidelity cannot be verified live here; A captain runs the chapter's read-only recap exercise against a live FirstMate primary session and firstmate correctly answers all four AFK questions without mutating any state/.afk* files: Requires an interactive, live FirstMate primary session (the actual agent under test, which is a separate installed product) which is not available as a tool, binary, or credential in this sandbox and cannot be started here/afk-skill line in chapter 10 (daemon supervision takeover,/afkas immediate go, red-line non-expansion, return/catch-up gate) matches the authoritative source text verbati…/afkskill) is captain-private and lives outside this git worktree at a path this repo deliberately never recor…python3 scripts/check-docs.pypython3 scripts/check-docs.py (baseline, already run successfully on target commit a9706f1)Manual read-through of chapters/10-afk-mode.md against README.md roadmap table for numbering/link/status consistency with prior chapters (1, 2, 4, 6)/afk-skill line in chapter 10 (supervision takeover,/afkas immediate go, non-expanding red lines, return/catch-up gate) matches the authoritative FirstMate source verbatim: The local FirstMate checkout (AGENTS.md Supervision protocol / Away-mode stub, and the /afk skill) is captain-private and lives outside this worktree at a path this repo deliberately never records; this test phase has no path to it and is instructed not to search the filesystem for it; A captain runs chapter 10's read-only recap exercise against a live FirstMate primary session and firstmate answers all four AFK questions without mutating any .afk* state: Requires an interactive, live FirstMate primary session (a separate installed product) not available as a tool/binary/credential in this sandboxLive validation:⚠️ no-surface - 0 of 3 scenarios driven live against the product
/afk-skill line in chapter 10 (supervision takeover,/afkas immediate go, non-expanding red lines, return/catch-up gate) matches the authoritative FirstMate source verbat…python3 scripts/check-docs.pypython3 scripts/check-docs.py (baseline, already run)git diff --stat e9c56bc..43c1bef to confirm change scopegit diff on README.md to confirm the roadmap link/status update✅ **Document** - passed
✅ No issues found.
✅ No issues found.
✅ **Lint** - passed
✅ No issues found.
✅ No issues found.
✅ **Push** - passed
✅ No issues found.
✅ No issues found.