Patricia

[!NOTE] Kho lưu trữ này được tạo từ bettergroupinc/patricia-monorepo tại plugins/patricia/. Tự động hóa đồng bộ bản sao công khai này. Commit nguồn: 147037702592109a4944cdbfb94bdcabb33f490f. Mở pull request và issue trong monorepo.

Plugin Claude Code patricia

Cài đặt plugin này một lần và agent sẽ sử dụng máy chủ MCP của Patricia một cách chính xác mà không cần được nhắc lại.

Plugin này mang theo ba thành phần.

1. Hướng dẫn. Năm kỹ năng bao gồm kiến thức cơ bản về Patricia, quy trình bắt đầu, công việc được ủy quyền, tích hợp và cầu nối bộ nhớ.
2. Kết nối MCP. Quá trình cài đặt cấu hình máy chủ Streamable HTTP của Patricia để đăng nhập OAuth.
3. Năm hook cục bộ. Chúng khởi tạo dự án, truy xuất bộ nhớ, kiểm tra tích hợp trước và đề xuất đẩy bộ nhớ. Chúng không bao giờ ghi vào Patricia.

Đây là một plugin Claude Code có thể phân phối. Một người cài đặt nó trên máy của họ và nó chạy trong phiên Claude Code của người đó. Nó không phải là danh mục kỹ năng sản phẩm của Patricia và không có gì trong đó chạy bên trong Patricia.

Cài đặt

claude plugin marketplace add patricia-app/patricia-plugin
claude plugin install patricia@patricia

Sau đó bắt đầu một phiên mới hoặc chạy /reload-plugins.

Thị trường đó là https://github.com/patricia-app/patricia-plugin. Tự động hóa tạo mọi tệp trong đó từ monorepo của Patricia.

Ghi chú cho người đóng góp: monorepo là riêng tư. Người đóng góp có quyền truy cập có thể thêm chính monorepo như một thị trường, vì .claude-plugin/marketplace.json gốc của nó trỏ plugin patricia tới ./plugins/patricia.

Cài đặt nó. Không tải nó bằng --plugin-dir. Một plugin được tải từ thư mục sẽ nhận được kỹ năng nhưng không nhận được hook, vì vậy hướng dẫn sẽ hoạt động nhưng cầu nối bộ nhớ sẽ không bao giờ kích hoạt. Điều đó được đo chứ không phải giả định: một hook thăm dò được tải qua --plugin-dir không bao giờ chạy, trong khi cùng một hook được khai báo trong cài đặt dự án đã chạy trên cùng một lần ghi trong cùng chế độ headless. Claude Code đăng ký hooks/hooks.json của plugin chỉ cho một plugin đã cài đặt và được kích hoạt.

claude plugin details patricia báo cáo những gì đã được cài đặt:

Component inventory
  Skills (5)  delegating-work, integrations, memory-bridge, onboard, using-patricia
  MCP servers (1)  patricia
  Hooks (5)  SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop

Đăng nhập vào máy chủ MCP

Plugin cấu hình máy chủ MCP mà không có tiêu đề được lưu trữ. Khi sử dụng lần đầu, chạy /mcp và chọn Patricia. Bạn cũng có thể bắt đầu luồng OAuth từ terminal:

claude mcp login plugin:patricia:patricia

Đăng nhập OAuth MCP và mã thông báo cá nhân pat_mcp_ của các hook là các thông tin xác thực riêng biệt. Chỉ riêng OAuth không kích hoạt các hook phụ thuộc mã thông báo.

Sử dụng mã thông báo như một phương án thay thế khi OAuth không phù hợp:

claude mcp add --transport http patricia https://api.patricia.app/v1/mcp \
  --header "Authorization: Bearer $PATRICIA_MCP_TOKEN"

Mã thông báo cá nhân pat_mcp_ xác định người chịu trách nhiệm và có thể ghi. Khóa API đối tượng thuê pat_live_ không xác định ai, vì vậy nó chỉ đọc và không thể trả lời list_skills hoặc list_integrations.

Cung cấp mã thông báo cá nhân cho các hook cục bộ

Python 3 phải có sẵn thông qua lệnh python3 cho các hook cục bộ.

