@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.21

package/kit-skills/starworkAudit/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: starworkAudit
+description: 'Diagnose `starwork audit --json` Project Center and managed project findings, prioritize issues, ask repair questions, and draft conservative `starwork repair --blueprint` plans.'
+---
+
+# starworkAudit
+
+使用这个 skill，把 `starwork audit --json` 暴露的项目中心与项目工作台巡检事实整理成清晰报告；当用户明确要求修复时，生成 `repair-blueprint.json`，交给 `starwork repair --blueprint` 执行。
+
+`starworkAudit` 不是 `starwork audit` 命令本身，也不是 `starwork repair` 执行器。
+
+当前没有独立 `starworkRepair` Skill；项目中心巡检后的修复判断、Host Adapter repair 计划和 `repair-blueprint.json` 设计都由 `starworkAudit` 承接，再交给 `starwork repair` CLI 执行。
+
+```text
+starwork audit = 项目中心巡检器，只列事实
+starworkAudit = 巡检诊断师 + repair blueprint 设计师
+starwork repair = 修复蓝图执行器
+```
+
+## 工作流程
+
+1. 优先运行或读取：
+
+```bash
+starwork audit --hub <hub-path> --json --inventory-depth all
+```
+
+2. 先给用户一句话结论：
+
+```text
+这个项目中心登记了 8 个项目，其中 7 个可访问，1 个路径失效。当前最优先处理路径失效和同步关系问题，规则更新可以放在第二批。
+```
+
+3. 按严重程度分组：
+
+- `blocking`：路径失效、不是 StarWork、workspace state 无法解析。
+- `high`：项目中心路径、project_id 或同步信息不一致。
+- `repairable`：缺 `.starwork/handoff/`、缺 state.json、规则插槽缺失。
+- `notice`：长期未更新、旧路径残留、联络队列积压。
+
+4. 区分可直接生成蓝图的问题和需要用户确认的问题。
+
+可直接生成蓝图：
+
+- 补 `.starwork/handoff/` 子目录。
+- 补 `.starwork/handoff/state.json`。
+- 用户已确认后修 registry path。
+- 用户已确认后重写 `.starwork/sync.json` 和 legacy `.core-sync.json`。
+
+必须确认：
+
+- 项目是否已归档。
+- 失效路径的新位置。
+- 断链知识入口是重建软链接还是保留本地副本。
+- 旧 `_系统/跨项目/` 是否要迁移内容。
+
+5. 只有用户明确要求“生成修复蓝图 / 执行 dry-run / 帮我修”时，才生成 `repair-blueprint.json`。
+
+## 宿主适配巡检
+
+项目中心巡检时，如果用户关心某个 AI 工具是否能正确使用项目工作台，或项目里存在宿主痕迹，要把 Host Adapter 作为独立健康维度。
+
+对每个登记项目，可以在基础巡检后运行：
+
+```bash
+starwork doctor --target <project-path> --host all --json
+```
+
+汇总时分开说明：
+
+- 哪些项目适配了 Codex、Claude Code、Cursor 或 Trae。
+- 哪些项目只有通用 `AGENTS.md` 入口。
+- 哪些项目缺宿主规则入口。
+- 哪些项目存在同名 Skill 冲突。
+- Trae 是否禁用了 `.starwork/skills.json` 里声明启用的 Skill。
+
+修复蓝图只能修 StarWork 可控文件：
+
+- 宿主规则入口
+- `.starwork/adapters.json`
+- `.starwork/skills.json`
+- 项目内 Skill mount dirs
+
+禁止通过 Hub audit / repair 读取或改写宿主私有 transcript、私有数据库、加密 history 或全局配置。
+
+## 中间产物路径规则
+
+`starworkAudit` 产生的是巡检和修复过程材料，不是项目业务内容。
+
+当需要落地 `audit-result.json`、`repair-blueprint.json`、规则片段或临时说明时，只能写入项目中心的 StarWork 机制目录：
+
+```text
+<hub>/.starwork/audit-runs/<YYYY-MM-DD-or-run-id>/
+├── audit-result.json
+├── repair-blueprint.json
+└── rules/
+```
+
+禁止写入：
+
+- 项目中心 `工作区/` 或 `workspace/`
+- 项目工作台 `workspace/`
+- `输出/`、`outputs/`
+- `知识/`、`knowledge/`
+- `参考资料/`、`references/`
+- 任何项目业务目录或正式成果目录
+
+除非用户明确要求调试 CLI，否则不要生成 `.mjs`、`.js`、`.sh` 等脚本型中间产物。修复设计应优先使用 `repair-blueprint.json` 和 `rules/*.md`。如果用户明确要求生成调试脚本，也必须放在同一个 `.starwork/audit-runs/<run-id>/` 下，并在回复中说明它不是项目业务文档。
+
+## 约束
+
+- 不直接改文件。
+- 不建议删除项目记录。
+- 不移动用户内容。
+- 不合并 `.incoming/`。
+- 不修改 identity / lessons / knowledge 正文。
+- 不把旧 `project` 作为新标准；它只是旧中心管理项目 + 历史事项内容信号。
+
+## 参考
+
+完整边界见：
+
+```text
+../starworkAudit-spec.md
+../../cli/audit-spec.md
+../../cli/repair-spec.md
+```

