Auto Coder

Auto Coder

One trigger completes read spec → find task → code → test → persist progress.

Optional modifiers: append a task ID (e.g. auto code B2) to target a specific task, or --no-commit to skip git commit.

Pipeline

Sync Spec → Find Task → Implement → Test (≤3 fix rounds) → Persist

Pause only at the end for commit confirmation. Run everything else autonomously.

⚠️ CRITICAL: Activate .venv before ANY python/pytest command (idempotent, re-run if unsure).

• Windows: .\.venv\Scripts\Activate.ps1
• macOS/Linux: source .venv/bin/activate

Reference Map

All files under .github/skills/auto-coder/references/:

1. Sync Spec

python .github/skills/auto-coder/scripts/sync_spec.py

Then read the schedule file to get task statuses:

• Read .github/skills/auto-coder/references/06-schedule.md

Task markers:

2. Find Task

Pick the first IN_PROGRESS task, then the first NOT_STARTED. If user specified a task ID, use that directly.

Quick-check predecessor artifacts exist (file-level only). On mismatch, log a warning and continue — only stop if the target task itself is blocked.

3. Implement

1. Read relevant spec from .github/skills/auto-coder/references/:

   • Architecture: 05-architecture.md
   • Tech details: 03-tech-stack.md
   • Testing conventions: 04-testing.md

2. Extract from spec: inputs/outputs, design principles (Pluggable? Config-driven? Factory?), file list, acceptance criteria.

3. Plan files to create/modify before writing any code.

4. Code — project-specific rules:

   • Treat spec as single source of truth
   • Use config/settings.yaml values, never hardcode
   • Match existing codebase patterns and style

5. Write tests alongside code:

   • Place in tests/unit/ or tests/integration/ per spec
   • Mock external deps in unit tests

6. Self-review before running tests: verify all planned files exist and tests import correctly.

4. Test & Auto-Fix

Round 0..2:
  Run pytest on relevant test file
  If pass → go to step 5
  If fail → analyze error, apply fix, re-run

Round 3 still failing → STOP, show failure report to user

5. Persist

1. Update DEV_SPEC.md (global file): change task marker [ ] → [x]
2. Re-sync: python .github/skills/auto-coder/scripts/sync_spec.py --force
3. Show summary & ask:

✅ [A3] 配置加载与校验 — done
   Files: src/core/settings.py, tests/unit/test_settings.py
   Tests: 8/8 passed
   Commit: feat(config): [A3] implement config loader

   "commit" → git add + commit
   "skip"   → end
   "next"   → commit + start next task

On "next", loop back to step 1 and start the next task.