Tạo khóa cá nhân pat_mcp_ trong Patricia tại Cài đặt > Nhà phát triển > Khóa cá nhân. Sau đó chọn một thiết lập:

export PATRICIA_MCP_TOKEN="pat_mcp_..."

Hoặc viết tệp này tại ~/.claude/patricia.json:

{
  "token": "pat_mcp_..."
}

PATRICIA_MCP_TOKEN thắng hơn tệp. Một PATRICIA_MCP_TOKEN trống vô hiệu hóa dự phòng tệp. Hành vi này là có chủ đích. Nó cho phép một người tạm dừng các hook đã xác thực mà không cần di chuyển tệp.

Hook cục bộ

Tất cả năm hook đều bật theo mặc định. Tệp cấu hình vắng mặt hoặc khóa hook vắng mặt khiến chúng vẫn bật. Một cấu hình sai định dạng hoặc không đọc được sẽ tắt chúng. Đặt khóa được liệt kê của một hook thành giá trị chữ false trong ~/.claude/patricia-plugin.json để chỉ tắt hook đó.

Khởi tạo

• Khi nào và hành động: SessionStart chạy cho một phiên mới hoặc được tiếp tục. Nó chào người kết nối và cung cấp kỹ năng khởi tạo một lần cho mỗi dự án.
• Chi phí: Với mã thông báo, nó thực hiện một lần gọi whoami. Thời gian chờ mạng là 3 giây và thời gian chờ hook là 10 giây.
• Công tắc tắt: hooks.onboarding.enabled được đặt thành false.
• Quyền riêng tư: Với mã thông báo, chỉ yêu cầu whoami đã xác thực rời khỏi máy. Không có lời nhắc, bản ghi hoặc nội dung dự án rời khỏi máy qua hook này.

Truy xuất

• Khi nào và hành động: UserPromptSubmit chạy trước mỗi lời nhắc được gửi. Nó bỏ qua các lệnh, trả lời ngắn, xác nhận và đầu vào chỉ có mã. Nó thêm bộ nhớ liên quan vào các lời nhắc đủ điều kiện.
• Chi phí: Với mã thông báo và lời nhắc đủ điều kiện, nó thực hiện một lần gọi search_memory. Thời gian chờ mạng là 3 giây và thời gian chờ hook là 8 giây.
• Công tắc tắt: hooks.recall.enabled được đặt thành false.
• Quyền riêng tư: Nó gửi tối đa 300 ký tự của lời nhắc đã thu gọn tới Patricia. Nó gửi văn bản đó chỉ khi mã thông báo được cấu hình.

Tích hợp trước

• Khi nào và hành động: UserPromptSubmit kiểm tra một lời nhắc. PreToolUse kiểm tra đầu vào WebFetch, WebSearch và Bash trước khi công cụ chạy. Một danh mục cục bộ xác định các nhà cung cấp đã biết.
• Chi phí: Nó không thực hiện cuộc gọi MCP hoặc mạng và không cần mã thông báo. Thời gian chờ hook là 8 giây cho một lời nhắc và 5 giây trước một lời gọi công cụ.
• Công tắc tắt: hooks.integrations_first.enabled được đặt thành false.
• Quyền riêng tư: Không có gì rời khỏi máy. Hook kiểm tra lời nhắc hoặc đầu vào công cụ cục bộ.

Cầu nối bộ nhớ

• Khi nào và hành động: PostToolUse chạy sau Write, Edit hoặc MultiEdit. Nó nhận thấy một ghi chú bộ nhớ cục bộ đã lưu và đề xuất remember với phạm vi rõ ràng.
• Chi phí: Nó không thực hiện cuộc gọi MCP hoặc mạng. Thời gian chờ hook là 5 giây.
• Công tắc tắt: hooks.memory_bridge.enabled được đặt thành false. Tệp kế thừa ~/.claude/patricia-memory-bridge.json cũng có thể đặt enabled thành false.
• Quyền riêng tư: Tập lệnh đọc ghi chú đã lưu cục bộ và không gửi gì qua mạng. Nó trả về đường dẫn ghi chú và văn bản nhắc nhở cho Claude Code, không có nội dung ghi chú.