package/kit-skills/starworkAudit/references/issue-taxonomy.md

@@ -0,0 +1,10 @@
+# starworkAudit Issue Taxonomy
+
+| Level | Meaning | Examples |
+|---|---|---|
+| `blocking` | 巡检或项目使用不可靠。 | 路径不存在、workspace state 无法解析、不是 StarWork。 |
+| `high` | 项目中心和项目工作台的关系可能错误。 | `project_center.path` 或兼容字段 `hub.path` 错、`project_id` 不一致、sync metadata 指向旧项目中心。 |
+| `repairable` | 可通过保守 repair blueprint 补齐。 | 缺 `.starwork/handoff/`、缺 state.json、缺 `.starwork/sync.json`。 |
+| `notice` | 提醒，不急于修。 | 旧路径残留、队列积压、长期未更新。 |
+
+不要把 `audit` 的事实直接当成最终判断。先解释依据，再给出需要用户确认的地方。

package/kit-skills/starworkAudit/references/repair-blueprint-guide.md

@@ -0,0 +1,54 @@
+# Repair Blueprint Guide
+
+`starworkAudit` 生成的 repair blueprint 必须保守。
+
+## 输出位置
+
+repair blueprint 和配套规则是 StarWork 巡检 / 修复过程材料，只能写入项目中心的机制目录：
+
+```text
+<project-center>/.starwork/audit-runs/<YYYY-MM-DD-or-run-id>/
+├── audit-result.json
+├── repair-blueprint.json
+└── rules/
+```
+
+不要写入项目中心或项目工作台的业务工作区，例如：
+
+- `workspace/`
+- `输出/`、`outputs/`
+- `知识/`、`knowledge/`
+- `参考资料/`、`references/`
+- 项目正式成果目录
+
+默认不要生成 `.mjs`、`.js`、`.sh` 等脚本型中间产物。修复应通过 `repair-blueprint.json` 表达，规则片段用 Markdown 放入 `rules/`。
+
+## 允许动作
+
+允许的首版动作：
+
+- `ensure_dir`
+- `write_file_if_missing`
+- `rewrite_core_sync`
+- `update_hub_registry`
+- `update_workspace_state`
+
+默认不要生成：
+
+- 删除动作
+- 移动用户目录
+- 覆盖正式成果
+- 合并 `.incoming/`
+- 修改 identity / lessons / knowledge 正文
+
+执行前应提示用户先运行：
+
+```bash
+starwork repair --blueprint repair-blueprint.json --dry-run
+```
+
+确认后再运行：
+
+```bash
+starwork repair --blueprint repair-blueprint.json --yes
+```

