Commit graph

14 commits

Author SHA1 Message Date
gui-yue
1baf1aca5a
Follow up PR #265: refine chapters, diagrams, and add S20 (#283)
Some checks are pending
CI / build (push) Waiting to run
Test / python-smoke (push) Waiting to run
Test / web-build (push) Waiting to run
* feat: s01-s14 docs quality overhaul — tool pipeline, single-agent, knowledge & resilience

Rewrite code.py and README (zh/en/ja) for s01-s14, each chapter building
incrementally on the previous. Key fixes across chapters:

- s01-s04: agent loop, tool dispatch, permission pipeline, hooks
- s05-s08: todo write, subagent, skill loading, context compact
- s09-s11: memory system, system prompt assembly, error recovery
- s12-s14: task graph, background tasks, cron scheduler

All chapters CC source-verified. Code inherits fixes forward (PROMPT_SECTIONS,
json.dumps cache, real-state context, can_start dep protection, etc.).

* feat: s15-s19 docs quality overhaul — multi-agent platform: teams, protocols, autonomy, worktree, MCP tools

Rewrite code.py and README (zh/en/ja) for s15-s19, the multi-agent platform
chapters. Each chapter inherits all previous fixes and adds one mechanism:

- s15: agent teams (TeamCreate, teammate threads, shared task list)
- s16: team protocols (plan approval, shutdown handshake, consume_inbox)
- s17: autonomous agents (idle polling, auto-claim, consume_lead_inbox)
- s18: worktree isolation (git worktree, bind_task, cwd switching, safety)
- s19: MCP tools (MCPClient, normalize_mcp_name, assemble_tool_pool, no cache)

All appendix source code references verified against CC source. Config priority
corrected: claude.ai < plugin < user < project < local.

* fix: 5 regressions across s05-s19 — glob safety, todo validation, memory extraction, protocol types, dep crash

- s05-s09: glob results now filter with is_relative_to(WORKDIR) (inherited from s02)
- s06-s08: todo_write validates content/status required fields (inherited from s05)
- s09: extract_memories uses pre-compression snapshot instead of compacted messages
- s16: submit_plan docstring clarifies protocol-only (not code-level gate)
- s17-s19: match_response restores type mismatch validation (from s16)
- s17-s19: claim_task deps list handles missing dep files without crashing

* fix: s12 Todo V2 logic reversal, s14/s15 cron range validation, s18/s19 worktree name validation

- s12 README (zh/en/ja): fix Todo V2 direction — interactive defaults to Task,
  non-interactive/SDK defaults to TodoWrite. Fix env var name to
  CLAUDE_CODE_ENABLE_TASKS (not TODO_V2).
- s14/s15: add _validate_cron_field with per-field range checks (minute 0-59,
  hour 0-23, dom 1-31, month 1-12, dow 0-6), step > 0, range lo <= hi.
  Replace old try/except validation that only caught exceptions.
- s18/s19: add validate_worktree_name() to remove_worktree and keep_worktree,
  not just create_worktree.

* fix: align s16-s19 teaching tool consistency

* fix pr265 chapter diagrams

* Add comprehensive s20 harness chapter

* Fix chapter smoke test regressions

* Clarify README tutorial track transition

---------

Co-authored-by: Haoran <bill-billion@outlook.com>
2026-05-20 21:45:38 +08:00
comey246
92b50e5cd2
Fix typo in zh/s04-subagent.md (#163)
"胖" just means fat, "臃肿" means size and content very much
2026-04-01 20:59:52 +08:00
Xinlu Lai
e4edd82c8c
Merge pull request #88 from wbxl2000/main
优化中文翻译: 保留英文专有名词
2026-03-30 00:04:18 +08:00
CrazyBoyM
5f2b0f205e Simplify task graph to single-source blockedBy (PR #127)
Remove unused blocks field and add_blocks parameter. The LLM never
used add_blocks in practice, making it dead code that taught a
misleading bidirectional pattern. Replace with remove_blocked_by
for dependency rewiring. Single-source-of-truth with blockedBy only.
2026-03-29 23:56:39 +08:00
bear
950378a29f fix: remove hardcoded assistant acks after system message injection
s08/s09/s10/s11/s_full inject background-results and inbox as user
  messages before LLM calls. The paired hardcoded assistant "Noted..."
  responses were unnecessary — consecutive user messages work fine and
  the fake acks added noise with no functional value.

  Affected: agents/s08, s09, s10, s11, s_full + docs (zh/en/ja s08, s09)
2026-03-23 20:24:42 +08:00
bear
1ffdf3d739 auto_compact llm request error fixed 2026-03-23 17:04:17 +08:00
copilot-swe-agent[bot]
4fc9ff65a3 Merge remote-tracking branch 'upstream/main' into copilot/resolve-code-branch-conflicts
# Conflicts:
#	README-zh.md
#	docs/zh/s01-the-agent-loop.md
#	docs/zh/s04-subagent.md
2026-03-19 03:00:25 +00:00
CrazyBoyM
a9c71002d2 the model is the agent, the code is the harness
Comprehensive rewrite establishing the harness engineering narrative
across the entire repository.

README (EN/ZH/JA): added "The Model IS the Agent" manifesto with
historical proof (DQN, OpenAI Five, AlphaStar, Tencent Jueyu),
"What an Agent Is NOT" critique, harness engineer role definition,
"Why Claude Code" as masterclass in harness design, and universe
vision. Consistent framing: model = driver, harness = vehicle.

docs (36 files, 3 languages): injected one-line "Harness layer"
callout after the motto in every session document (s01-s12).

agents (13 Python files): added harness framing comment before
each module docstring.

skills/agent-philosophy.md: full rewrite aligned with harness
narrative.
2026-03-18 01:19:34 +08:00
copilot-swe-agent[bot]
13409478ef Optimize Chinese translations: preserve English proper nouns (Skills, Agent, Subagent, Context Compact, etc.)
Co-authored-by: wbxl2000 <57169560+wbxl2000@users.noreply.github.com>
2026-03-16 14:23:59 +00:00
CrazyBoyM
dbffe7c8d0 fix: address community issues #37 #30 #36
- s03: inject reminder into tool_result instead of mutating history (#37)
- s05: SkillLoader uses rglob("SKILL.md") + frontmatter name priority,
  matching Agent Skills standard (#30, PR #34)
- CI: upgrade actions/checkout and actions/setup-node to v6 (#36)
- docs: update s05 skill directory structure in all 3 languages
2026-02-28 00:09:57 +08:00
CrazyBoyM
4f39ee4512 fix session doc 2026-02-27 02:19:54 +08:00
CrazyBoyM
665831c774 better doc 2026-02-27 01:11:57 +08:00
CrazyBoyM
aea8844bac add worktree & up task、teammate etc 2026-02-24 01:44:44 +08:00
CrazyBoyM
c6a27ef1d7 feat: build an AI agent from 0 to 1 -- 11 progressive sessions
- 11 sessions from basic agent loop to autonomous teams
- Python MVP implementations for each session
- Mental-model-first docs in en/zh/ja
- Interactive web platform with step-through visualizations
- Incremental architecture: each session adds one mechanism
2026-02-21 17:02:43 +08:00