FARE skill pack 2.0.2 — mô hình plan-item + đồng bộ 39 tool MCP - #4
Open
bacng95 wants to merge 3 commits into
Open
FARE skill pack 2.0.2 — mô hình plan-item + đồng bộ 39 tool MCP#4bacng95 wants to merge 3 commits into
bacng95 wants to merge 3 commits into
Conversation
…kỹ thuật (2.0.1) Rà soát chất lượng skill pack đối chiếu trực tiếp với MCP server FARE thật (probe live từng tool/resource). Sửa các bug "im lặng" khiến agent gọi MCP fail hoặc tạo artifact không định vị được. Không breaking — an toàn từ 2.0.0. Bug fail-cứng (xác nhận bằng probe -32602): - create_document KHÔNG nhận param `status` → bỏ khỏi mọi ví dụ (doc mặc định draft); update_document status enum đúng là draft|review (sửa `in_review` không tồn tại). - update_task KHÔNG có field `actual_effort` (ghi qua worklog UI) → bỏ khỏi self-verify, developer, effort-estimation, handoff. - add_comment đổi chữ ký → (projectCode, entityType, entityId, content-HTML); sửa các ví dụ add_comment(taskId, comment=…) + làm giàu reference trung tâm. Bug nội dung/định vị: - Chip-mention thân richtext: URI trần KHÔNG tự thành chip (lưu text thuần) → bắt buộc chip HTML đầy đủ; phân biệt với description task/comment (auto-chip). - SRS theo chức năng: bỏ "content trống → template hệ thống" (mất title + sai format) → viết content use-case trực tiếp + title có nghĩa. - Glossary dedup: bỏ `query=` (trượt glossary tên tiếng Việt), chỉ kind="glossary". - Thuật ngữ "module/Module/Function" đời cũ → plan item (theme/epic/story). - effort_est (dẫn xuất) → effort_est_level; tàn dư "(khi vai QA được xây)" → /fare-test, /fare-verify. - Ranh giới vai: Dev không tự sửa api_doc/erd (→ technical-writer); traceability là vai BA. Bổ sung SOP + skill: - Skill mới fare-tech-doc-authoring (api_doc/erd/diagram references) cho technical-writer. - fare-context-discovery: nhánh greenfield (đầu vào file ngoài, chưa có mỏ neo). - /fare-plan + /fare-ba: tiền điều kiện "project phải tồn tại". - fare-plan-breakdown: cảnh báo đừng mirror cách gom nhóm của tài liệu nguồn (cohesion). - Chuẩn hóa khuôn agent PM/QA/Dev: header "Nhận đầu vào từ / Bàn giao cho". - Linter: thêm query_params vào NON_TOOL allowlist (false-positive). check:tools 0/0. sync:claude OK. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PLTwB9uERBa5bqD7EWv1k9
- list_tasks: meta_status→status, search→q (đúng param zod thật) - traceability: bỏ field linked_ac_uid không tồn tại — link AC qua text trong description - doc status: review→in_review (khớp VALID_STATUSES), lockstep với backend - plan-versioning: thêm breadcrumb hub + rules (hết orphan) - hub: 40→39 tool (patch_document đã gỡ) + thêm resource fare://document-purposes, fare://doc-type-schemas - linter check-tools: patch_document DEPRECATED→REMOVED Toàn bộ verify bằng probe MCP live (meta_status/search/bug_origin → -32602; status live=in_review). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GHSHSqyndzsyagGczAMLwC
Patch trên 2.0.1: sửa drift tên tool/param trong skill (probe-verified, đối chiếu schema MCP sống), đồng bộ danh sách 39 tool, review 9 điểm đóng không phát sinh thay đổi backend. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01GHSHSqyndzsyagGczAMLwC
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Tóm tắt
Release 2.0.2 cho
fare-skill-pack, gộp toàn bộ nhánhfeat/plan-item-model-2.0:theme › epic › story; renamemodule_id → plan_item_id.list_tasks(meta_status=)→status=,list_tasks(search=)→q=linked_ac_uid(link AC↔TC bằng text trongdescription)patch_document(đã gỡ) →edit_document; danh sách chuẩn hoá 39 toolreview→in_review(lockstep 5 skill + backend)bin/check-tools.mjs: gate build theo hợp đồng tool; prepack chặn publish nếu còn tham chiếu tool đã gỡ.Kiểm thử
npm run check:tools→ ✓ 0 tool đã-gỡ, 0 cảnh báo.🤖 Generated with Claude Code