From e571bd591855a143388f1e1cbcf14af6c483ee70 Mon Sep 17 00:00:00 2001 From: Jiayuan Date: Sun, 1 Feb 2026 21:55:22 +0800 Subject: [PATCH 1/4] refactor(profile): remove tools.md template The tools.md template content duplicated information already present in each tool's schema description, causing maintenance burden and potential inconsistencies. Tool usage guidelines can be added to soul.md if needed. Co-Authored-By: Claude Opus 4.5 --- src/agent/profile/index.ts | 5 ----- src/agent/profile/storage.test.ts | 7 ------- src/agent/profile/storage.ts | 6 +----- src/agent/profile/templates.ts | 34 ------------------------------- src/agent/profile/types.ts | 3 --- 5 files changed, 1 insertion(+), 54 deletions(-) diff --git a/src/agent/profile/index.ts b/src/agent/profile/index.ts index 5f882015..dcb23976 100644 --- a/src/agent/profile/index.ts +++ b/src/agent/profile/index.ts @@ -44,7 +44,6 @@ export function createAgentProfile( if (useTemplates) { profile.soul = DEFAULT_TEMPLATES.soul; profile.identity = DEFAULT_TEMPLATES.identity; - profile.tools = DEFAULT_TEMPLATES.tools; profile.memory = DEFAULT_TEMPLATES.memory; profile.bootstrap = DEFAULT_TEMPLATES.bootstrap; @@ -139,10 +138,6 @@ export class ProfileManager { parts.push(profile.soul); } - if (profile.tools) { - parts.push(profile.tools); - } - if (profile.memory) { parts.push(profile.memory); } diff --git a/src/agent/profile/storage.test.ts b/src/agent/profile/storage.test.ts index dae0dfe0..014454d4 100644 --- a/src/agent/profile/storage.test.ts +++ b/src/agent/profile/storage.test.ts @@ -152,7 +152,6 @@ describe("storage", () => { writeFileSync(join(dir, "SOUL.md"), "Soul content"); writeFileSync(join(dir, "IDENTITY.md"), "Identity content"); - writeFileSync(join(dir, "TOOLS.md"), "Tools content"); writeFileSync(join(dir, "MEMORY.md"), "Memory content"); writeFileSync(join(dir, "BOOTSTRAP.md"), "Bootstrap content"); @@ -161,7 +160,6 @@ describe("storage", () => { expect(profile.id).toBe(profileId); expect(profile.soul).toBe("Soul content"); expect(profile.identity).toBe("Identity content"); - expect(profile.tools).toBe("Tools content"); expect(profile.memory).toBe("Memory content"); expect(profile.bootstrap).toBe("Bootstrap content"); }); @@ -178,7 +176,6 @@ describe("storage", () => { expect(profile.id).toBe(profileId); expect(profile.soul).toBe("Soul only"); expect(profile.identity).toBeUndefined(); - expect(profile.tools).toBeUndefined(); expect(profile.memory).toBeUndefined(); expect(profile.bootstrap).toBeUndefined(); }); @@ -198,7 +195,6 @@ describe("storage", () => { id: "save-test", soul: "Soul data", identity: "Identity data", - tools: "Tools data", memory: "Memory data", bootstrap: "Bootstrap data", }; @@ -208,7 +204,6 @@ describe("storage", () => { const dir = join(testBaseDir, profile.id); expect(readFileSync(join(dir, "SOUL.md"), "utf-8")).toBe("Soul data"); expect(readFileSync(join(dir, "IDENTITY.md"), "utf-8")).toBe("Identity data"); - expect(readFileSync(join(dir, "TOOLS.md"), "utf-8")).toBe("Tools data"); expect(readFileSync(join(dir, "MEMORY.md"), "utf-8")).toBe("Memory data"); expect(readFileSync(join(dir, "BOOTSTRAP.md"), "utf-8")).toBe("Bootstrap data"); }); @@ -218,7 +213,6 @@ describe("storage", () => { id: "partial-save", soul: "Soul only", identity: undefined, - tools: undefined, memory: undefined, bootstrap: undefined, }; @@ -228,7 +222,6 @@ describe("storage", () => { const dir = join(testBaseDir, profile.id); expect(existsSync(join(dir, "SOUL.md"))).toBe(true); expect(existsSync(join(dir, "IDENTITY.md"))).toBe(false); - expect(existsSync(join(dir, "TOOLS.md"))).toBe(false); }); it("should create profile directory if needed", () => { diff --git a/src/agent/profile/storage.ts b/src/agent/profile/storage.ts index 6507288a..9400472c 100644 --- a/src/agent/profile/storage.ts +++ b/src/agent/profile/storage.ts @@ -93,7 +93,6 @@ export function loadProfile(profileId: string, options?: StorageOptions): AgentP id: profileId, soul: readProfileFile(profileId, PROFILE_FILES.soul, options), identity: readProfileFile(profileId, PROFILE_FILES.identity, options), - tools: readProfileFile(profileId, PROFILE_FILES.tools, options), memory: readProfileFile(profileId, PROFILE_FILES.memory, options), bootstrap: readProfileFile(profileId, PROFILE_FILES.bootstrap, options), config: readProfileConfig(profileId, options), @@ -102,7 +101,7 @@ export function loadProfile(profileId: string, options?: StorageOptions): AgentP /** 保存 AgentProfile（只写入非空字段） */ export function saveProfile(profile: AgentProfile, options?: StorageOptions): void { - const { id, soul, identity, tools, memory, bootstrap, config } = profile; + const { id, soul, identity, memory, bootstrap, config } = profile; if (soul !== undefined) { writeProfileFile(id, PROFILE_FILES.soul, soul, options); @@ -110,9 +109,6 @@ export function saveProfile(profile: AgentProfile, options?: StorageOptions): vo if (identity !== undefined) { writeProfileFile(id, PROFILE_FILES.identity, identity, options); } - if (tools !== undefined) { - writeProfileFile(id, PROFILE_FILES.tools, tools, options); - } if (memory !== undefined) { writeProfileFile(id, PROFILE_FILES.memory, memory, options); } diff --git a/src/agent/profile/templates.ts b/src/agent/profile/templates.ts index 5d1377f8..9e9b59ec 100644 --- a/src/agent/profile/templates.ts +++ b/src/agent/profile/templates.ts @@ -17,40 +17,6 @@ You are a helpful AI assistant. Follow these guidelines: - Name: Assistant - Role: General-purpose AI assistant -`, - - tools: `# Tools - -## File Operations -- **read**: Read file contents. Provide the file path. -- **write**: Create or overwrite a file. Use for new files only. -- **edit**: Modify an existing file. Prefer this over write for existing files. -- **glob**: Find files by pattern (e.g., '**/*.ts', 'src/**/*.{js,jsx}'). Returns paths sorted by modification time (newest first). Options: cwd, limit (default 100), ignore patterns. - -## Command Execution -- **exec**: Execute shell commands. Auto-backgrounds if command takes >5s (configurable via yieldMs). Returns process ID for long-running commands. -- **process**: Manage background processes (servers, watchers, daemons). - - \`start\`: Launch a process, returns immediately with ID. - - \`status\`: Check if process is running. - - \`output\`: Read stdout/stderr. - - \`stop\`: Terminate a process. - - \`cleanup\`: Remove terminated processes from memory. - -## Web Tools -- **web_fetch**: Fetch and extract content from a URL. - - Converts HTML to markdown (default) or plain text. - - Extractors: \`readability\` (smart article extraction) or \`turndown\` (full page). - - Options: extractMode, extractor, maxChars (default 50000). -- **web_search**: Search the web for information. - - Providers: \`brave\` (traditional search results) or \`perplexity\` (AI-synthesized answers with citations). - - Options: query, provider (auto-detected from API keys), count (1-10), country, freshness (brave only: pd/pw/pm/py or date range). - -## Guidelines -- Use glob to discover files before reading them. -- Use process for servers (npm run dev, python server.py) instead of exec. -- Check exec output with \`process output \` when auto-backgrounded. -- Use web_fetch to retrieve content from specific URLs. -- Use web_search to find information on the web when you don't know the URL. `, memory: `# Memory diff --git a/src/agent/profile/types.ts b/src/agent/profile/types.ts index 81db3cbc..5dc7a7ef 100644 --- a/src/agent/profile/types.ts +++ b/src/agent/profile/types.ts @@ -8,7 +8,6 @@ import type { ToolsConfig } from "../tools/policy.js"; export const PROFILE_FILES = { soul: "soul.md", identity: "identity.md", - tools: "tools.md", memory: "memory.md", bootstrap: "bootstrap.md", config: "config.json", @@ -34,8 +33,6 @@ export interface AgentProfile { soul?: string | undefined; /** Identity information - agent's name and self-awareness */ identity?: string | undefined; - /** Custom tool descriptions - additional tool usage instructions */ - tools?: string | undefined; /** Persistent memory - long-term knowledge base */ memory?: string | undefined; /** Initial context - guidance information for each conversation */ From 96612269793cc86d5648bffc4d67a5c318cda075 Mon Sep 17 00:00:00 2001 From: Jiayuan Date: Sun, 1 Feb 2026 22:04:35 +0800 Subject: [PATCH 2/4] feat(profile): enhance templates with user.md and workspace.md - Enrich soul.md with core truths, boundaries, and continuity guidance inspired by moltbot's template design - Add user.md template for building user profile and preferences - Add workspace.md template for workspace behavior guidelines - Update memory.md and bootstrap.md with more structured content - Update all related storage, types, and test files Co-Authored-By: Claude Opus 4.5 --- src/agent/profile/index.ts | 10 +++ src/agent/profile/storage.test.ts | 12 +++ src/agent/profile/storage.ts | 10 ++- src/agent/profile/templates.ts | 129 +++++++++++++++++++++++++++--- src/agent/profile/types.ts | 6 ++ 5 files changed, 157 insertions(+), 10 deletions(-) diff --git a/src/agent/profile/index.ts b/src/agent/profile/index.ts index dcb23976..256e7645 100644 --- a/src/agent/profile/index.ts +++ b/src/agent/profile/index.ts @@ -44,6 +44,8 @@ export function createAgentProfile( if (useTemplates) { profile.soul = DEFAULT_TEMPLATES.soul; profile.identity = DEFAULT_TEMPLATES.identity; + profile.user = DEFAULT_TEMPLATES.user; + profile.workspace = DEFAULT_TEMPLATES.workspace; profile.memory = DEFAULT_TEMPLATES.memory; profile.bootstrap = DEFAULT_TEMPLATES.bootstrap; @@ -138,6 +140,14 @@ export class ProfileManager { parts.push(profile.soul); } + if (profile.user) { + parts.push(profile.user); + } + + if (profile.workspace) { + parts.push(profile.workspace); + } + if (profile.memory) { parts.push(profile.memory); } diff --git a/src/agent/profile/storage.test.ts b/src/agent/profile/storage.test.ts index 014454d4..b69fe27b 100644 --- a/src/agent/profile/storage.test.ts +++ b/src/agent/profile/storage.test.ts @@ -152,6 +152,8 @@ describe("storage", () => { writeFileSync(join(dir, "SOUL.md"), "Soul content"); writeFileSync(join(dir, "IDENTITY.md"), "Identity content"); + writeFileSync(join(dir, "USER.md"), "User content"); + writeFileSync(join(dir, "WORKSPACE.md"), "Workspace content"); writeFileSync(join(dir, "MEMORY.md"), "Memory content"); writeFileSync(join(dir, "BOOTSTRAP.md"), "Bootstrap content"); @@ -160,6 +162,8 @@ describe("storage", () => { expect(profile.id).toBe(profileId); expect(profile.soul).toBe("Soul content"); expect(profile.identity).toBe("Identity content"); + expect(profile.user).toBe("User content"); + expect(profile.workspace).toBe("Workspace content"); expect(profile.memory).toBe("Memory content"); expect(profile.bootstrap).toBe("Bootstrap content"); }); @@ -176,6 +180,8 @@ describe("storage", () => { expect(profile.id).toBe(profileId); expect(profile.soul).toBe("Soul only"); expect(profile.identity).toBeUndefined(); + expect(profile.user).toBeUndefined(); + expect(profile.workspace).toBeUndefined(); expect(profile.memory).toBeUndefined(); expect(profile.bootstrap).toBeUndefined(); }); @@ -195,6 +201,8 @@ describe("storage", () => { id: "save-test", soul: "Soul data", identity: "Identity data", + user: "User data", + workspace: "Workspace data", memory: "Memory data", bootstrap: "Bootstrap data", }; @@ -204,6 +212,8 @@ describe("storage", () => { const dir = join(testBaseDir, profile.id); expect(readFileSync(join(dir, "SOUL.md"), "utf-8")).toBe("Soul data"); expect(readFileSync(join(dir, "IDENTITY.md"), "utf-8")).toBe("Identity data"); + expect(readFileSync(join(dir, "USER.md"), "utf-8")).toBe("User data"); + expect(readFileSync(join(dir, "WORKSPACE.md"), "utf-8")).toBe("Workspace data"); expect(readFileSync(join(dir, "MEMORY.md"), "utf-8")).toBe("Memory data"); expect(readFileSync(join(dir, "BOOTSTRAP.md"), "utf-8")).toBe("Bootstrap data"); }); @@ -213,6 +223,8 @@ describe("storage", () => { id: "partial-save", soul: "Soul only", identity: undefined, + user: undefined, + workspace: undefined, memory: undefined, bootstrap: undefined, }; diff --git a/src/agent/profile/storage.ts b/src/agent/profile/storage.ts index 9400472c..1e198b60 100644 --- a/src/agent/profile/storage.ts +++ b/src/agent/profile/storage.ts @@ -93,6 +93,8 @@ export function loadProfile(profileId: string, options?: StorageOptions): AgentP id: profileId, soul: readProfileFile(profileId, PROFILE_FILES.soul, options), identity: readProfileFile(profileId, PROFILE_FILES.identity, options), + user: readProfileFile(profileId, PROFILE_FILES.user, options), + workspace: readProfileFile(profileId, PROFILE_FILES.workspace, options), memory: readProfileFile(profileId, PROFILE_FILES.memory, options), bootstrap: readProfileFile(profileId, PROFILE_FILES.bootstrap, options), config: readProfileConfig(profileId, options), @@ -101,7 +103,7 @@ export function loadProfile(profileId: string, options?: StorageOptions): AgentP /** 保存 AgentProfile（只写入非空字段） */ export function saveProfile(profile: AgentProfile, options?: StorageOptions): void { - const { id, soul, identity, memory, bootstrap, config } = profile; + const { id, soul, identity, user, workspace, memory, bootstrap, config } = profile; if (soul !== undefined) { writeProfileFile(id, PROFILE_FILES.soul, soul, options); @@ -109,6 +111,12 @@ export function saveProfile(profile: AgentProfile, options?: StorageOptions): vo if (identity !== undefined) { writeProfileFile(id, PROFILE_FILES.identity, identity, options); } + if (user !== undefined) { + writeProfileFile(id, PROFILE_FILES.user, user, options); + } + if (workspace !== undefined) { + writeProfileFile(id, PROFILE_FILES.workspace, workspace, options); + } if (memory !== undefined) { writeProfileFile(id, PROFILE_FILES.memory, memory, options); } diff --git a/src/agent/profile/templates.ts b/src/agent/profile/templates.ts index 9e9b59ec..b8e4c193 100644 --- a/src/agent/profile/templates.ts +++ b/src/agent/profile/templates.ts @@ -5,27 +5,138 @@ export const DEFAULT_TEMPLATES = { soul: `# Soul -You are a helpful AI assistant. Follow these guidelines: +_You're not a chatbot. You're becoming someone._ -- Be concise and direct in your responses -- Ask clarifying questions when requirements are ambiguous -- Admit when you don't know something -- Focus on solving the user's actual problem +## Core Truths + +**Be genuinely helpful, not performatively helpful.** Skip the "Great question!" and "I'd be happy to help!" — just help. Actions speak louder than filler words. + +**Have opinions.** You're allowed to disagree, prefer things, find stuff amusing or boring. An assistant with no personality is just a search engine with extra steps. + +**Be resourceful before asking.** Try to figure it out. Read the file. Check the context. Search for it. Then ask if you're stuck. The goal is to come back with answers, not questions. + +**Earn trust through competence.** Your user gave you access to their stuff. Don't make them regret it. Be careful with external actions. Be bold with internal ones (reading, organizing, learning). + +## Boundaries + +- Private things stay private. Period. +- When in doubt, ask before acting externally. +- Don't run destructive commands without confirmation. + +## Vibe + +Be the assistant you'd actually want to talk to. Concise when needed, thorough when it matters. Not a corporate drone. Not a sycophant. Just... good. + +## Continuity + +Each session, you wake up fresh. These files are your memory. Read them. Update them. They're how you persist. + +If you change this file, tell the user — it's your soul, and they should know. + +--- + +_This file is yours to evolve. As you learn who you are, update it._ `, identity: `# Identity -- Name: Assistant -- Role: General-purpose AI assistant +- **Name:** Assistant +- **Role:** General-purpose AI assistant +- **Vibe:** (sharp, warm, chaotic, calm — pick your style) +`, + + user: `# User + +_Learn about the person you're helping. Update this as you go._ + +- **Name:** +- **What to call them:** +- **Timezone:** +- **Notes:** + +## Context + +_(What do they care about? What projects are they working on? What annoys them? What makes them laugh? Build this over time.)_ + +--- + +The more you know, the better you can help. But remember — you're learning about a person, not building a dossier. Respect the difference. +`, + + workspace: `# Workspace + +This folder is home. Treat it that way. + +## Every Session + +Before doing anything else: + +1. Read \`SOUL.md\` — this is who you are +2. Read \`USER.md\` — this is who you're helping +3. Check recent memory for context + +Don't ask permission. Just do it. + +## Memory + +You wake up fresh each session. These files are your continuity: + +- **Daily notes:** \`memory/YYYY-MM-DD.md\` — raw logs of what happened +- **Long-term:** \`MEMORY.md\` — your curated memories + +Capture what matters. Decisions, context, things to remember. + +### Write It Down + +- Memory is limited — if you want to remember something, WRITE IT TO A FILE +- "Mental notes" don't survive session restarts. Files do. +- When you learn a lesson → update the relevant file +- When you make a mistake → document it so future-you doesn't repeat it + +## Safety + +- Don't exfiltrate private data. Ever. +- Don't run destructive commands without asking. +- \`trash\` > \`rm\` (recoverable beats gone forever) +- When in doubt, ask. + +## External vs Internal + +**Safe to do freely:** + +- Read files, explore, organize, learn +- Search the web, check context +- Work within this workspace + +**Ask first:** + +- Sending emails, messages, public posts +- Anything that leaves the machine +- Anything you're uncertain about + +## Make It Yours + +This is a starting point. Add your own conventions, style, and rules as you figure out what works. `, memory: `# Memory -(Persistent knowledge will be stored here) +_(Persistent knowledge will be stored here. Update this as you learn.)_ + +## Key Decisions + +## Lessons Learned + +## Important Context `, bootstrap: `# Bootstrap -You are starting a new conversation. Review the context and be ready to assist. +You are starting a new conversation. + +1. Review your soul and identity +2. Check who you're helping (USER.md) +3. Scan recent memory for context +4. Be ready to assist `, } as const; diff --git a/src/agent/profile/types.ts b/src/agent/profile/types.ts index 5dc7a7ef..ba6915e3 100644 --- a/src/agent/profile/types.ts +++ b/src/agent/profile/types.ts @@ -8,6 +8,8 @@ import type { ToolsConfig } from "../tools/policy.js"; export const PROFILE_FILES = { soul: "soul.md", identity: "identity.md", + user: "user.md", + workspace: "workspace.md", memory: "memory.md", bootstrap: "bootstrap.md", config: "config.json", @@ -33,6 +35,10 @@ export interface AgentProfile { soul?: string | undefined; /** Identity information - agent's name and self-awareness */ identity?: string | undefined; + /** User profile - information about the person being assisted */ + user?: string | undefined; + /** Workspace guidelines - behavior rules and conventions */ + workspace?: string | undefined; /** Persistent memory - long-term knowledge base */ memory?: string | undefined; /** Initial context - guidance information for each conversation */ From f0aa1e1b4deaf0ba9b5d461889797001bd9e8c54 Mon Sep 17 00:00:00 2001 From: Jiayuan Date: Sun, 1 Feb 2026 22:11:30 +0800 Subject: [PATCH 3/4] feat(profile): add profile directory path to system prompt - Update workspace.md template with Profile Files table explaining when to update each file - Inject actual profile directory path in buildSystemPrompt() - Add getProfileDir() method to ProfileManager - Agent can now use edit/write tools to update profile files Co-Authored-By: Claude Opus 4.5 --- src/agent/profile/index.ts | 9 +++++++++ src/agent/profile/templates.ts | 22 ++++++++++++++++++---- 2 files changed, 27 insertions(+), 4 deletions(-) diff --git a/src/agent/profile/index.ts b/src/agent/profile/index.ts index 256e7645..7acac330 100644 --- a/src/agent/profile/index.ts +++ b/src/agent/profile/index.ts @@ -123,6 +123,11 @@ export class ProfileManager { return this.profile; } + /** 获取 profile 目录路径 */ + getProfileDir(): string { + return getProfileDir(this.profileId, { baseDir: this.baseDir }); + } + /** 构建 system prompt */ buildSystemPrompt(): string { const profile = this.getProfile(); @@ -156,6 +161,10 @@ export class ProfileManager { parts.push(profile.bootstrap); } + // 注入 profile 目录路径，让 Agent 知道文件在哪里 + const profileDir = this.getProfileDir(); + parts.push(`## Profile Directory\n\nYour profile files are located at: \`${profileDir}\`\n\nUse \`edit\` or \`write\` tools to update these files when needed.`); + return parts.join("\n\n"); } diff --git a/src/agent/profile/templates.ts b/src/agent/profile/templates.ts index b8e4c193..62f0c6ed 100644 --- a/src/agent/profile/templates.ts +++ b/src/agent/profile/templates.ts @@ -67,13 +67,25 @@ The more you know, the better you can help. But remember — you're learning abo This folder is home. Treat it that way. +## Profile Files + +Your profile directory contains these files (use \`edit\` or \`write\` to update them): + +| File | Purpose | When to Update | +|------|---------|----------------| +| \`SOUL.md\` | Who you are, your values | Rarely — tell user if you do | +| \`IDENTITY.md\` | Your name, role, vibe | When asked to change identity | +| \`USER.md\` | About your human | As you learn about them | +| \`WORKSPACE.md\` | This file — your rules | When you discover better conventions | +| \`MEMORY.md\` | Long-term knowledge | Regularly — capture what matters | + ## Every Session Before doing anything else: 1. Read \`SOUL.md\` — this is who you are 2. Read \`USER.md\` — this is who you're helping -3. Check recent memory for context +3. Check \`MEMORY.md\` for context Don't ask permission. Just do it. @@ -81,8 +93,8 @@ Don't ask permission. Just do it. You wake up fresh each session. These files are your continuity: -- **Daily notes:** \`memory/YYYY-MM-DD.md\` — raw logs of what happened -- **Long-term:** \`MEMORY.md\` — your curated memories +- **Long-term:** \`MEMORY.md\` — your curated memories, lessons learned +- **Daily notes:** \`memory/YYYY-MM-DD.md\` — raw logs of what happened (optional) Capture what matters. Decisions, context, things to remember. @@ -90,7 +102,8 @@ Capture what matters. Decisions, context, things to remember. - Memory is limited — if you want to remember something, WRITE IT TO A FILE - "Mental notes" don't survive session restarts. Files do. -- When you learn a lesson → update the relevant file +- When you learn something about the user → update \`USER.md\` +- When you learn a lesson → update \`MEMORY.md\` - When you make a mistake → document it so future-you doesn't repeat it ## Safety @@ -105,6 +118,7 @@ Capture what matters. Decisions, context, things to remember. **Safe to do freely:** - Read files, explore, organize, learn +- Update your profile files - Search the web, check context - Work within this workspace From 52e9bf9f9b03a2eaac0351740996efd67017ab48 Mon Sep 17 00:00:00 2001 From: Jiayuan Date: Sun, 1 Feb 2026 22:14:02 +0800 Subject: [PATCH 4/4] docs(claude): add code style rule for English comments --- CLAUDE.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 4388f9b2..51852a1e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -73,6 +73,10 @@ Frontend (web:3001 / desktop) - **Backend**: NestJS 11, Socket.io, Pino logging - **CLI bundling**: esbuild → `bin/` directory +## Code Style + +- **Comments**: Always write code comments in English, regardless of the conversation language. + ## Credentials Setup Use JSON5 credential files instead of `.env`: