تتيح هذه المهارة ربط وكيل الذكاء الاصطناعي بحساب Trello لاستعراض اللوحات والقوائم، وإنشاء بطاقات المهام تلقائيًا.
من نص البرومبت
---
name: trello-integration-skill
description: تتيح هذه المهارة ربط وكيل الذكاء الاصطناعي بحساب Trello لاستعراض اللوحات والقوائم، وإنشاء بطاقات المهام تلقائيًا.
---
# مهارة تكامل Trello
توفّر مهارة تكامل Trello ربطًا سلسًا بين وكيل الذكاء الاصطناعي وحساب Trello الخاص بالمستخدم. تمكّن هذه المهارة الوكيل من جلب اللوحات والقوائم الحالية تلقائيًا، وإنشاء بطاقات مهام جديدة ضمن قوائم محددة بناءً على طلبات المستخدم.
## المزايا
- **جلب اللوحات**: استعراض جميع لوحات Trello التي لدى المستخدم صلاحية الوصول إليها، مع عرض الاسم، والمعرّف، والرابط.
- **جلب القوائم**: استعراض جميع القوائم داخل لوحة محددة، مثل أعمدة "المهام"، و"قيد التنفيذ"، و"منجزة".
- **إنشاء البطاقات**: إنشاء بطاقات جديدة تلقائيًا بعناوين وأوصاف داخل قوائم محددة.
---
## الإعداد والمتطلبات المسبقة
لاستخدام هذه المهارة محليًا، تحتاج إلى إضافة بيانات اعتماد واجهة Trello Developer API الخاصة بك.
1. أنشئ بيانات الاعتماد من خلال [Trello Developer Portal (Power-Ups Admin)](https://trello.com/app-key).
2. أنشئ مفتاح API.
3. أنشئ رمزًا سريًا Secret Token بصلاحيات القراءة والكتابة.
4. أضف بيانات الاعتماد هذه في ملف `.env` الموجود في جذر المشروع:
```env
# Trello Integration
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
```
---
## طريقة الاستخدام والبنية
تعتمد المهارة على سكربتات Node.js مستقلة موجودة داخل المسار `.agent/skills/trello_skill/scripts/`.
### 1. استعراض جميع اللوحات
يجلب جميع اللوحات الخاصة بالمستخدم الموثّق لتحديد `boardId` الصحيح للوحة المستهدفة.
**التشغيل:**
```bash
node .agent/skills/trello_skill/scripts/list_boards.js
```
### 2. استعراض الأعمدة (القوائم) داخل لوحة
يجلب القوائم الموجودة داخل لوحة محددة للوصول إلى `listId` الصحيح، مثل استخراج معرّف قائمة "المهام".
**التشغيل:**
```bash
node .agent/skills/trello_skill/scripts/list_lists.js <boardId>
```
### 3. إنشاء بطاقة جديدة
ينشئ بطاقة جديدة داخل القائمة المحددة.
**التشغيل:**
```bash
node .agent/skills/trello_skill/scripts/create_card.js <listId> "<Card Title>" "<Optional Description>"
```
*(احرص دائمًا على وضع عنوان البطاقة ووصفها بين علامتي اقتباس مزدوجتين لتفادي تقسيم الوسائط في Bash).*
---
## آلية عمل وكيل الذكاء الاصطناعي
عندما يطلب المستخدم إدارة مهمة أو إضافتها في Trello، اتبع هذه الخطوات تلقائيًا:
1. **تحديد الهدف**: إذا كان `listId` غير معروف، شغّل أولًا `list_boards.js` لتحديد `boardId` الصحيح، ثم نفّذ `list_lists.js <boardId>` للحصول على `listId` المناسب، مثل قائمة "المهام".
2. **تنفيذ الأمر**: شغّل سكربت `create_card.js <listId> "Task Title" "Task Description"`.
3. **إبلاغ المستخدم**: أكّد للمستخدم نجاح إنشاء البطاقة، ووفّر الرابط المباشر لبطاقة Trello الجديدة.
FILE:create_card.js
const path = require('path');
require('dotenv').config({ path: path.join(__dirname, '../../../../.env') });
const API_KEY = process.env.TRELLO_API_KEY;
const TOKEN = process.env.TRELLO_TOKEN;
if (!API_KEY || !TOKEN) {
console.error("Error: TRELLO_API_KEY or TRELLO_TOKEN is missing from the .env file.");
process.exit(1);
}
const listId = process.argv[2];
const cardName = process.argv[3];
const cardDesc = process.argv[4] || "";
if (!listId || !cardName) {
console.error(`Usage: node create_card.js <listId> "card_name" ["card_description"]`);
process.exit(1);
}
async function createCard() {
const url = `https://api.trello.com/1/cards?idList=listId&key=API_KEY&token=TOKEN`;
try {
const response = await fetch(url, {
method: 'POST',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: cardName,
desc: cardDesc,
pos: 'top'
})
});
if (!response.ok) {
const errText = await response.text();
throw new Error(`HTTP error! status: response.status, message: errText`);
}
const card = await response.json();
console.log(`Successfully created card!`);
console.log(`Name: card.name`);
console.log(`ID: card.id`);
console.log(`URL: card.url`);
} catch (error) {
console.error("Failed to create card:", error.message);
}
}
createCard();
FILE:list_boards.js
const path = require('path');
require('dotenv').config({ path: path.join(__dirname, '../../../../.env') });
const API_KEY = process.env.TRELLO_API_KEY;
const TOKEN = process.env.TRELLO_TOKEN;
if (!API_KEY || !TOKEN) {
console.error("Error: TRELLO_API_KEY or TRELLO_TOKEN is missing from the .env file.");
process.exit(1);
}
async function listBoards() {
const url = `https://api.trello.com/1/members/me/boards?key=API_KEY&token=TOKEN&fields=name,url`;
try {
const response = await fetch(url);
if (!response.ok) throw new Error(`HTTP error! status: response.status`);
const boards = await response.json();
console.log("--- Your Trello Boards ---");
boards.forEach(b => console.log(`Name: b.name\nID: b.id\nURL: b.url\n`));
} catch (error) {
console.error("Failed to fetch boards:", error.message);
}
}
listBoards();
FILE:list_lists.js
const path = require('path');
require('dotenv').config({ path: path.join(__dirname, '../../../../.env') });
const API_KEY = process.env.TRELLO_API_KEY;
const TOKEN = process.env.TRELLO_TOKEN;
if (!API_KEY || !TOKEN) {
console.error("Error: TRELLO_API_KEY or TRELLO_TOKEN is missing from the .env file.");
process.exit(1);
}
const boardId = process.argv[2];
if (!boardId) {
console.error("Usage: node list_lists.js <boardId>");
process.exit(1);
}
async function listLists() {
const url = `https://api.trello.com/1/boards/boardId/lists?key=API_KEY&token=TOKEN&fields=name`;
try {
const response = await fetch(url);
if (!response.ok) throw new Error(`HTTP error! status: response.status`);
const lists = await response.json();
console.log(`--- Lists in Board boardId ---`);
lists.forEach(l => console.log(`Name: "l.name"\nID: l.id\n`));
} catch (error) {
console.error("Failed to fetch lists:", error.message);
}
}
listLists();
