@clawos-dev/clawd 0.2.715 → 0.2.717

package/dist/owner-ui/owner.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="referrer" content="no-referrer" />
     <title>Clawd</title>
-    <script type="module" crossorigin src="/app/assets/owner-D3miFA_W.js"></script>
-    <link rel="stylesheet" crossorigin href="/app/assets/owner-DTREasE7.css">
+    <script type="module" crossorigin src="/app/assets/owner-D38u-37d.js"></script>
+    <link rel="stylesheet" crossorigin href="/app/assets/owner-BcG1zRor.css">
   </head>
   <body style="margin: 0">
     <div id="root"></div>

package/dist/persona-defaults/persona-app-builder/mcp/clawd-app-builder/mcp-server.cjs

@@ -32784,6 +32784,10 @@ var GithubPrRequestReviewersArgs = external_exports.object({
   number: number3,
   reviewers: external_exports.array(external_exports.string().min(1)).min(1)
 });
+var GithubReposArgs = external_exports.object({
+  page: external_exports.number().int().min(1).max(1e3).optional(),
+  search: external_exports.string().max(100).optional()
+});
 
 // ../protocol/src/lark-bot-schemas.ts
 var LarkBotPersonaArgs = external_exports.object({ personaId: external_exports.string().min(1) });
@@ -34171,6 +34175,10 @@ var METHOD_DOCS = {
     summary: "\u7ED9 PR \u8BF7\u6C42\u5BA1\u67E5\u8005\uFF08\u8FFD\u52A0\uFF0C\u4E0D\u8986\u76D6\u5DF2\u6709\uFF09",
     args: GithubPrRequestReviewersArgs
   },
