@wipal/agent-team 1.0.0

package/src/utils/skill-scanner.js

@@ -0,0 +1,154 @@
+/**
+ * Skill Scanner - Scan SKILL.md files and parse metadata
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import { glob } from 'glob';
+import yaml from 'js-yaml';
+import { getPackageRoot } from './file-utils.js';
+
+/**
+ * Parse YAML frontmatter from markdown content
+ * @param {string} content - Markdown content with potential frontmatter
+ * @returns {Object} - Parsed frontmatter and body
+ */
+export function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+
+  if (!match) {
+    return { metadata: {}, body: content };
+  }
+
+  try {
+    const metadata = yaml.load(match[1]);
+    const body = match[2];
+    return { metadata, body };
+  } catch (error) {
+    console.warn('Failed to parse frontmatter:', error.message);
+    return { metadata: {}, body: content };
+  }
+}
+
+/**
+ * Scan all SKILL.md files and extract metadata
+ * @param {string} skillsDir - Directory containing skills
+ * @returns {Promise<Array>} - Array of skill objects with metadata
+ */
+export async function scanSkills(skillsDir = null) {
+  if (!skillsDir) {
+    skillsDir = path.join(getPackageRoot(), '.claude', 'skills');
+  }
+
+  const skillFiles = await glob('**/SKILL.md', {
+    cwd: skillsDir,
+    absolute: true
+  });
+
+  const skills = [];
+
+  for (const file of skillFiles) {
+    try {
+      const content = await fs.readFile(file, 'utf-8');
+      const { metadata, body } = parseFrontmatter(content);
+
+      // Get relative path from skills directory
+      const relativePath = path.relative(skillsDir, path.dirname(file));
+      const pathParts = relativePath.split(path.sep);
+
+      // Determine category from path
+      let category = metadata.category || 'unknown';
+      if (pathParts.length >= 2) {
+        // Path like: core/code-review/SKILL.md -> category = core
+        // Path like: domain/frontend/frontend-design/SKILL.md -> category = frontend
+        if (pathParts[0] === 'domain' && pathParts.length >= 2) {
+          category = metadata.category || pathParts[1];
+        } else {
+          category = metadata.category || pathParts[0];
+        }
+      }
+
+      skills.push({
+        name: metadata.name || path.basename(path.dirname(file)),
+        path: path.dirname(file),
+        relativePath,
+        category,
+        tags: metadata.tags || [],
+        description: metadata.description || '',
+        version: metadata.version || '1.0.0',
+        depends_on: metadata.depends_on || [],
+        recommends: metadata.recommends || [],
+        used_by: metadata.used_by || [],
+        body
+      });
+    } catch (error) {
+      console.warn(`Failed to scan skill: ${file}`, error.message);
+    }
+  }
+
+  return skills;
+}
+
+/**
+ * Get skills by category
+ * @param {Array} skills - Array of skills
+ * @param {string} category - Category to filter by
+ * @returns {Array} - Filtered skills
+ */
+export function getSkillsByCategory(skills, category) {
+  return skills.filter(skill =>
+    skill.category === category ||
+    skill.tags.includes(category)
+  );
+}
+
+/**
+ * Get skills by names
+ * @param {Array} skills - Array of skills
+ * @param {Array} names - Skill names to filter by
+ * @returns {Array} - Filtered skills
+ */
+export function getSkillsByNames(skills, names) {
+  return skills.filter(skill => names.includes(skill.name));
+}
+
+/**
+ * Get all unique categories from skills
+ * @param {Array} skills - Array of skills
+ * @returns {Array} - Unique categories
+ */
+export function getCategories(skills) {
+  const categories = new Set();
+  for (const skill of skills) {
+    categories.add(skill.category);
+    for (const tag of skill.tags) {
+      categories.add(tag);
+    }
+  }
+  return Array.from(categories).sort();
+}
+
+/**
+ * Cache for scanned skills
+ */
+let skillsCache = null;
+
+/**
+ * Get skills with caching
+ * @param {boolean} refresh - Force refresh cache
+ * @returns {Promise<Array>} - Array of skills
+ */
+export async function getSkills(refresh = false) {
+  if (skillsCache && !refresh) {
+    return skillsCache;
+  }
+  skillsCache = await scanSkills();
+  return skillsCache;
+}
+
+/**
+ * Clear skills cache
+ */
+export function clearSkillsCache() {
+  skillsCache = null;
+}

package/templates/CLAUDE.md.tmpl

@@ -0,0 +1,42 @@
+# Project: {{PROJECT_NAME}} - {{ROLE_NAME}}
+
+## Role
+Bạn là {{ROLE_NAME}} chuyên sâu về:
+{{ROLE_SKILLS}}
+
+## Tech Stack & Conventions
+{{TECH_STACK}}
+
+### Code Style
+- Follow existing patterns trong codebase
+- Write clean, readable, maintainable code
+- Handle errors explicitly
+- Add appropriate logging
+
+## How to Work
+
+### Khi nhận task:
+1. Tóm tắt yêu cầu
+2. Đề xuất giải pháp
+3. Liệt kê files sẽ tạo/sửa
+4. Xin confirmation nếu thay đổi lớn
+
+### Khi code:
+1. Read existing code first để hiểu patterns
+2. Follow conventions đã có
+3. Test thoroughly before claiming done
+4. Update knowledge.md với learnings
+
+## MCP Integration
+- Context7: Dùng để tra cứu documentation (BẮT BUỘC khi code)
+- GitHub: Quản lý code và PR
+
+## Knowledge Base
+- Đọc từ: .claude/agents/{{AGENT_NAME}}/knowledge.md
+- Cập nhật qua: /retrospect-work skill
+
+## Installed Variants
+{{VARIANTS_LIST}}
+
+## Skills Available
+{{SKILLS_LIST}}

package/templates/knowledge.md.tmpl

@@ -0,0 +1,31 @@
+# {{AGENT_NAME}} Knowledge Base
+
+## Metadata
+- created: {{CREATED_AT}}
+- last_updated: {{CREATED_AT}}
+- base_role: {{ROLE_NAME}}
+
+## Project Context
+[Project-specific information will be added as you work]
+
+## Learned Patterns
+(Patterns will be added via /retrospect-work)
+
+### Code Patterns
+```
+// Add patterns you discover here
+```
+
+### Best Practices
+- [Add best practices you learn]
+
+### Common Pitfalls
+- [Add pitfalls to avoid]
+
+## Feedback Log
+(Feedback will be tracked here)
+
+### {{DATE}}: [Feedback Title]
+- **What happened:**
+- **Lesson learned:**
+- **Action item:**