كيف يمكن لوكيل البرمجة إصلاح خلل وتشغيل الاختبارات والالتزام بالتغييرات مع بقائك في التحكم؟

Question

Accepted Answer

يمكن لـ **agent** البرمجة أن يقود إصلاح الخلل من البداية إلى النهاية — إعادة الإنتاج والتحديد والإصلاح والتحقق والالتزام — لكنك تبقى في التحكم من خلال تقييد الحلقة بـ **الأذونات المحدودة والموافقة البشرية والخطوات الصغيرة القابلة للعكس**. الوكيل يقوم بالكتابة؛ أنت تقرر ما الذي يصل فعلاً إلى الخادم.

## الحلقة

```text
1. REPRODUCE  → write/run a failing test that demonstrates the bug (red)
2. LOCATE     → search the codebase, read the relevant files, form a hypothesis
3. PROPOSE    → draft a minimal fix (you can review the plan before any edit)
4. VERIFY     → run tests + lint/typecheck → fix is proven by the test going green
5. REVIEW     → show the DIFF for your approval (nothing committed yet)
6. COMMIT     → only after approval, on a branch, with a clear message
```

الفكرة الأساسية هي **التحقق الموجه بالاختبار**: الوكيل لا يدّعي "تم الإصلاح" — بل يثبته بجعل الاختبار الفاشل ينجح. الاختبار الفاشل من الخطوة 1 هو الإشارة الموضوعية التي تثبت أن التغيير نجح.

## آليات التحكم

```text
- SCOPED PERMISSIONS → allowlist safe commands (test, lint); prompt for the rest
- APPROVAL GATES     → human confirms destructive/irreversible actions + the final commit
- SMALL STEPS        → one focused change at a time → easy to review and revert
- BRANCH / WORKTREE   → work isolated from main; throw it away if it goes wrong
- DIFF REVIEW        → read the actual diff before commit, not just the agent's summary
```

```bash
# The agent runs the suite itself and reports the result before proposing a commit
npm test -- --runInBand   # red before the fix, green after → objective verification
git diff                  # you review every line that will be committed
```

العمل في **فرع أو git worktree** يعني أن أسوأ الحالات هي `git checkout main` — التجربة لم تمس حالة العمل الخاصة بك. الالتزامات الصغيرة القابلة للعكس تجعل كل خطوة سهلة الفحص والتراجع.

## لماذا هذا مهم

تحول البرمجة الوكيلة بك من كتابة كل سطر إلى **المراجعة والتوجيه**. الميزة حقيقية، لكن الخطر أيضاً حقيقي — احتمالية أن يرسل الوكيل بثقة تغييراً خاطئاً أو مدمراً. إبقاء بوابة موافقة بشرية قبل الالتزام، التحقق من خلال الاختبارات بدلاً من الثقة في النصوص، وعزل العمل في فرع يتيح لك الاستفادة من سرعة الأتمتة مع البقاء الشخص الذي يقرر ما يصل إلى `main`.