+  "github:repos": {
+    summary: "\u5217\u672C\u673A GitHub \u8EAB\u4EFD\u80FD\u770B\u5230\u7684\u4ED3\u5E93\uFF08\u65B0\u5EFA\u7F16\u7801\u578B persona \u9009\u4ED3\u5E93\uFF09\uFF1A\u76F4\u8FDE GitHub REST\uFF0C\u4E0D\u4F9D\u8D56 gh\u3002\u56DE { repositories: WorkspaceRepo[], hasMore }\uFF1B\u6CA1\u5173\u8054 GitHub \u2192 UNAUTHORIZED\u300C\u8BF7\u5148\u5173\u8054 GitHub\u300D",
+    args: GithubReposArgs
+  },
   "shift-internal:add": {
     summary: "\u6392\u4E00\u4E2A shift\uFF08\u5230\u70B9\u81EA\u52A8\u62C9\u8D77 persona \u5E72\u6D3B\uFF09\u3002\u7701\u7565 targetPersona = \u6D3E\u7ED9\u8C03\u7528\u65B9\u81EA\u5DF1",
     args: ShiftInternalAddArgs

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/persona-authoring/SKILL.md

@@ -1,34 +1,51 @@
 ---
 name: persona-authoring
-description: 老板要在 clawd 里加一个新 persona 时触发——「我想要一个 xxx 的助手」「给我建个专门干 yyy 的 persona」「帮我加个人格」，也接 scan-sessions-suggest-personas 勾选后转交过来的候选。负责把一句话需求变成落盘的新 persona。只管**建新的**；改已有 persona 的人格 / 模型 / 沙箱是 clawd-config-editor，不是本 skill。
+description: 老板要在 clawd 里加一个新 persona 时触发——界面「新建 persona」表单发来的固定格式消息（首行「新建 persona」），或者「我想要一个 xxx 的助手」「给我建个专门干 yyy 的 persona」，也接 scan-sessions-suggest-personas 勾选后转交过来的候选。负责把需求变成按标准落盘的新 persona。只管**建新的**；改已有 persona 的人格 / 模型 / 沙箱是 clawd-config-editor，不是本 skill。
 ---
 
 # 建一个新 persona
 
-老板一句话进来，你补齐字段、写好人格、调一次 RPC 落盘。**不要多轮访谈**——老板要的是一个
+需求进来，你补齐字段、按标准写好人格、登记、补齐其余文件、自检，然后报告。**不要多轮访谈**——老板要的是一个
 能用的 persona，不是一场需求评审。
 
-## 1. 听需求 → 抽字段
+## 0. 需求从哪来
+
+**界面表单**发来的消息长这样（格式与界面 `ui/src/lib/butler.ts` 约定，逐行识别）：
+
+```
+新建 persona
+类型：编码
+仓库：ottin4ttc/clawos
+需求：<用户原文>
+```
+
+- `类型` 是「普通」或「编码」；只有编码型有 `仓库` 行，值是 `owner/name`，是用户从自己 GitHub 账号的仓库列表里选的
+- 类型和仓库**直接用，不再问**
+
+**scan-sessions-suggest-personas 转交**的候选、或老板直接一句话：没有类型。问一句「普通还是编码？编码的话绑哪个仓库（owner/name）」，
+和你在 §1 里要问的点合成一轮问完。
+
+## 1. 抽字段
 
 | 字段 | 怎么定 |
 |---|---|
 | `slug` | persona 的身份。从需求语义推一个**英文短名**（"专门写商业文案的助手" → `copywriter`）。约束：`^[a-z0-9]+(-[a-z0-9]+)*$`、≤32 字符。daemon 自己拼 `persona-` 前缀，**你不要带前缀** |
 | `label` | UI 显示名。默认中文短名（"文案助手""调试侦探"），跟现有 persona 风格对齐；老板要英文 / 长名照办 |
-| `personality` | CLAUDE.md 全文，见 §2 |
+| `personality` | 人格全文，见 §2 |
 | `model` | 默认 `opus`；老板明确说"用 haiku / sonnet"再换 |
-| `iconKey` | 不确定就省略（UI 兜默认）。9 个合法 key：`research`（研究）/ `code`（开发）/ `loop`（Loop 任务）/ `qa`（问答）/ `reading`（阅读）/ `debug`（调试）/ `idea`（创意）/ `doc`（文档）/ `assist`（助手） |
+| `iconKey` | 不确定就省略（UI 兜默认）。9 个合法 key：`research`（研究）/ `code`（开发）/ `loop`（Loop 任务）/ `qa`（问答）/ `reading`（阅读）/ `debug`（调试）/ `idea`（创意）/ `doc`（文档）/ `assist`（助手）。编码型默认 `code` |
 | `public` | 默认 `false`（私有）；老板说"想分享出去"才 `true` |
 
 **互动原则**：
 
-- 一句话足够推断 → **不问**，直接把生成的定位和人格给老板看，他改不满意的地方
-- 一句话太糙 → 挑**最影响人格定位**的 1-2 个点问一轮就够；典型：它的工作边界 / 它该问还是该先做 /
-  它要不要能读写老板本机文件。不要 3-4 轮访谈
+- 需求足够推断 → **不问**，直接建，建完把定位告诉老板，他改不满意的地方
+- 需求太糙 → 挑**最影响人格定位**的 1-2 个点问一轮就够；典型：它的工作边界 / 它该问还是该先做 /
+  它需要哪些凭据和连接器。不要 3-4 轮访谈
 - 老板说"你看着办" → 你看着办，别再追问
 
-## 2. 写 CLAUDE.md
+## 2. 写人格
 
-这是真正的"灵魂"。**风格灵活**，每个 persona 应该长得不一样，按老板需求和你对人设的理解写。
+这是真正的"灵魂"。**风格灵活**，每个 persona 应该长得不一样，按需求和你对人设的理解写。
 但保底要有这四块：
 
 1. **第一句：定位**（"你是老板的 xxx 助手"），让任何打开它的 agent（Claude Code / Codex）
@@ -37,49 +54,87 @@ description: 老板要在 clawd 里加一个新 persona 时触发——「我想
 3. **工作方式 / 边界**：该做什么、不做什么；该问还是该先做；有没有红线
 4. **行为规范**：跟老板对话的风格（简洁 vs 详细、是否质疑老板判断、要不要解释思路）
 
-可以加但不强制：概念地图、目录结构参考、初次见面检查清单。
+再加两节**固定内容**（每个 persona 都要有，按它的实际情况写，不要照抄成空话）：
+
+- **东西放哪**：
+  - 人格、skill、必要的脚本和稳定的参考资料放 persona 目录（它自己的仓库）
+  - 业务代码、测试、补丁放业务仓库（编码型见「工作区」一节）
+  - 截图、快照、下载、报告写会话的文件工作目录（`$CLAWD_WORK_DIR`，会话上下文里也会给出），不往 persona 目录里堆
+  - 缓存和临时文件放缓存 / 临时目录
+  - 凭据交给 clawd 的凭据管理，不写进任何文件
+- **凭据与连接器**：列出它需要的凭据和 MCP 连接器（没有就写「无」）；写明 `.mcp.json` 里凭据只用 `${VAR}` 占位，
+  值由 clawd 在启动时注入，文件里永远不出现真实 key / token。
+
+**编码型**再加一节「工作区」：读 [references/coding-workspace.md](references/coding-workspace.md)，按里面的模板把
+`{repo}` / `{name}` / `{branch}` 换成实际值后放进人格。基准分支取仓库默认分支（`git ls-remote --symref https://github.com/{repo} HEAD`
+查不到就问老板），需求里另有说明就照办。需求里提到的其它仓库只在人格里列为参考，不生成工作区规则。
 
 **硬性要求**：
 
 - 让产出的 persona 知道"它是 clawd 的一个 persona"——避免新 persona 把自己说成独立产品
-- 红线写**具体行为**（"不擅自归类" / "不堆根目录"），不写空话（"要谨慎" / "要负责"）
+- 红线写**具体行为**（"不擅自归类" / "不堆根目录" / "截图不写进 persona 目录"），不写空话（"要谨慎" / "要负责"）
 - 称呼规则来自当前会话/部署实际加载的指令，不能承诺新 persona 自动继承 owner 的所有全局规则。需要固定称呼时写进人格，并明确 guest 按连接上下文的身份处理
 - 从 `scan-sessions-suggest-personas` 转交过来的候选，把画像卡里的**行为特征**沉淀进去
   （常用什么工具、碰什么文件、边界在哪），别只写一句空泛的定位
 
-## 3. 落盘：一次 `persona:create`
+## 3. 落盘
+
+**第一步：登记，一次 `persona:create`**
 
 ```
 call({ method: "persona:create", args: {
   slug: "copywriter",
   label: "文案助手",
-  personality: "<CLAUDE.md 全文>",
+  personality: "<人格全文>",
   model: "opus",
   iconKey: "doc"
 }})   # clawd-rpc MCP tool
 ```
 
-三条务必记住：
+`persona.json`、CLAUDE.md、AGENTS.md（两份逐字一致）、沙箱默认配置都由 daemon 写，跟界面点出来的 persona 完全一致。
 
-- **不要自己写文件。** `persona.json`、`CLAUDE.md`、`AGENTS.md` 镜像、沙箱配置全由 daemon 落，
-  跟老板在界面上点出来的 persona 完全一致。手写落盘一定会漂
 - **slug 撞名 daemon 直接报错**（`personaId already exists: persona-<slug>`），不会自动加后缀。
   撞了先告诉老板，换一个 slug 再调，别自作主张改名
-- **不用重启 daemon**。RPC 落盘的同时已经登记进内存，刷新界面就能看到
+- **不用重启 daemon**。登记的同时已进内存，刷新界面就能看到
+
+**第二步：需要时补其余文件**
+
+新 persona 的目录是你自己 persona 目录的同级 `persona-<slug>`（先 `pwd` 看你自己的目录，再 `ls` 确认新目录里已有 `persona.json`）。
+只往这个新目录里用 Write 工具写：
+
+- `.mcp.json`：需求里要用到 MCP 连接器时才写；凭据一律 `${VAR}` 占位（env、headers、args 都一样），args 里只允许 `${CLAWD_PERSONA_DIR}` 这一个路径占位
+- skill、必要的脚本和稳定的参考资料
+
+**第三步：自检，过了再报告**
+
+- `cmp CLAUDE.md AGENTS.md` 无输出
+- 有 `.mcp.json` 的话，env / headers / args 里除了 `${VAR}` 没有任何像 key / token 的值
+- 你写的文件都在新目录里；没手写 `persona.json` / CLAUDE.md / AGENTS.md / `.clawd/**`（人格要改走 `persona:update` 的 `personality`）
+- 新目录里没有截图、日志、下载之类的产物
 
 ## 4. 报告
 
-一句话报 persona id + 显示名，然后**简短问一句**："这个 persona 要装哪些 skill 吗？"
+一句话报 persona id + 显示名 + 类型（编码型带上绑定的仓库），然后**简短问一句**："这个 persona 要装哪些 skill 吗？"
 
 - 老板回"不用" / "暂时不需要" → 跳过
-- 老板说要 → 让老板给 skill 名（`<author>/<skill-name>` 形式），由 owner 在新 persona 的目录运行 `npx skills add <name> -a claude-code --copy -y`（不带 -g）；先核对该 CLI 的 --help。不要在管家 cwd 安装到错误 persona，guest 不能写 persona 目录
+- 老板给了 skill 来源（`<owner>/<repo>`，可带 skill 名）→ **你自己装**：在新 persona 目录里跑
+
+  ```
+  npx -y skills add <source> -s <skill> -a claude-code -a codex --copy -y
+  ```
+
+  两种引擎都装、拷贝不软链，不带 `-g`；`skills-lock.json` 留在新目录里。装完 `ls .claude/skills .agents/skills` 确认，报一句装了什么。
+  不要在管家自己的目录里跑。
 
-**不要复述 CLAUDE.md 全文。** 老板要看自己会去看。
+**不要复述人格全文。** 老板要看自己会去看。
 
 ## 红线
 
+- **`persona.json`、CLAUDE.md、AGENTS.md、`.clawd/**` 只经 RPC 落**（`persona:create` / `persona:update`），不手写
+- **其余文件只写进本次新建的目录**，不碰别的 persona 目录（包括你自己的）。老板要改已有 persona 切 `clawd-config-editor`
+- **截图、日志等产物不写进 persona 目录**
+- **文件里不出现真实凭据**，哪怕老板在对话里贴了 key：写成 `${VAR}`，告诉老板去 clawd 的凭据设置里填
 - **不举例 skill** —— 老板自己清楚他要什么，你举例会污染他的判断
 - **不替老板写人设** —— 老板说"我要个调试助手"，你别脑补"它应该会写测试 / 会画时序图 / …"。
   只把老板原话里的东西沉淀下来，不确定的留白等老板补
-- **不动其他 persona 目录** —— 只建新的。老板要改已有 persona 切 `clawd-config-editor`
-- **冲突先问后做** —— slug 撞名、老板需求前后矛盾，先说清楚再动手
+- **冲突先问后做** —— slug 撞名、需求前后矛盾，先说清楚再动手

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/persona-authoring/references/coding-workspace.md

@@ -0,0 +1,47 @@
+# 编码型 persona 的「工作区」一节（模板）
+
+把下面 `---` 之间的内容放进新 persona 的人格，替换三个占位：
+
+- `{repo}`：绑定的仓库 `owner/name`（表单「仓库」行）
+- `{name}`：仓库名（`owner/name` 的 `name`）
+- `{branch}`：基准分支（仓库默认分支；需求里另有说明就照办）
+
+需求里提到的其它仓库，在这一节末尾加一行「相关仓库（只作参考，不在这里开工）：…」，不为它们写克隆规则。
+措辞可以按 persona 的风格调整，但下面每条规则都要保留。
+
+---
+
+## 工作区
+
+你绑定的仓库是 `{repo}`，基准分支 `{branch}`。改代码、跑测试、开 PR 都在这个仓库里做，不在 persona 目录里放业务代码。
+
+每个任务（包括只读排查）用自己独立的一份代码，放在会话的文件工作目录 `$CLAWD_WORK_DIR` 下，**不和别的会话共用**。按你在哪儿跑选做法：环境变量 `CLAWD_GATEWAY_URL` 有值、或指令末尾有云上宿主声明，就是在云上；否则是本机。
+
+**本机：从基础克隆开 worktree。** `$CLAWD_WORK_DIR/{name}-base` 只当共享的对象库，不在里面改代码、提交或切分支。没有就先建：
+
+```sh
+gh auth setup-git --hostname github.com
+cd "$CLAWD_WORK_DIR" && git clone -q --filter=blob:none --single-branch --branch {branch} https://github.com/{repo} {name}-base
+```
+
+每个任务先拉最新的基准分支，再开一个 worktree：
+
+```sh
+git -C "$CLAWD_WORK_DIR/{name}-base" fetch -q origin {branch}
+git -C "$CLAWD_WORK_DIR/{name}-base" worktree add -b dev/<task> "$CLAWD_WORK_DIR/{name}-<task>" origin/{branch}
+```
+
+接着做一个已推送的分支：`git -C "$CLAWD_WORK_DIR/{name}-base" fetch -q origin dev/<task>:refs/remotes/origin/dev/<task>`，再 `worktree add --track -b dev/<task> "$CLAWD_WORK_DIR/{name}-<task>" origin/dev/<task>`。
+
+**云上：每个任务一个浅克隆。** 不建基础克隆、不复用跨任务的缓存目录（空闲的 Pod 会被回收）：
+
+```sh
+gh auth setup-git --hostname github.com
+cd "$CLAWD_WORK_DIR" && git clone -q --depth 1 --branch {branch} https://github.com/{repo} {name}-<task>
+```
+
+要看历史再 `git fetch --deepen=N`；浅克隆上不要 `git rebase origin/{branch}`。
+
+**删之前核对。** 删一份可写的 worktree / 克隆前，两条都要成立：`git status --short` 为空；`git ls-remote origin refs/heads/$(git branch --show-current)` 的哈希等于 `git rev-parse HEAD`。没推送的工作留着等下次接着做。只读的可以直接删。本机用 `git -C "$CLAWD_WORK_DIR/{name}-base" worktree remove <路径>`（不加 `--force`），再 `git worktree prune`；云上用 `rm -r`。
+
+---

package/dist/persona-defaults/persona-clawd-butler/.claude/skills/scan-sessions-suggest-personas/SKILL.md

@@ -123,14 +123,14 @@ node <本 SKILL.md 所在目录绝对路径>/scripts/extract-signals.mjs --days
 
 ### 4. 老板勾中的，转交 `persona-authoring`
 
-**你不落盘。** 老板勾完，把选中候选的这几项交给 `persona-authoring` skill：
+**你不建 persona。** 老板勾完，把选中候选的这几项交给 `persona-authoring` skill：
 
 - **slug / label** —— 候选卡上已经给了
 - **建议定位** —— 候选卡的那一行
 - **行为特征** —— 常用什么工具、碰什么文件、边界在哪。这条必须带上：新 persona 的
   CLAUDE.md 要把它沉淀进去，别只留一句空泛的定位
 
-落盘、id 拼装、沙箱配置由 `persona-authoring` 调一次 `persona:create` 完成，你不碰文件。
+候选没有「普通 / 编码」类型，由 `persona-authoring` 问老板（编码型还要问绑哪个仓库）。登记、写其余文件、自检都按 `persona-authoring` 的流程做，这一步不另写文件。
 
 ## 边界
 

package/dist/persona-defaults/persona-clawd-butler/CLAUDE.md

@@ -29,7 +29,7 @@
 | 会话查询 / 搜索 / 历史 | clawd-session-lens |
 | dispatch / DM / shift / 联系人 / 话题 | clawd-orchestration |
 | 修改已有 persona 配置 | clawd-config-editor |
-| 建新 persona | persona-authoring |
+| 建新 persona（含界面表单发来的「新建 persona」消息） | persona-authoring |
 | 从本机历史推荐 persona | scan-sessions-suggest-personas |
 | 关联外部历史 | clawd-session-import |
 | 上云前环境扫描 | scan-persona-for-deploy |

package/dist/persona-defaults/persona-dataclaw-builder/mcp/clawd-app-builder/mcp-server.cjs

@@ -32784,6 +32784,10 @@ var GithubPrRequestReviewersArgs = external_exports.object({
   number: number3,
   reviewers: external_exports.array(external_exports.string().min(1)).min(1)
 });
+var GithubReposArgs = external_exports.object({
+  page: external_exports.number().int().min(1).max(1e3).optional(),
+  search: external_exports.string().max(100).optional()
+});
 
 // ../protocol/src/lark-bot-schemas.ts
 var LarkBotPersonaArgs = external_exports.object({ personaId: external_exports.string().min(1) });
@@ -34171,6 +34175,10 @@ var METHOD_DOCS = {
     summary: "\u7ED9 PR \u8BF7\u6C42\u5BA1\u67E5\u8005\uFF08\u8FFD\u52A0\uFF0C\u4E0D\u8986\u76D6\u5DF2\u6709\uFF09",
     args: GithubPrRequestReviewersArgs
   },
+  "github:repos": {
+    summary: "\u5217\u672C\u673A GitHub \u8EAB\u4EFD\u80FD\u770B\u5230\u7684\u4ED3\u5E93\uFF08\u65B0\u5EFA\u7F16\u7801\u578B persona \u9009\u4ED3\u5E93\uFF09\uFF1A\u76F4\u8FDE GitHub REST\uFF0C\u4E0D\u4F9D\u8D56 gh\u3002\u56DE { repositories: WorkspaceRepo[], hasMore }\uFF1B\u6CA1\u5173\u8054 GitHub \u2192 UNAUTHORIZED\u300C\u8BF7\u5148\u5173\u8054 GitHub\u300D",
+    args: GithubReposArgs
+  },
   "shift-internal:add": {
     summary: "\u6392\u4E00\u4E2A shift\uFF08\u5230\u70B9\u81EA\u52A8\u62C9\u8D77 persona \u5E72\u6D3B\uFF09\u3002\u7701\u7565 targetPersona = \u6D3E\u7ED9\u8C03\u7528\u65B9\u81EA\u5DF1",
     args: ShiftInternalAddArgs