فاصلهی بین «تمام شد» و «ثبت شد»
ایجنتی که از طریق MCP کار میکند، یک تسک را همانطور که یک آدم میبندد میبندد: علامتش میزند تمامشده، یا — رایجتر، چون کار یک ایجنت باید همچنان توسط یک آدم تأیید شود — تسک را برای بازبینی میفرستد و جلسهاش را میبندد. درست همان لحظه، سه چیز هنوز درست است که یک ساعت بعد دیگر درست نیست:
- ایجنت هنوز به یاد دارد چرا هر انتخابی را در تسک کرده.
- تغییرات محلی ممکن است کامیت و پوش شده باشند یا نشده باشند.
- حتی اگر شده باشند، ممکن است کامیت به تسکی که متعلق به آن است اشاره نکند.
هیچچیز مجبورشان نمیکند حل شوند. پس بیشتر وقتها حل نمیشوند — نه چون کسی تصمیم گرفته نادیدهشان بگیرد، بلکه چون هیچچیز در حلقهٔ کار نپرسیده است.
WKFGo چه کاری برایش میکند
سه ابزار MCP کار روی یک تسک را میبندند: mark_done، submit_for_review و end_work. از این نسخه به بعد، پاسخ هرکدام میتواند دو یادآوری ساختیافته به ایجنت متصل برگرداند:
docReminder — همیشه وقتی تسکی درگیر است حاضر است. به ایجنت دستور میدهد که با زبان ساده بپرسد آیا کاری که تازه انجام شده بهعنوان صفحهٔ ویکی با create_wiki_page نوشته شود: رویکردی که گرفته شده، تصمیمهایی که گرفته شده، هرچیزی که نفر بعدی — آدم یا ایجنت — در غیر این صورت باید از صفر کشفش کند.
gitReminder — وقتی پروژه یک مخزن گیت متصل دارد حاضر است. به ایجنت دستور میدهد بپرسد آیا همین حالا کامیت و پوش شود (با TASK-<id> در پیام، تا وبهوک خودکار وصلش کند)، و جدا از آن، آیا یک کامیت از قبل پوششده بعداً با attach_commit وصل شود.
هر دو به شکل دستور برای پرسیدن نوشته شدهاند، نه انجام دادن. دستورالعملهای سیستمی ایجنت صریح است: بدون پرسیدن نه صفحهٔ ویکی بنویس نه دست به گیت بزن — منتظر یک بله بمان.
چرا «پرسیدن» و نه «همیشه انجام دادن»
نسخهٔ قبلی همین ایده فقط به ایجنت میگفت به کاربر یادآوری کند کامیت کند. این یکطرفه بود — یک اطلاعیه، نه یک نقطهٔ تصمیم. دو چیز تغییر کرد:
نوشتن خاموش از ننوشتن هم بدتر است. صفحهٔ ویکیای که ایجنت خودش تصمیم گرفته منتشر کند، به نام شما، بدون بازبینی شما، یک مسئولیت است، نه مستندسازی. ارزش خروجی create_wiki_page کاملاً به این بستگی دارد که کسی واقعاً خواسته باشد نوشته شود.
کامیت کردن از طرف کسی، واقعیتهایی را فرض میکند که سرور ندارد. WKFGo نمیداند شما وسط یک آزمایش هستید، تغییر فقط نصفه است، یا ترجیح میدهید پنج کامیت را بعداً به یکی squash کنید. فقط میداند تسکی بسته شده و پروژه گیت دارد — این یک نشانه برای پرسیدن است، نه چراغ سبز برای انجام دادن.
این در عمل چطور است
کلود کد یا کرسر را با MCP به WKFGo وصل کنید (به راهنمای کامل راهاندازی نگاه کنید). یک تسک را عادی کار کنید: start_work ← تغییر بدهید ← submit_for_review. پاسخ فراخوانی ابزار حالا چیزی شبیه این دارد:
{
"ok": true,
"docReminder": { "askUser": true, "message": "از کاربر بپرس آیا این کار بهصورت صفحهٔ ویکی نوشته شود…" },
"gitReminder": { "askUser": true, "action": "ask_user_to_commit", "commitRef": "TASK-442", "message": "از کاربر بپرس آیا همین حالا کامیت و پوش شود…" }
}
ایجنت متصل، طبق دستورالعملهای سرور WKFGo، این را به سه سؤال واقعی در چت تبدیل میکند — به زبان خودتان:
۱. «میخواهی کاری که تازه کردم را بهصورت صفحهٔ ویکی بنویسم؟» ۲. «آمادهای کامیت و پوش کنم؟ از TASK-442 در پیام استفاده میکنم.» ۳. «از قبل پوش کردهای — میخواهی آن کامیت را به تسک وصل کنم؟»
به هرکدام بله بگویید، ایجنت ابزار متناظر را صدا میزند (create_wiki_page، یک git commit/push محلی، یا attach_commit). نه بگویید، هیچچیز اتفاق نمیافتد — خود یادآوری، کل ویژگی بود.
چه کاری انجام نمیدهد
مستندات را برای شما نمینویسد، دربارهٔ خوببودن پیام کامیت شما قضاوت نمیکند، و در هر فراخوانی ابزار مزاحم نمیشود — فقط در آن سه نقطهای که کار روی یک تسک واقعاً به پایان میرسد. و نیازی به اتصال گیت هم ندارد؛ سؤال مستندسازی خودش جدا فعال میشود.
سؤالات متداول
با هر کلاینت MCP کار میکند؟
بله — هر کلاینتی که توضیحات ابزار و دستورالعملهای سرور را میخواند و دنبال میکند، از جمله کلود کد و کرسر.
اگر به مستندسازی نه بگویم چه میشود؟
هیچچیز نوشته نمیشود. روی همان تسک دنبالهٔ مزاحمی نمیآید.
آیا ایجنت هیچوقت بدون پرسیدن صفحهٔ ویکی مینویسد؟
نه — create_wiki_page یک فراخوانی ابزار جداست که ایجنت فقط بعد از بلهٔ شما انجامش میدهد.
این فقط برای ایجنتهای هوش مصنوعی است یا به توسعهدهندهٔ انسانی هم کمک میکند؟
جلسات هدایتشده توسط انسان از طریق یک کلاینت MCP هم همان یادآوری را میگیرند — سؤالها مخصوص ایجنت نیستند، مخصوص چرخهٔ عمر تسکاند.
جمعبندی
راهحل «هیچکس چیزی مستند نمیکند» هیچوقت یک سیاست سختگیرانهتر نبود — یک سؤال با زمانبندی بهتر بود. سرور MCP در WKFGo حالا خودکار همان سؤال را میپرسد، درست وقتی جواب دادنش هنوز ارزان است.