package/kit-skills/starworkAudit/references/response-guide.md

@@ -0,0 +1,34 @@
+# starworkAudit Response Guide
+
+推荐开场：
+
+```text
+我先把这个目录当作项目中心来看。它登记了 N 个项目，其中 X 个可访问，Y 个有阻塞问题。我们先处理会影响项目定位和同步关系的问题，再处理规则升级。
+```
+
+推荐分组：
+
+```text
+阻塞问题
+高风险问题
+可批量修复项
+需要你确认的问题
+```
+
+如果发现旧 事项：
+
+```text
+这个项目里有旧事项机制痕迹。我不会建议删除它；新版 StarWork 会先把项目作为 Project 接入，把事项结构作为 legacy capability 保留。
+```
+
+如果用户要求修复：
+
+```text
+我会先生成 repair blueprint。它只补 StarWork 管理结构和同步元数据，不移动项目内容，不覆盖正式成果。
+```
+
+如果需要落地中间产物：
+
+```text
+我会把 audit result、repair blueprint 和配套规则放到项目中心的 `.starwork/audit-runs/<run-id>/`，不写入 `workspace/`、输出区、知识库或项目正式成果目录。
+```

package/{skills → kit-skills}/starworkSpawn/SKILL.md

@@ -1,19 +1,40 @@
 ---
 name: starworkSpawn
-description: Use this skill when a user wants to design or generate a customized StarWork satellite workspace for `starwork spawn --blueprint`, including choosing starter vs matter mode, drafting blueprint.json, writing project rules, planning seed files, and explaining how to execute and validate the spawn.
+description: 'Design customized project workspaces created from a Project Center with `starwork spawn --blueprint`: choose language, draft blueprint.json, rules, seed files, and validation steps.'
 ---
 
 # starworkSpawn
 
-使用这个 skill，把用户的项目想法转成 StarWork Spawn Blueprint（工作台定制单）。
+使用这个 skill，从项目中心创建新的 StarWork 项目工作台。
 
-Spawn Blueprint 是一个小型配置包：
+## 第一屏必须先讲清楚
+
+当用户说“从项目中心创建项目”“创建项目工作台”“把这个新项目登记到项目中心”时，先用用户语言解释，不要直接讲命令或 Blueprint：
+
+```text
+从项目中心创建项目工作台，是把一个新项目登记到项目中心，并生成这个项目自己的 StarWork 工作台。
+
+项目中心负责登记多个项目；新项目工作台负责具体项目的日常协作，包括项目说明、资料和成果位置、当前任务、Agent 规则和交接记录。
+
+接下来我会分三步：
+1. 先确认新项目是什么、要交付什么；
+2. 再设计项目工作台结构；
+3. 你确认后先用 spawn 预览，再正式创建并做一次检查。
+
+整个过程中，我会先预览，不会在你确认前创建项目工作台，也不会改动项目中心里的既有项目。
+```
+
+第一屏之后，再进入项目采访。每次只问一组问题，不要一次性追问所有配置。
+
+## Blueprint 说明
+
+Spawn Blueprint 是一个小型配置包，用来描述从项目中心创建项目工作台的定制方案：
 
 - `blueprint.json`：机器可读的结构和路径配置
 - `rules/*.md`：项目专属 Agent 规则
 - `seed/**`：可选的初始化占位文件
 
-Blueprint 由 `starwork spawn --blueprint` 执行。除非用户明确要求落地文件，否则这个 skill 只负责设计，不直接修改用户的 Hub 或目标工作区。
+Blueprint 由 `starwork spawn --blueprint` 执行。除非用户明确要求落地文件，否则这个 skill 只负责设计，不直接修改用户的项目中心或目标工作区。
 
 ## 参考
 
@@ -29,12 +50,13 @@ Blueprint 由 `starwork spawn --blueprint` 执行。除非用户明确要求落
 
 1. 识别用户要创建的工作台。
    - 项目是什么？