Nhắc đẩy

• Khi nào và hành động: Stop chạy khi agent hoàn thành. Nó đề xuất remember sau một ghi bộ nhớ cục bộ hoặc một phiên sử dụng công cụ đáng kể mà không có ghi bộ nhớ vào Patricia.
• Chi phí: Nó không thực hiện cuộc gọi MCP hoặc mạng. Thời gian chờ hook là 8 giây.
• Công tắc tắt: hooks.push_reminder.enabled được đặt thành false.
• Quyền riêng tư: Nó đọc tối đa 5 MB bản ghi cục bộ và không gửi gì. Nó chỉ chạy khi một mã thông báo được cấu hình, vì vậy lời gọi bộ nhớ được đề xuất có thể thành công sau khi người dùng đồng ý.

Mạng và thông tin xác thực

Plugin này kết nối tới https://api.patricia.app/v1/mcp qua Streamable HTTP.

Patricia sử dụng OAuth 2.1 với PKCE S256. Một luồng OAuth hoàn tất cung cấp cho máy khách một mã thông báo bearer cá nhân pat_mcp_.

Tệp kê khai plugin không chứa thông tin xác thực. Máy khách gửi mã thông báo bearer tới api.patricia.app sau khi đăng nhập.

Các thị trường khác

• Cursor đọc plugin.json và mcp.json từ gói này.
• OpenAI Codex và ChatGPT đọc .codex-plugin/plugin.json.
• Một mục nhập nguồn từ xa không cần tệp kê khai. xAI đọc .claude-plugin/plugin.json khi có mặt.

Tất cả các gói thị trường trỏ tới một cây skills/ trong gói này.

assets/icon.png là một tài sản thương hiệu Patricia của bên thứ nhất.

Cầu nối bộ nhớ đề xuất; nó không bao giờ ghi

Một hook là một lệnh shell. Nó không giữ máy khách MCP, nó không có sự đồng ý từ ai và nó không thể đọc một ghi chú và phân biệt một sự thật nhóm với một sự thật riêng tư. Một hook gửi mọi ghi chú cục bộ tới một không gian làm việc dùng chung sẽ đặt các ghi chú cụ thể cho máy, dùng một lần và riêng tư trước toàn bộ nhóm, một cách im lặng. Đó là chế độ lỗi mà cầu nối được xây dựng để tránh, không phải một tính năng bị trì hoãn.

Vì vậy, hook làm một việc: nó chèn hookSpecificOutput.additionalContext cho agent biết rằng ghi chú chỉ là cục bộ và remember cần một scope. Agent quyết định phạm vi, hỏi người của nó và thực hiện lời gọi. Sự đánh giá và việc ghi ở cùng một nơi.

Bốn cổng giữ nó im lặng:

Cổng	Hiệu ứng
Một trong hai cấu hình được hỗ trợ đặt giá trị enabled của cầu nối thành false	Im lặng. Không có giá trị đó, cầu nối được bật.
Đường dẫn được ghi nằm ngoài thư mục bộ nhớ	Im lặng.
Việc ghi không thành công hoặc tệp trống	Im lặng.
Phần đầu của ghi chú mang patricia: skip	Im lặng.

Nó cũng cung cấp một ghi chú nhất định tối đa một lần mỗi phiên, vì vậy một Write theo sau bởi một loạt các lời gọi Edit tạo ra một lời nhắc thay vì bốn. Bản ghi đó nằm trong ~/.claude/patricia-memory-bridge-state/, một tệp mỗi phiên, được dọn dẹp sau bảy ngày.

Nó không sử dụng CLAUDE_PLUGIN_DATA cho việc đó. Biến đó có mặt trong môi trường của một hook nhưng nó không đáng tin cậy là thư mục riêng của plugin đang chạy: một hook cấp dự án trên máy này thấy nó được đặt thành ~/.claude/plugins/data/codex-openai-codex, một thư mục dữ liệu của một plugin không liên quan.

Công cụ nào mà một ghi bộ nhớ thực sự sử dụng

