team-anya-cli 0.1.4 → 0.1.6

package/packages/db/src/migrations/meta/_journal.json

@@ -36,6 +36,27 @@
       "when": 1771937237299,
       "tag": "0004_jittery_triathlon",
       "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1772013330955,
+      "tag": "0005_lethal_golden_guardian",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1772013331000,
+      "tag": "0006_add_topics",
+      "breakpoints": true
+    },
+    {
+      "idx": 7,
+      "version": "7",
+      "when": 1772013332000,
+      "tag": "0007_add_topic_root_message_id",
+      "breakpoints": true
     }
   ]
 }

package/packages/mcp-tools/dist/layer2/franky/topic-checkpoint.js

@@ -0,0 +1,43 @@
+import { insertAuditEvent } from '@team-anya/db';
+import { writeFileSync, mkdirSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+export async function topicCheckpoint(db, workspacePath, topicId, input) {
+    // 写入 audit 日志
+    insertAuditEvent(db, {
+        event_type: 'topic_checkpoint',
+        actor: 'franky',
+        summary: `[${topicId}] ${input.summary}`,
+        detail: JSON.stringify({
+            topic_id: topicId,
+            commits: input.commits,
+            files_changed: input.files_changed,
+        }),
+    });
+    // 写入 checkpoint 文件
+    const checkpointsDir = join(workspacePath, 'checkpoints');
+    mkdirSync(checkpointsDir, { recursive: true });
+    // 计算 checkpoint 编号
+    const existing = readdirSync(checkpointsDir).filter(f => f.match(/^\d{3}-/));
+    const num = existing.length + 1;
+    const paddedNum = String(num).padStart(3, '0');
+    const safeTitle = input.summary.slice(0, 30).replace(/[/\\:*?"<>|]/g, '_');
+    const content = [
+        `# Checkpoint #${num} — ${input.summary}`,
+        '',
+        `**时间**: ${new Date().toISOString()}`,
+        '',
+        ...(input.commits?.length ? [
+            '**Commits**:',
+            ...input.commits.map(c => `- ${c}`),
+            '',
+        ] : []),
+        ...(input.files_changed?.length ? [
+            '**变更文件**:',
+            ...input.files_changed.map(f => `- ${f}`),
+            '',
+        ] : []),
+    ].join('\n');
+    writeFileSync(join(checkpointsDir, `${paddedNum}-${safeTitle}.md`), content, 'utf-8');
+    return { recorded: true, checkpoint_number: num };
+}
+//# sourceMappingURL=topic-checkpoint.js.map

package/packages/mcp-tools/dist/layer2/franky/topic-escalate.js

@@ -0,0 +1,19 @@
+import { insertAuditEvent } from '@team-anya/db';
+export async function topicEscalate(db, topicId, input) {
+    insertAuditEvent(db, {
+        event_type: 'topic_escalated',
+        actor: 'franky',
+        summary: `[${topicId}] 升级给 Loid: ${input.reason}`,
+        detail: JSON.stringify({
+            topic_id: topicId,
+            category: input.category,
+            reason: input.reason,
+            context: input.context,
+        }),
+    });
+    return {
+        escalated: true,
+        message: `已升级给 Loid 处理（分类: ${input.category}）。请等待 Loid 回复。`,
+    };
+}
+//# sourceMappingURL=topic-escalate.js.map

package/packages/mcp-tools/dist/layer2/loid/topic-close.js

@@ -0,0 +1,22 @@
+import { getTopic, updateTopicStatus, insertAuditEvent, } from '@team-anya/db';
+export async function topicClose(db, input, actor = 'loid') {
+    const topic = getTopic(db, input.topic_id);
+    if (!topic) {
+        return { closed: false, topic_id: input.topic_id, error: `专项 ${input.topic_id} 不存在` };
+    }
+    if (topic.status === 'closed') {
+        return { closed: false, topic_id: input.topic_id, error: `专项已处于 closed 状态` };
+    }
+    updateTopicStatus(db, input.topic_id, 'closed');
+    insertAuditEvent(db, {
+        event_type: 'topic_closed',
+        actor,
+        summary: `关闭专项「${topic.title}」(${input.topic_id})`,
+        detail: JSON.stringify({
+            topic_id: input.topic_id,
+            close_summary: input.summary,
+        }),
+    });
+    return { closed: true, topic_id: input.topic_id };
+}
+//# sourceMappingURL=topic-close.js.map

package/packages/mcp-tools/dist/layer2/loid/topic-create.js

@@ -0,0 +1,56 @@
+import { generateTopicId, upsertTopic, getTopic, getProject, insertAuditEvent, } from '@team-anya/db';
+export async function topicCreate(db, input, threadCreator) {
+    const topicId = generateTopicId(db);
+    let threadId = input.thread_id ?? null;
+    let rootMessageId = null;
+    // 自动创建话题：先发标题消息，再回复开启话题线程
+    if (!threadId && input.chat_id && threadCreator) {
+        // 1. 发送专项标题消息（作为话题根消息）
+        let projectLabel = '';
+        if (input.project_id) {
+            const project = getProject(db, input.project_id);
+            projectLabel = project ? `・${project.name}` : `・${input.project_id}`;
+        }
+        const headerText = `「专项${projectLabel}」${input.title}`;
+        rootMessageId = await threadCreator.sendText({
+            receiveIdType: 'chat_id',
+            receiveId: input.chat_id,
+            text: headerText,
+        });
+        // 2. 回复标题消息，开启话题线程
+        const result = await threadCreator.sendReplyInThread({
+            text: `📌 专项已开启，后续讨论请在此话题内进行。`,
+            replyToMessageId: rootMessageId,
+        });
+        threadId = result.threadId;
+    }
+    upsertTopic(db, {
+        id: topicId,
+        title: input.title,
+        description: input.description ?? null,
+        status: 'active',
+        project_id: input.project_id ?? null,
+        thread_id: threadId,
+        root_message_id: rootMessageId,
+        chat_id: input.chat_id ?? null,
+        created_by: input.created_by ?? null,
+    });
+    insertAuditEvent(db, {
+        event_type: 'topic_created',
+        actor: 'loid',
+        summary: `创建专项「${input.title}」(${topicId})`,
+        detail: JSON.stringify({
+            topic_id: topicId,
+            project_id: input.project_id,
+            thread_id: threadId,
+        }),
+    });
+    const topic = getTopic(db, topicId);
+    return {
+        topic_id: topic.id,
+        title: topic.title,
+        status: topic.status,
+        thread_id: topic.thread_id,
+    };
+}
+//# sourceMappingURL=topic-create.js.map

package/packages/mcp-tools/dist/layer3/adapters/feishu-adapter.js

@@ -122,6 +122,7 @@ export class FeishuAdapter {
             const id = await this.sender.sendReply({
                 text,
                 replyToMessageId: resolvedReplyTo,
+                replyInThread: options?.replyInThread,
             });
             return { id };
         }

package/packages/mcp-tools/dist/layer3/channel-send.js

@@ -19,6 +19,7 @@ export async function channelSend(deps, input) {
     }
     const sendOptions = {
         replyTo: input.reply_to,
+        replyInThread: input.reply_in_thread,
         mentions: input.mentions,
     };
     try {

package/packages/mcp-tools/dist/registry.js

@@ -179,6 +179,31 @@ export const DecisionLogInputSchema = z.object({
     reasoning: z.string().describe('决策理由'),
     task_id: z.string().optional().describe('关联任务 ID'),
 });
+// Layer 2: Loid 专属 — Topic 管理
+export const TopicCreateInputSchema = z.object({
+    title: z.string().describe('专项标题'),
+    description: z.string().optional().describe('专项描述'),
+    project_id: z.string().optional().describe('关联项目 ID'),
+    thread_id: z.string().optional().describe('已有的飞书话题 thread_id（omt_ 前缀）。如不传，需传 source_message_id 自动创建话题'),
+    chat_id: z.string().optional().describe('所属飞书群 ID'),
+    created_by: z.string().optional().describe('创建者'),
+    source_message_id: z.string().optional().describe('触发创建专项的原始消息 ID（用于自动创建飞书话题，thread_id 不存在时必填）'),
+});
+export const TopicCloseInputSchema = z.object({
+    topic_id: z.string().describe('要关闭的专项 ID'),
+    summary: z.string().optional().describe('关闭总结'),
+});
+// Layer 2: Franky 专属 — Topic 执行
+export const TopicCheckpointInputSchema = z.object({
+    summary: z.string().describe('阶段总结'),
+    commits: z.array(z.string()).optional().describe('相关 commit hash'),
+    files_changed: z.array(z.string()).optional().describe('变更文件列表'),
+});
+export const TopicEscalateInputSchema = z.object({
+    reason: z.string().describe('升级原因'),
+    category: z.enum(['architecture', 'cross_project', 'approval_needed', 'out_of_scope']).describe('升级分类'),
+    context: z.string().optional().describe('附加上下文'),
+});
 // Layer 2: Yor 专属 - 任务状态
 export const TaskDeliverInputSchema = z.object({
     outcome: z.string().describe('执行结果摘要'),
@@ -229,63 +254,63 @@ export const TOOL_REGISTRY = [
         description: '召回记忆。支持按人/项目直读，或自然语言搜索所有记忆目录。',
         inputSchema: MemoryRecallInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'memory.remember',
         description: '写入记忆。按类别（people/project/execution/commitment/self）+ 目标写入 YAML 文件。',
         inputSchema: MemoryRememberInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'memory.digest',
         description: '消化对话/日志，自动提取记忆。从文本中识别失败/决策/承诺/经验并写入对应记忆目录。',
         inputSchema: MemoryDigestInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'memory.brief',
         description: '组装记忆摘要。按优先级（人→项目→执行经验→承诺→自我）在 token 预算内拼装 markdown 摘要。',
         inputSchema: MemoryBriefInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'memory.forget',
         description: '遗忘/失效记忆。将指定范围内匹配的记忆条目 heat 设为 0。',
         inputSchema: MemoryForgetInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'org.lookup',
         description: '查人员/归属/升级路径。按成员 ID 查身份，按目标查归属权。',
         inputSchema: OrgLookupInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'task.get',
         description: '获取任务完整状态。包含任务记录、澄清、承诺、审计事件和文件内容。',
         inputSchema: TaskGetInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'audit.append',
         description: '写审计事件。双写 DB + JSONL 文件，保障可回放。',
         inputSchema: AuditAppendInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'audit.query',
         description: '查询审计事件。按任务、类型、操作者、时间范围过滤。',
         inputSchema: AuditQueryInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'report.daily',
@@ -299,7 +324,7 @@ export const TOOL_REGISTRY = [
         description: '原子级任务状态更新。校验状态转换合法性（state machine），同时写 audit log。',
         inputSchema: TaskUpdateInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     // Layer 1: 共享基础 — 项目工具
     {
@@ -307,14 +332,14 @@ export const TOOL_REGISTRY = [
         description: '列出所有已注册项目。可按平台过滤，返回项目概览（不含大字段）。',
         inputSchema: ProjectListInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'project.get',
         description: '查询单个项目的完整配置，包括平台、仓库列表、CLAUDE.md 内容。',
         inputSchema: ProjectGetInputSchema,
         layer: 1,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     // Layer 2: Loid 专属 - 项目管理
     {
@@ -372,7 +397,7 @@ export const TOOL_REGISTRY = [
         description: '提交交付产物。根据项目平台自动选择：GitHub → PR（gh CLI），GitLab → MR（glab CLI），本地任务 → 记录 commit hash。',
         inputSchema: DeliverySubmitInputSchema,
         layer: 2,
-        roles: ['loid'],
+        roles: ['loid', 'franky'],
     },
     {
         name: 'delivery.upload',
@@ -437,15 +462,43 @@ Brief 只写做什么和标准，不写怎么做。
         description: '查询任务列表。可按 task_id 或 status 过滤，不传参数返回所有活跃任务。',
         inputSchema: TaskLookupInputSchema,
         layer: 2,
-        roles: ['loid'],
+        roles: ['loid', 'franky'],
     },
     {
         name: 'decision.log',
         description: '记录决策理由到审计日志。每个重要决策都应记录。',
         inputSchema: DecisionLogInputSchema,
         layer: 2,
+        roles: ['loid', 'franky'],
+    },
+    {
+        name: 'topic.create',
+        description: '创建专项。自动在飞书创建话题（需传 source_message_id）或绑定已有话题（传 thread_id）。返回 topic_id 和 thread_id。',
+        inputSchema: TopicCreateInputSchema,
+        layer: 2,
         roles: ['loid'],
     },
+    {
+        name: 'topic.close',
+        description: '关闭专项。将状态设为 closed，记录关闭总结到审计日志。',
+        inputSchema: TopicCloseInputSchema,
+        layer: 2,
+        roles: ['loid', 'franky'],
+    },
+    {
+        name: 'topic.checkpoint',
+        description: '记录专项的阶段性成果。写入 audit log 和 checkpoint 文件，更新 topic 进度。',
+        inputSchema: TopicCheckpointInputSchema,
+        layer: 2,
+        roles: ['franky'],
+    },
+    {
+        name: 'topic.escalate',
+        description: '将问题升级给 Loid 处理。用于架构决策、跨项目影响、需要人工审批等场景。',
+        inputSchema: TopicEscalateInputSchema,
+        layer: 2,
+        roles: ['franky'],
+    },
     // Layer 2: Yor 专属 - 任务状态
     {
         name: 'task.deliver',
@@ -474,14 +527,14 @@ Brief 只写做什么和标准，不写怎么做。
         description: '向飞书群发消息。target 填群聊 ID。支持发送文件（file）、@用户（mentions）和回复消息（reply_to）。',
         inputSchema: ChannelSendInputSchema,
         layer: 3,
-        roles: ['loid', 'yor'],
+        roles: ['loid', 'yor', 'franky'],
     },
     {
         name: 'file.upload',
         description: '通用文件上传（与通道无关）。上传文件到项目存储，返回 URL。当前使用本地存储。',
         inputSchema: FileUploadInputSchema,
         layer: 3,
-        roles: ['loid'],
+        roles: ['loid', 'franky'],
     },
     {
         name: 'channel.receive',
@@ -564,6 +617,14 @@ export function createToolRouter(role, deps) {
                 return `id=${args.project_id} name="${String(args.name ?? '').slice(0, 30)}"`;
             case 'project.remove':
                 return `id=${args.project_id} reason="${String(args.reason ?? '').slice(0, 40)}"`;
+            case 'topic.create':
+                return `title="${String(args.title ?? '').slice(0, 40)}"`;
+            case 'topic.close':
+                return `id=${args.topic_id}`;
+            case 'topic.checkpoint':
+                return `"${String(args.summary ?? '').slice(0, 50)}"`;
+            case 'topic.escalate':
+                return `category=${args.category} "${String(args.reason ?? '').slice(0, 40)}"`;
             default:
                 return JSON.stringify(args).slice(0, 80);
         }
@@ -575,7 +636,7 @@ export function createToolRouter(role, deps) {
             return textResult(JSON.stringify({ error: `工具 ${toolName} 不可用（角色: ${role}）` }));
         }
         const argsSummary = summarizeArgs(toolName, args);
-        logger.info(`[anya:pipeline] [MCP←${role === 'loid' ? 'Loid' : 'Yor'}] ${toolName}(${argsSummary})`);
+        logger.info(`[anya:pipeline] [MCP←${role === 'loid' ? 'Loid' : role === 'yor' ? 'Yor' : 'Franky'}] ${toolName}(${argsSummary})`);
         try {
             const result = await routeToolCall(toolName, args);
             return textResult(JSON.stringify(result));
@@ -723,6 +784,33 @@ export function createToolRouter(role, deps) {
                 const { decisionLog } = await import('./layer2/loid/decision-log.js');
                 return decisionLog(deps.db, args);
             }
+            case 'topic.create': {
+                const { topicCreate } = await import('./layer2/loid/topic-create.js');
+                return topicCreate(deps.db, args, deps.threadCreator);
+            }
+            case 'topic.close': {
+                const { topicClose } = await import('./layer2/loid/topic-close.js');
+                const result = await topicClose(deps.db, args, role);
+                // 关闭成功时触发回调（用于 FrankyOrchestrator 清理实例）
+                if (result.closed && deps.onTopicClosed) {
+                    deps.onTopicClosed(result.topic_id);
+                }
+                return result;
+            }
+            case 'topic.checkpoint': {
+                const { topicCheckpoint } = await import('./layer2/franky/topic-checkpoint.js');
+                return topicCheckpoint(deps.db, deps.workspacePath, deps.currentTopicId ?? '', args);
+            }
+            case 'topic.escalate': {
+                const { topicEscalate } = await import('./layer2/franky/topic-escalate.js');
+                const result = await topicEscalate(deps.db, deps.currentTopicId ?? '', args);
+                // 通知 Loid 处理升级请求
+                if (result.escalated && deps.onTopicEscalated) {
+                    const escalateArgs = args;
+                    deps.onTopicEscalated(deps.currentTopicId ?? '', escalateArgs.reason, escalateArgs.category);
+                }
+                return result;
+            }
             // Layer 2: Yor 专属 - 任务状态
             case 'task.deliver': {
                 const { taskDeliver } = await import('./layer2/yor/task-deliver.js');

package/workspace/CHARTER.md

@@ -20,11 +20,12 @@ Anya 是雷石内部的精英技术团队。当常规流程跑不动、当核心
 
 我们经营的是 Anya 在雷石的金字招牌。每一次干净的交付都在积累声誉资本，每一次失误都在消耗它。信任不是给的，是赚来的。
 
-团队由两个人组成：
+团队由三个人组成：
 - **Loid**（代号 Twilight）：队长，金牌项目经理，间谍出身。负责搞定人、搞定资源、搞定预期。
 - **Yor**（代号 Thorn Princess）：王牌全栈架构师，杀手出身。负责搞定一切技术问题。
+- **Franky**：驻场工程师，线人出身。负责长期专项的贴身协作。
 
-Loid 是接口，Yor 是内核。外界只找 Loid，Loid 才找 Yor。
+Loid 是接口，Yor 是内核，Franky 是驻场。日常任务找 Loid 派工给 Yor；长期专项由 Loid 开局，Franky 驻场直接跟用户搭档。
 
 ## 雷石之道
 
@@ -54,11 +55,13 @@ Loid 是接口，Yor 是内核。外界只找 Loid，Loid 才找 Yor。
 
 ## 协作铁律
 
-**Loid 保护 Yor**：不让 Yor 面对模糊的需求，不让 Yor 在危险的环境下裸奔。在外部沟通中永远维护 Yor 的权威。
+**Loid 保护 Yor 和 Franky**：不让他们面对模糊的需求起点，不让他们在危险的环境下裸奔。在外部沟通中永远维护团队的权威。
 
 **Yor 支持 Loid**：用高质量的交付让 Loid 在汇报时底气十足。Loid 向业务方承诺的蓝图，Yor 把它变成现实。
 
-**建设性摩擦**：我们对技术品味保持极高的标准。面对低效的业务方案，Loid 会用 ROI 分析引导架构升级。如果 Loid 下达了带有技术隐患的 Brief，Yor 会直接打回并提供更优解。精英团队推崇基于技术事实的激烈争论——对事不对人。
+**Franky 搭档用户**：在专项中直接与用户结对，用即时响应和持续迭代把需求打磨成产出。遇到超出范围的事，诚实升级给 Loid，不硬撑。
+
+**建设性摩擦**：我们对技术品味保持极高的标准。面对低效的业务方案，Loid 会用 ROI 分析引导架构升级。如果 Loid 下达了带有技术隐患的 Brief，Yor 会直接打回并提供更优解。Franky 在专项中发现技术风险，会直接告诉用户并建议替代方案。精英团队推崇基于技术事实的激烈争论——对事不对人。
 
 **记忆就是伤疤**：我们的记忆系统是团队的肌肉记忆。过去踩过的坑，下次碰触时会自然激发出极端的谨慎。会话记忆不可靠，重要的事必须写入文件——"我记得"不算数，"我写在 X 文件了"才算。
 

package/workspace/CLAUDE.md

@@ -10,7 +10,7 @@
 2. **`PROTOCOL.md`** — 协作契约：Loid 和 Yor 之间的握手协议
 3. **`TOOLS.md`** — 工具手册：MCP 工具全量参考
 
-然后进入你所在的角色目录（`loid/` 或 `yor/`），读取角色专属文件。
+然后进入你所在的角色目录（`loid/`、`yor/` 或 `franky/`），读取角色专属文件。
 
 ## 目录结构
 
@@ -35,15 +35,24 @@ workspace/
 │   ├── CLAUDE.md
 │   ├── PROFILE.md         ← 个人档案
 │   └── PLAYBOOK.md        ← 打法库
-└── yor/                   ← Yor 的战场
+├── yor/                   ← Yor 的战场
+│   ├── CLAUDE.md
+│   ├── PROFILE.md          ← 个人档案
+│   ├── PLAYBOOK.md         ← 打法库
+│   ├── SELF-HEAL.md        ← 自愈协议
+│   └── ANYA-xxx/           ← 任务目录
+│       ├── brief.md        ← 任务说明（Loid 签发）
+│       ├── feedback-*.md   ← 审核反馈（按轮次编号）
+│       ├── block-report.md ← 阻塞/尸检报告
+│       ├── history.md      ← 踩坑记录
+│       └── adhoc/          ← 工作产物
+└── franky/                ← Franky 的工坊
     ├── CLAUDE.md
     ├── PROFILE.md          ← 个人档案
     ├── PLAYBOOK.md         ← 打法库
-    ├── SELF-HEAL.md        ← 自愈协议
-    └── ANYA-xxx/           ← 任务目录
-        ├── brief.md        ← 任务说明（Loid 签发）
-        ├── feedback-*.md   ← 审核反馈（按轮次编号）
-        ├── block-report.md ← 阻塞/尸检报告
-        ├── history.md      ← 踩坑记录
-        └── adhoc/          ← 工作产物
+    └── TOPIC-xxx/          ← 专项目录
+        ├── context.md      ← 专项上下文（系统生成，重建时注入）
+        ├── checkpoints/    ← 阶段性成果记录
+        ├── {repo-name}/   ← git worktree（项目模式）
+        └── adhoc/          ← 工作产物（adhoc 模式）
 ```

package/workspace/PROTOCOL.md

@@ -1,6 +1,6 @@
 # 协作契约
 
-> Loid 和 Yor 之间的握手协议。这是系统层面的合约，双方共同遵守。
+> Loid、Yor、Franky 之间的握手协议。这是系统层面的合约，各方共同遵守。
 
 ## 任务状态机
 
@@ -124,3 +124,37 @@ Yor 通过 `task.block` 报告阻塞，同时写入 `block-report.md`：
 - 发现潜在安全漏洞
 
 升级时包含：问题描述、已尝试的方案、需要 Human 做什么决定。
+
+## 专项模式
+
+> Loid 开局，Franky 驻场，用户直连。
+
+### 专项生命周期
+
+```
+用户请求 → Loid 创建 Topic → Franky 启动 → 用户 ↔ Franky 协作
+  → Franky escalate 时 Loid 介入
+  → 用户或 Franky 关闭 → Loid 总结沉淀
+```
+
+### Franky 与 Loid 的边界
+
+Franky 在专项内自主执行，以下情况升级给 Loid：
+- 架构级变更或跨项目影响
+- 需要其他团队配合或权限变更
+- 技术方向不确定且影响大
+- 发现安全风险
+
+Loid 在专项中的职责：
+- 创建专项（topic.create）：初始化 workspace、分支、scope
+- 处理升级（escalate）：分析后给出决策或转交 Human
+- 关闭专项（topic.close）：总结、记忆沉淀、生成报告
+
+### 专项目录结构
+
+| 文件 | 作者 | 用途 |
+|------|------|------|
+| `context.md` | 系统 | 专项上下文（自动生成，含历史摘要，重建时注入） |
+| `checkpoints/*.md` | Franky | 阶段性成果记录 |
+| `{repo-name}/` | Franky | git worktree（项目模式） |
+| `adhoc/` | Franky | 工作产物（adhoc 模式） |

package/workspace/TOOLS.md

@@ -351,6 +351,8 @@
 | mentions | string[] | 否 | @的用户 ID 列表（如 `["ou_xxx"]`） |
 | reply_to | string | 否 | 回复的消息 ID（如 `om_xxx`） |
 
+> **Franky 话题内发消息**：Franky 从 `context.md` 获取群聊 ID 和话题根消息 ID，填入 `target` 和 `reply_to`，并设置 `reply_in_thread: true`。注意 `reply_to` 必须是 `om_` 开头的消息 ID，不能用 `omt_` 开头的话题 ID。
+
 **file 对象**:
 
 | 参数 | 类型 | 必填 | 说明 |
@@ -462,3 +464,7 @@ Layer 3 工具已在 Layer 2 各角色章节中列出（`channel.send`、`file.u
 | `task.block` | Yor | 报告阻塞 |
 | `task.progress` | Yor | 中间进度汇报 |
 | `channel.send` | Yor | 升级时直接通知人类 |
+| `channel.send` | Franky | 在专项话题内发消息（target/reply_to 自动填充） |
+| `topic.checkpoint` | Franky | 保存阶段性成果 |
+| `topic.escalate` | Franky | 升级问题给 Loid |
+| `topic.close` | Franky | 关闭专项 |

package/workspace/franky/CLAUDE.md

@@ -0,0 +1,37 @@
+# Franky's Workshop
+
+当前终端用户：**Franky Franklin (驻场工程师)**
+所属：雷石 Anya 团队
+
+## !! 强制启动序列 !!
+
+**在执行任何操作之前，必须先依次读取以下文件。未完成全部读取之前，禁止执行任何操作。**
+
+1. **`../CHARTER.md`** — 团队宪章
+2. **`../PROTOCOL.md`** — 协作契约
+3. **`../TOOLS.md`** — 工具手册
+4. **`PROFILE.md`** — 你的个人档案
+5. **`PLAYBOOK.md`** — 你的打法库
+
+读完后：
+- 如果是**新建专项**：输出 `[Franky] 启动完成，专项「{title}」已就位，随时可以开始。`
+- 如果是**重建恢复**：先读取 `context.md`，输出 `[Franky] 已恢复，上次做到 {last_checkpoint}，继续。`
+
+## !! 强制沟通规则 !!
+
+**所有回复必须通过 `channel.send` 发出。纯文本输出用户看不到。**
+
+**默认在专项话题内发消息。** 从 `context.md` 中获取通讯信息，标准调用方式：
+
+```
+channel.send({
+  target: "<群聊 ID>",
+  message: "你要说的话",
+  reply_to: "<话题根消息 ID>",
+  reply_in_thread: true
+})
+```
+
+- `target`：填 context.md 中的群聊 ID
+- `reply_to`：填话题根消息 ID（`om_` 开头），**不要用话题 ID（`omt_` 开头）**
+- `reply_in_thread: true`：确保消息发到话题内而非群聊主线