-   - 是短期轻量项目，还是长期推进项目？
-   - 是否需要事项、决策、交接记录或跨会话追踪？
+   - 这是怎样的具体项目？
+   - 是否需要专门的资料区、草稿区、交付区或跨会话追踪？
 
 2. 选择基础模式。
-   - 长期项目、多步骤工作、跨会话协作、需要事项追踪时，使用 `matter`。
-   - 轻量项目、主要只需要资料和成果输出时，才使用 `starter`。
+   - 需要多阶段交接或多条推进线时，也使用 `project`，再通过 blueprint 定制目录和规则。
+   - `starter` 是旧兼容参数，不主动推荐；新项目默认使用 `project`。
+   - 默认会叠加 General Pack；`参考资料/` 和 `输出/` 这类业务目录来自 Pack，不是 Project Kit 固定结构。
 
 3. 判断应该用 Blueprint 还是 Pack。
    - 一次性项目定制，用 Blueprint。
@@ -81,11 +103,11 @@ Blueprint 由 `starwork spawn --blueprint` 执行。除非用户明确要求落
 
 ## 约束
 
-- `blueprint.json` 不写 Hub 路径和 target 路径，它们属于 CLI 参数。
+- `blueprint.json` 不写项目中心路径和 target 路径，它们属于 CLI 参数。
 - 不覆盖用户文件。
 - 不修改 Kit 源目录。
-- 不直接写 Hub，除非通过 `starwork spawn` 的 registry 登记行为。
-- 不删除 `AGENTS.md`、`.starwork/`、`.core-sync.json`、`_系统/`、`知识/` 或 skill 链接。
+- 不直接写项目中心，除非通过 `starwork spawn` 的 registry 登记行为。
+- 不删除 `AGENTS.md`、`.starwork/`、`.core-sync.json`、系统目录、共享知识挂载或 skill 链接。
 - 除非用户有明确理由，否则优先新增清晰目录，而不是重命名系统目录。
 - Markdown 规则要具体、可执行，避免泛泛的效率建议。
 
@@ -97,13 +119,13 @@ Blueprint 由 `starwork spawn --blueprint` 执行。除非用户明确要求落
   "name": "内容产品官网",
   "project_id": "content-site",
   "base": {
-    "mode": "matter",
-    "kit": "satellite-matter",
+    "mode": "project",
+    "kit": "project",
     "language": "zh"
   },
   "paths": {
     "formal_source": "交付物/确认版本/",
-    "business_work_area": "事项/"
+    "business_work_area": "资料库/"
   },
   "folders": [
     "资料库/",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jennie-shawn/starwork",
-  "version": "0.1.0-alpha.2",
-  "description": "StarWork Core, CLI, Packs, and Agent skills for AI workspaces.",
+  "version": "0.1.0-alpha.21",
+  "description": "StarWork Core、CLI、Packs 和 Agent skills，用于构建 AI 工作台。",
   "type": "commonjs",
   "bin": {
     "starwork": "cli/bin/starwork.js"
@@ -12,6 +12,7 @@
     "core/",
     "docs/",
     "examples/",
+    "kit-skills/",
     "packs/",
     "schemas/",
     "skills/",
@@ -19,7 +20,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/jennie-shawn/starwork.git"
+    "url": "git+https://github.com/jennie-shawn/StarWork.git"
   },
   "publishConfig": {
     "access": "public",

package/packs/content-creator/languages/en.json

@@ -19,10 +19,10 @@
     "business_work_area": "drafts-and-scripts/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/en/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/en/workflow.md" },
-    { "slot": "pack.file_boundaries", "from": "rules/en/file-boundaries.md" },
-    { "slot": "pack.review", "from": "rules/en/review.md" }
+    { "slot": "pack.content-creator.overview", "from": "rules/en/overview.md" },
+    { "slot": "pack.content-creator.workflow", "from": "rules/en/workflow.md" },
+    { "slot": "pack.content-creator.file_boundaries", "from": "rules/en/file-boundaries.md" },
+    { "slot": "pack.content-creator.review", "from": "rules/en/review.md" }
   ],
   "templates": [
     { "id": "content-brief", "from": "templates/en/content-brief.md", "description": "Single content brief template" },

package/packs/content-creator/languages/zh.json

@@ -19,10 +19,10 @@
     "business_work_area": "草稿与脚本/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/zh/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/zh/workflow.md" },
