refactor(lanes): drop the workflow skills and Superpowers link; pipelines go dormant
The plugin stops shipping its workflow layer: - skills/ship-feature and skills/ship-feature-lane, the 18 stage/ship slash commands (plugin.json keeps agenthub-doctor/update/open), and all four agents/ (qc-local, senior-gate-reviewer, backend-reviewer, frontend-reviewer). - CLI `agenthub skills install`, `agenthub lanes agents install`, `agenthub ship-full|ship-quick`; routes POST /api/skills/install and POST /api/lanes/:id/agents/install; the Settings button, the lane Tools menu item and the Add-lane setup step that called them. - The Superpowers auto-install: server/lib/skill-plugins.js, the bootstrap's autoInstallSkillPlugins / skillPluginsSettled gate and the doctor row. Pipelines are kept but dormant: server/data/pipelines/ is deleted, so no template ships. `default` resolves to EMPTY_PIPELINE (no nodes, progress 0), createLane still accepts it, POST /api/lanes/:id/stage answers 400 ENOPIPELINE, and the Workspace hides the stage timer, pickers, PipelineMap and strip stage chip for a lane with no nodes. A template dropped into DASHBOARD_PIPELINES_DIR turns it all back on. The server suite loads its templates from server/__tests__/fixtures/pipelines/. Docs: CLAUDE.md (marker, retired rules), README(.vi), INSTALL, ARCHITECTURE, docs/LANES|PLUGINS|CLI|API, agenthub-introduction.html.
This commit is contained in:
+11
-76
@@ -888,8 +888,10 @@
|
||||
<div class="d">Skill, plugin, MCP, hook, memory cho cả Claude Code lẫn Codex</div>
|
||||
</div>
|
||||
<div class="card">
|
||||
<div class="t">+ Quy trình ship</div>
|
||||
<div class="d">Gõ một lệnh, chạy từ lúc lên plan tới lúc mở Pull Request</div>
|
||||
<div class="t">+ Pipeline (tạm ngưng)</div>
|
||||
<div class="d">
|
||||
Chưa có template đi kèm - cài template vào DASHBOARD_PIPELINES_DIR để bật lại
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
@@ -923,9 +925,7 @@
|
||||
alt="Tạo lane"
|
||||
/>
|
||||
</div>
|
||||
<div class="cap">
|
||||
Tạo lane: Repo hay Worktree · Claude hay Codex · mẫu pipeline · AI Router
|
||||
</div>
|
||||
<div class="cap">Tạo lane: Repo hay Worktree · Claude hay Codex · AI Router</div>
|
||||
</div>
|
||||
</div>
|
||||
<div
|
||||
@@ -941,10 +941,15 @@
|
||||
<section
|
||||
class="slide"
|
||||
data-t="1 · Lane - pipeline 5 màu"
|
||||
data-n="Tiếp theo là pipeline - nó giúp chúng ta biết được giai đoạn hiện tại mà AI đang làm trên dự án là gì. Có 5 màu: xám là chưa làm đến, xanh dương là đang làm, xanh lá là đã xong giai đoạn và có evidence lưu lại, vàng cam nét đứt là AgentHub tự động detect, và đỏ là chạy thất bại hoặc có lỗi gì đó gây đứng. Đây là slide quan trọng nhất cả bài nên em nói chậm. Có ĐÚNG HAI cách một stage đổi màu. Một là chính session AI tự khai báo bằng lệnh agenthub stage, kèm evidence - đây là cách duy nhất ra được màu xanh lá. Hai là AgentHub tự suy đoán bằng cách đọc luồng lệnh mà AI gọi: thấy npm test thì đoán đang ở stage Tests, thấy gh pr create thì đoán đang ở stage Ship. Nhưng suy đoán chỉ cho ra màu vàng cam, vì AgentHub thấy AI GỌI lệnh chứ không thấy KẾT QUẢ của lệnh đó - thấy nó chạy test không có nghĩa test đã pass. Ba luật kèm theo: suy đoán không bao giờ đè lên khai báo; node suy đoán không bao giờ thành xanh lá; và suy đoán hết hạn sau 5 phút nên lane lùi lại được giữa hai buổi làm. Nói với QC: màu vàng cam chính là chỗ cần soi."
|
||||
data-n="Tiếp theo là pipeline - nó giúp chúng ta biết được giai đoạn hiện tại mà AI đang làm trên dự án là gì. Có 5 màu: xám là chưa làm đến, xanh dương là đang làm, xanh lá là đã xong giai đoạn và có evidence lưu lại, vàng cam nét đứt là AgentHub tự động detect, và đỏ là chạy thất bại hoặc có lỗi gì đó gây đứng. Đây là slide quan trọng nhất cả bài nên em nói chậm. Có ĐÚNG HAI cách một stage đổi màu. Một là chính session AI tự khai báo bằng lệnh agenthub stage, kèm evidence - đây là cách duy nhất ra được màu xanh lá. Hai là AgentHub tự suy đoán bằng cách đọc luồng lệnh mà AI gọi: thấy npm test thì đoán đang ở stage Tests, thấy gh pr create thì đoán đang ở stage Ship. Nhưng suy đoán chỉ cho ra màu vàng cam, vì AgentHub thấy AI GỌI lệnh chứ không thấy KẾT QUẢ của lệnh đó - thấy nó chạy test không có nghĩa test đã pass. Ba luật kèm theo: suy đoán không bao giờ đè lên khai báo; node suy đoán không bao giờ thành xanh lá; và suy đoán hết hạn sau 5 phút nên lane lùi lại được giữa hai buổi làm. Nói với QC: màu vàng cam chính là chỗ cần soi. Lưu ý: hiện tại pipeline đang tạm ngưng - AgentHub không đi kèm template nào, phải cài template vào DASHBOARD_PIPELINES_DIR thì stage mới hiện lại."
|
||||
>
|
||||
<div class="kicker">Chức năng 1 · Lane</div>
|
||||
<h2>Pipeline - thấy tiến độ bằng màu</h2>
|
||||
<div class="note w" style="margin: 0 0 14px; padding: 10px 16px">
|
||||
Hiện tại pipeline đang <b>tạm ngưng</b>: AgentHub không đi kèm pipeline template nào. Thả
|
||||
một file template vào <span class="mono">DASHBOARD_PIPELINES_DIR</span> thì stage và các
|
||||
màu dưới đây hoạt động lại. Phần này sẽ được phát triển tiếp.
|
||||
</div>
|
||||
<div class="pipe full">
|
||||
<span class="node d">Lấy thông tin</span><span class="arr">→</span>
|
||||
<span class="node d">Lên plan</span><span class="arr">→</span>
|
||||
@@ -1330,76 +1335,6 @@
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 13 -->
|
||||
<section
|
||||
class="slide"
|
||||
data-t="Quy trình ship tính năng"
|
||||
data-n="Ngoài các chức năng chính trên, AgentHub còn đi kèm nhiều tiện ích và skill có sẵn, trong đó nổi bật nhất là các workflow lập trình. Ví dụ quy trình hiện tại: đầu tiên là trao đổi, brainstorming và lên plan trước khi bắt đầu; sau đó viết ra các testcase để lát nữa có cái mà đánh giá kết quả output; code xong thì có code review, bằng nhiều agent chuyên biệt như frontend, backend và một reviewer có context trống. Điểm cần nói: đây không phải AgentHub tự nghĩ ra quy trình - nó dùng lại bộ skill chuẩn của Superpowers, chỉ thêm việc khai báo tiến độ về dashboard ở từng stage. Nói kỹ hai card giữa. Card 3: agent soát code được dispatch với CONTEXT TRỐNG - nó chỉ nhận phần code thay đổi và yêu cầu ban đầu, nên nó không thể bị thuyết phục bằng câu chữ, chỉ chấm trên code thật. Card 4: đây không phải skill review, nó là cổng kiểm soát lời tuyên bố - chưa chạy lại lệnh kiểm tra trong chính lượt đó thì không được nói là pass, và cấm luôn việc tin vào báo cáo thành công của agent con. Chốt cho đúng: agent review trả về CLEAN hoặc FINDINGS, và FINDINGS không tự động chặn - luật là xem xét cái nào đáng sửa thì sửa. Thứ thật sự chặn nằm ở bước cuối: AI không bao giờ tự commit hay tự mở PR, phải chính người dùng yêu cầu trong lượt đó. Ai muốn quy trình khác thì thêm skill và bổ sung vào dashboard."
|
||||
>
|
||||
<div class="kicker">Quy trình ship</div>
|
||||
<h2>Quy trình ship tính năng có sẵn</h2>
|
||||
<div class="sub" style="margin: 0 0 26px">
|
||||
Một lệnh <span class="mono hl">/agenthub:ship-feature</span> lái lần lượt 5 skill chuẩn,
|
||||
và khai báo tiến độ về dashboard ở từng stage.
|
||||
</div>
|
||||
|
||||
<div class="grid3">
|
||||
<div class="card acc">
|
||||
<div class="t">1 · writing-plans</div>
|
||||
<div class="d">Trao đổi, brainstorming và lên plan trước khi bắt đầu</div>
|
||||
</div>
|
||||
<div class="card acc">
|
||||
<div class="t">2 · test-driven-development</div>
|
||||
<div class="d">Viết testcase trước để lát sau có cái đánh giá kết quả output</div>
|
||||
</div>
|
||||
<div class="card acc">
|
||||
<div class="t">3 · requesting-code-review</div>
|
||||
<div class="d">
|
||||
Nhiều agent chuyên biệt review code: frontend · backend · reviewer
|
||||
<b>context trống</b>
|
||||
</div>
|
||||
</div>
|
||||
<div class="card acc">
|
||||
<div class="t">4 · verification-before-completion</div>
|
||||
<div class="d">Cấm báo "xong" nếu chưa chạy lại lệnh kiểm tra và đọc kết quả thật</div>
|
||||
</div>
|
||||
<div class="card acc">
|
||||
<div class="t">5 · finishing-a-development-branch</div>
|
||||
<div class="d">Tạo commit, mở Pull Request</div>
|
||||
</div>
|
||||
<div class="card">
|
||||
<div class="t">+ Khả năng mở rộng</div>
|
||||
<div class="d">
|
||||
Team cần quy trình khác thì thêm skill và bổ sung vào dashboard - còn một số tính năng
|
||||
nữa em sẽ bổ sung dần theo feedback của anh chị
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="cols" style="margin-top: 26px">
|
||||
<ul>
|
||||
<li><b>3 agent review chạy song song</b>: reviewer chung · backend · frontend</li>
|
||||
<li>
|
||||
Mỗi bước kiểm tra do một agent <b>context trống</b> chấm, và phải trả về
|
||||
<b>một dòng kết luận rõ ràng</b>, không được nói chung chung:
|
||||
<div style="font-size: 0.9em; line-height: 1.7; margin-top: 8px; color: var(--mut)">
|
||||
• Chạy test → <b style="color: var(--ok)">pass</b> (thêm mấy test) hay
|
||||
<b style="color: var(--bad)">fail</b> (fail test nào, sai chỗ nào)<br />• Code
|
||||
review → <b style="color: var(--ok)">clean</b> hay
|
||||
<b style="color: var(--warn)">có mấy điểm cần sửa</b><br />• Chốt cuối →
|
||||
<b style="color: var(--ok)">cho đi tiếp</b> hay
|
||||
<b style="color: var(--bad)">chặn lại</b> (còn thiếu gì)
|
||||
</div>
|
||||
</li>
|
||||
<li>Trước khi ship, bắt buộc chạy <b>cập nhật tài liệu dự án</b></li>
|
||||
</ul>
|
||||
<div class="note w" style="margin: 0">
|
||||
⚖ <b>AI không bao giờ tự commit hay tự mở Pull Request.</b><br /><br />Dù mọi bước
|
||||
đã xong xuôi, phải chính người dùng yêu cầu trong lượt đó.
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 14 -->
|
||||
<section
|
||||
class="slide"
|
||||
|
||||
Reference in New Issue
Block a user