Feature/delta team/epic r04 (#7)

## Summary

epic r04 - begin refactor

## Change Type

- [x] Cowork feature
- [ ] Bug fix
- [ ] Core AI contribution
- [ ] Test / hardening
- [ ] Performance
- [ ] Documentation

## Related Work

Cowork Task:

Core Repo: http://34.143.229.138/gitea-admin/fsg-ai-core-assets

Core AI Issue:

Core Task:

Related PR:

## Scope

What is intentionally included?

What is intentionally NOT included?

## Validation

- [ ] Unit tests
- [ ] Integration tests
- [ ] Manual verification
- [ ] Regression check

Commands / evidence:

## Security Impact

Permission / credential / network / customer data impact:

## Compatibility

- [ ] No breaking change
- [ ] Breaking change documented

## Reviewer Notes

Anything Cowork reviewers should pay attention to.

---------

Co-authored-by: Anh Tran Nguyen Minh <anhtnm1@fpt.com>
Co-authored-by: Huong Le Thi Thien <huongltt35@fpt.com>
Co-authored-by: Nam Pham Dinh Thanh <nampdt@fpt.com>
Co-authored-by: Vu Dam Tuan <vudt15@fpt.com>
Co-authored-by: Hiep Ha Van <hiephv3@fpt.com>
Co-authored-by: Lam Hoang Van <lamhv7@fpt.com>
Reviewed-on: #7
Co-authored-by: Duy Le Huu <duylh19@fpt.com>

core/agent_command.py

@@ -31,6 +31,7 @@ _CMD = re.compile(r"(?<!\S)/agent(?::([\w\-.]+))?(?=$|[\s.,;:!?)\]}»”’'\"
 
 
 def _slug(name: str) -> str:
+    """Định danh an toàn suy từ tên agent (dùng chung hàm với Co4E)."""
     from .co4e import slugify
     return slugify(name)
 
@@ -45,6 +46,11 @@ def collect_agents(shared_dir: str = "") -> List[dict]:
     seen: set[str] = set()
 
     def _add(slug: str, name: str, desc: str, persona: str, source: str) -> None:
+        """Thêm một agent vào danh sách gộp; bỏ qua nếu trùng slug hoặc thiếu persona.
+
+        Agent không có persona thì không dùng được — thêm vào chỉ làm bảng gợi ý dài
+        ra mà chọn vào lại không chạy.
+        """
         if not slug or slug in seen or not persona.strip():
             return
         seen.add(slug)
@@ -69,6 +75,7 @@ def collect_agents(shared_dir: str = "") -> List[dict]:
 
 
 def _persona_block(agent: dict) -> str:
+    """Khối prompt mô tả một agent, chèn vào đầu lượt chat khi người dùng gõ ``/agent:``."""
     return f"## Agent: {agent['name']}\n{agent['persona']}"