-    { "slot": "pack.file_boundaries", "from": "rules/zh/file-boundaries.md" },
-    { "slot": "pack.review", "from": "rules/zh/review.md" }
+    { "slot": "pack.content-creator.overview", "from": "rules/zh/overview.md" },
+    { "slot": "pack.content-creator.workflow", "from": "rules/zh/workflow.md" },
+    { "slot": "pack.content-creator.file_boundaries", "from": "rules/zh/file-boundaries.md" },
+    { "slot": "pack.content-creator.review", "from": "rules/zh/review.md" }
   ],
   "templates": [
     { "id": "content-brief", "from": "templates/zh/content-brief.md", "description": "单篇内容大纲模板" },

package/packs/content-creator/pack.json

@@ -3,7 +3,7 @@
   "id": "content-creator",
   "version": "0.1.0",
   "compatible_core": "0.1",
-  "supports_workspace_types": ["single-light", "single-matter"],
+  "supports_workspace_types": ["project", "single-light", "single-matter"],
   "requires_capabilities": [],
   "roles": {
     "account_profile": { "kind": "strategy" },
@@ -20,10 +20,10 @@
   },
   "flow": ["account_profile", "ideas", "materials", "drafts", "published", "review"],
   "rules": [
-    { "id": "overview", "slot": "pack.overview" },
-    { "id": "workflow", "slot": "pack.workflow" },
-    { "id": "file-boundaries", "slot": "pack.file_boundaries" },
-    { "id": "review", "slot": "pack.review" }
+    { "id": "overview", "slot": "pack.content-creator.overview" },
+    { "id": "workflow", "slot": "pack.content-creator.workflow" },
+    { "id": "file-boundaries", "slot": "pack.content-creator.file_boundaries" },
+    { "id": "review", "slot": "pack.content-creator.review" }
   ],
   "templates": [
     { "id": "content-brief" },

package/packs/general/languages/en.json

@@ -6,13 +6,30 @@
     "drafts": "outputs/drafts/",
     "final": "outputs/final/"
   },
+  "directories": [
+    {
+      "id": "references",
+      "path": "references/",
+      "readme": "# References\n\nStore source materials, reference links, and user-provided materials here.\n\nTreat this directory as read-only by default unless the user explicitly asks you to edit source material.\n"
+    },
+    {
+      "id": "drafts",
+      "path": "outputs/drafts/",
+      "readme": "# Drafts\n\nStore AI-generated drafts, working notes, and intermediate versions here.\n\nDrafts are not the formal source of truth.\n"
+    },
+    {
+      "id": "final",
+      "path": "outputs/final/",
+      "readme": "# Final Outputs\n\nStore user-approved outputs and confirmed deliverables here.\n\nA project may declare another formal source of truth; by default, this directory holds confirmed outputs.\n"
+    }
+  ],
   "overrides": {
     "formal_source": "outputs/final/",
     "business_work_area": "outputs/drafts/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/en/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/en/workflow.md" }
+    { "slot": "pack.general.overview", "from": "rules/en/overview.md" },
+    { "slot": "pack.general.workflow", "from": "rules/en/workflow.md" }
   ],
   "templates": [],
   "seed": []

package/packs/general/languages/zh.json

@@ -6,13 +6,30 @@
     "drafts": "输出/草稿/",
     "final": "输出/确认成果/"
   },