Claude Code 2.1.238 khai báo các công cụ tên memory_list, memory_read và memory_write. Trên các máy mà điều này được xây dựng dựa trên, các ghi chú bộ nhớ không được ghi bằng chúng: một cuộc quét 120 bản ghi phiên gần nhất tìm thấy 49 lời gọi Write và 35 lời gọi Edit vào ~/.claude/projects/*/memory/ và không có lời gọi memory_write nào.

Do đó, bộ so khớp là Write|Edit|MultiEdit. memory_write bị bỏ qua có chủ đích. Thêm một bộ so khớp cho một công cụ có hình dạng tải trọng chưa được xác minh sẽ mua một hook không bao giờ kích hoạt và đọc chính xác như một cái hoạt động. Thêm nó khi một tải trọng memory_write thực sự đã được đọc.

Hướng dẫn và quy tắc đứng của máy chủ là một bản sao, không phải hai

start_onboarding_import có thể trả về một standing_rule_to_offer mang ask_first, instruction và một khối markdown có kích thước phù hợp với CLAUDE.md của người khác. Kỹ năng không nhắc lại khối đó. Nó bảo agent gọi công cụ và sử dụng những gì trả về, vì vậy máy chủ vẫn là chủ sở hữu duy nhất của cách diễn đạt đó.

Tìm nạp nó tại thời điểm cài đặt là phương án thay thế và nó không hoạt động. SKILL.md của một plugin là văn bản tĩnh trong bộ nhớ cache có địa chỉ nội dung, không có bước thời điểm cài đặt có thể viết lại nó và một plugin có công việc bao gồm thiết lập Patricia không thể phụ thuộc vào một kết nối Patricia đã xác thực hoạt động để hiển thị các hướng dẫn của chính nó. Đọc công cụ tại thời điểm sử dụng cho cùng một bản sao duy nhất mà không có bất kỳ điều đó.

Mọi tên công cụ ở đây là một công cụ thực sự

Mọi định danh công cụ được đánh dấu backtick trong plugin này được giữ dựa trên sổ đăng ký công cụ của chính máy chủ, danh sách mà máy chủ xây dựng tools/list từ đó. Cùng một kiểm tra khẳng định rằng nó tìm thấy một tập hợp không trống các định danh, vì vậy một bộ trích xuất bị hỏng không thể vượt qua bằng cách không tìm thấy gì.

Ghi chú cho người đóng góp: kiểm tra đó là backend/api/tests/test_patricia_claude_plugin.py trong monorepo của Patricia và nó chạy trên mọi thay đổi đối với plugin này.

Cài đặt và khám phá tệp

Công cụ	Sử dụng
get_settings	Liệt kê cài đặt hoặc đọc các khóa hoặc nhóm đã chọn với ý nghĩa, giá trị và quyền. Một trong hai thông tin xác thực có thể đọc các nhóm không gian làm việc.
update_settings	Thay đổi một nhóm được phép thông qua thao tác bảng điều khiển. Mã thông báo cá nhân là bắt buộc.
list_files	Liệt kê tệp. Trang đầu tiên bao gồm các thư mục và số lượng được lọc theo khả năng hiển thị.
get_brand_kit	Đọc màu thương hiệu, kiểu chữ và logo.

Sử dụng get_settings(keys=["company_profile"]) cho hồ sơ công ty. Các công cụ cài đặt chia sẻ danh mục và thao tác mà Patricia sử dụng trong trò chuyện. Thay đổi cài đặt trò chuyện yêu cầu một cú nhấp chuột từ người yêu cầu. Một thay đổi chính sách phê duyệt ảnh hưởng đến các lần chạy bảng điều khiển; các hành động quan trọng và bắt buộc của nhà cung cấp giữ nguyên mức sàn phê duyệt của chúng và mức sàn đối tượng và chỉ nhấp chuột giữ nguyên trên bất kỳ hành động nào Patricia đã hỏi về.

Đọc tích hợp chờ trong khi một tác vụ khác chạy cho cùng một người. Thăm dò tác vụ đó bằng get_task_status hoặc chờ nó hoàn thành. Sau khi phê duyệt tích hợp trực tiếp, làm theo câu next được trả về bởi decide_approval. Nó đặt tên cho công cụ để gọi lại với cùng tool_ref và đối số.