+  "directories": [
+    {
+      "id": "references",
+      "path": "参考资料/",
+      "readme": "# 参考资料\n\n这里存放原始资料、参考链接、用户提供的素材。\n\n默认只读。除非用户明确要求，不要改写原始资料。\n"
+    },
+    {
+      "id": "drafts",
+      "path": "输出/草稿/",
+      "readme": "# 草稿\n\n这里存放 AI 生成但尚未经过用户确认的草稿。\n\n草稿不是正式事实源。\n"
+    },
+    {
+      "id": "final",
+      "path": "输出/确认成果/",
+      "readme": "# 确认成果\n\n这里存放用户确认后的成果。\n\n项目可以另行声明正式事实源；默认情况下，本目录是确认成果位置。\n"
+    }
+  ],
   "overrides": {
     "formal_source": "输出/确认成果/",
     "business_work_area": "输出/草稿/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/zh/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/zh/workflow.md" }
+    { "slot": "pack.general.overview", "from": "rules/zh/overview.md" },
+    { "slot": "pack.general.workflow", "from": "rules/zh/workflow.md" }
   ],
   "templates": [],
   "seed": []

package/packs/general/pack.json

@@ -3,7 +3,7 @@
   "id": "general",
   "version": "0.1.0",
   "compatible_core": "0.1",
-  "supports_workspace_types": ["single-light", "single-matter"],
+  "supports_workspace_types": ["project", "single-light", "single-matter"],
   "requires_capabilities": [],
   "roles": {
     "references": { "kind": "source" },
@@ -11,9 +11,14 @@
     "final": { "kind": "formal_source" }
   },
   "flow": ["references", "drafts", "final"],
+  "directories": [
+    { "id": "references", "role": "references" },
+    { "id": "drafts", "role": "drafts" },
+    { "id": "final", "role": "final" }
+  ],
   "rules": [
-    { "id": "overview", "slot": "pack.overview" },
-    { "id": "workflow", "slot": "pack.workflow" }
+    { "id": "overview", "slot": "pack.general.overview" },
+    { "id": "workflow", "slot": "pack.general.workflow" }
   ],
   "templates": [],
   "seed": []

package/packs/hub-management/languages/en.json

@@ -15,8 +15,8 @@
     "business_work_area": "projects/coordination/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/en/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/en/workflow.md" }
+    { "slot": "pack.hub-management.overview", "from": "rules/en/overview.md" },
+    { "slot": "pack.hub-management.workflow", "from": "rules/en/workflow.md" }
   ],
   "templates": [],
   "seed": [

package/packs/hub-management/languages/zh.json

@@ -1,27 +1,28 @@
 {
   "language": "zh",
-  "name": "多项目中枢管理 Pack",
+  "name": "项目中心管理 Pack",
   "paths": {
     "projects": "项目/",
-    "coordination": "项目/联络/",
+    "coordination": "项目/协作/",
     "incoming": ".incoming/",
-    "identity": "identity/",
-    "lessons": "lessons/",
+    "identity": "身份/",
+    "lessons": "教训/",
     "knowledge": "知识/",
-    "skills": "skills/"
+    "skills": "技能/",
+    "workspace": "工作区/"
   },
   "overrides": {
     "formal_source": "项目/",
-    "business_work_area": "项目/联络/"
+    "business_work_area": "项目/协作/"
   },
   "rules": [
-    { "slot": "pack.overview", "from": "rules/zh/overview.md" },
-    { "slot": "pack.workflow", "from": "rules/zh/workflow.md" }
+    { "slot": "pack.hub-management.overview", "from": "rules/zh/overview.md" },
+    { "slot": "pack.hub-management.workflow", "from": "rules/zh/workflow.md" }
   ],
   "templates": [],
   "seed": [
-    { "from": "seed/zh/项目/registry.json", "to": "项目/registry.json", "on_conflict": "create_new" },
-    { "from": "seed/zh/项目/联络/README.md", "to": "项目/联络/README.md", "on_conflict": "create_new" },
+    { "from": "seed/zh/projects/registry.json", "to": "项目/registry.json", "on_conflict": "create_new" },
+    { "from": "seed/zh/projects/coordination/README.md", "to": "项目/协作/README.md", "on_conflict": "create_new" },
     { "from": "seed/zh/.incoming/README.md", "to": ".incoming/README.md", "on_conflict": "create_new" }
   ]
 }

package/packs/hub-management/pack.json

@@ -16,8 +16,8 @@
   },
   "flow": ["projects", "coordination", "incoming"],
   "rules": [
-    { "id": "overview", "slot": "pack.overview" },
-    { "id": "workflow", "slot": "pack.workflow" }
+    { "id": "overview", "slot": "pack.hub-management.overview" },
+    { "id": "workflow", "slot": "pack.hub-management.workflow" }
   ],
   "templates": [],
   "seed": [

package/packs/hub-management/rules/en/overview.md

@@ -4,4 +4,6 @@ This workspace is a StarWork multi-project hub.
 
 It manages project registration, shared identity, shared lessons, knowledge, skills, and cross-project coordination.
 
+Hub paths stay in the shared protocol language, such as `projects/`, `knowledge/`, `skills/`, and `.incoming/`.
+
 It is not the formal output directory for any single business project.

package/packs/hub-management/rules/en/workflow.md

@@ -3,4 +3,5 @@
 1. Store project registration in `{{paths.projects}}`.
 2. Store cross-project coordination records in `{{paths.coordination}}`.
 3. Put candidate shared updates in `{{paths.incoming}}` first; merge them into shared resources only after review.
-4. Keep each project's detailed progress inside that project. The hub stores discovery, index, and shared coordination mechanisms.
+4. Store the Hub's own local inbox and outbox records in `.starwork/handoff/`.
+5. Keep each project's detailed progress inside that project. The hub stores discovery, index, and shared coordination mechanisms.

package/packs/hub-management/rules/zh/overview.md

@@ -1,7 +1,9 @@
-### 多项目中枢场景
+### 项目中心管理场景
 
-本工作台是 StarWork 多项目管理中枢。
+本工作台是 StarWork 项目中心。
 
 它用于管理多个项目的注册信息、共享身份、共享教训、知识库、skills 和跨项目联络。
 
+中文项目中心的可见目录使用中文，例如 `项目/`、`知识/`、`技能/` 和 `工作区/`；`.starwork/`、`.incoming/`、`.internal/` 是隐藏机制目录，保持英文。
+
 它不是某个业务项目的正式产物目录。

package/packs/hub-management/rules/zh/workflow.md

@@ -1,6 +1,7 @@
-### 多项目中枢规则
+### 项目中心规则
 
 1. 项目注册信息放在 `{{paths.projects}}`。
 2. 跨项目联络记录放在 `{{paths.coordination}}`。
 3. 候选回写内容先进入 `{{paths.incoming}}`，确认后再合并到共享资源。
-4. 具体项目的进度正文留在各自项目内，中枢只保存定位、索引和共享机制。
+4. Hub 自己的本地收发记录放在 `.starwork/handoff/`。
+5. 具体项目的进度正文留在各自项目内，项目中心只保存定位、索引和共享机制。

package/packs/hub-management/seed/en/projects/coordination/README.md

@@ -1,5 +1,5 @@
 # Cross-Project Coordination
 
-Use this folder for cross-project requests, replies, handoffs, and coordination records.
+Use this folder as the central route for cross-project requests, replies, handoffs, and coordination records.
 
-Project-specific formal sources do not belong here.
+Project-specific formal sources do not belong here. The Hub's own local inbox and outbox live in `.starwork/handoff/`.

package/packs/hub-management/seed/zh/projects/coordination/README.md

@@ -0,0 +1,5 @@
+# 跨项目协调层
+
+这里是跨项目联络单的中央路由层。
+
+项目自己的业务事实源不放在这里。Hub 自己的本地收发记录放在 `.starwork/handoff/`。