@jennie-shawn/starwork 0.1.0-alpha.0

package/core/kits/hub/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//351/241/271/347/233/256/347/212/266/346/200/201.md

@@ -0,0 +1,24 @@
+# 多项目中枢状态
+
+## 中枢目标
+
+待填写。
+
+## 当前阶段
+
+待填写。
+
+## 管理的项目
+
+项目索引见 `项目/registry.json`。
+
+## 共享资源
+
+- 身份：`identity/`
+- 教训：`lessons/`
+- 知识：`知识/`
+- Skills：`skills/`
+
+## 下一步
+
+- 待填写。

package/core/kits/hub/_/347/263/273/347/273/237//344/273/273/345/212/241//345/275/223/345/211/215/345/267/245/344/275/234.md

@@ -0,0 +1,17 @@
+# 当前工作
+
+## 当前入口
+
+待填写。
+
+## 进行中
+
+- 待填写。
+
+## 阻塞或等待确认
+
+- 待填写。
+
+## 工作记录
+
+- 待填写。

package/core/kits/hub/identity/README.md

@@ -0,0 +1,5 @@
+# 身份信息
+
+这里存放跨项目共享身份、偏好和长期背景。
+
+修改前需要用户确认。

package/core/kits/hub/lessons/README.md

@@ -0,0 +1,5 @@
+# 教训库
+
+这里存放跨项目可复用教训。
+
+只有能改变未来行为的经验才进入这里。

package/core/kits/hub/skills/README.md

@@ -0,0 +1,5 @@
+# Skills
+
+这里存放跨项目共享 skills。
+
+项目专用 skill 应留在项目内；确认通用后再回写到中枢。

package/core/kits/hub//347/237/245/350/257/206/README.md

@@ -0,0 +1,5 @@
+# 知识库
+
+这里存放跨项目共享知识。
+
+不要把单个项目的临时资料直接放入这里。

package/core/kits/hub//351/241/271/347/233/256/README.md

@@ -0,0 +1,5 @@
+# 项目
+
+这里存放项目注册表和跨项目联络机制。
+
+项目具体进度正文留在各自项目内。

package/core/kits/hub//351/241/271/347/233/256/registry.json

@@ -0,0 +1,4 @@
+{
+  "schema": "starwork.projects.registry.v0.1",
+  "projects": []
+}

package/core/kits/hub//351/241/271/347/233/256//350/201/224/347/273/234/README.md

@@ -0,0 +1,5 @@
+# 跨项目联络
+
+这里存放跨项目请求、同步、交接和回执记录。
+
+联络单不直接改写目标项目的业务事实源。

package/core/kits/kit-structure-reference.md

@@ -0,0 +1,253 @@
+# StarWork Kit Structure Reference
+
+## 状态
+
+- 版本：v0.1 draft
+- 日期：2026-05-15
+- 范围：记录当前 `product/core/kits/` 下所有 Kit 的实际结构
+- 用途：作为后续梳理 Kit 边界、目录命名、语言一致性和 CLI 生成逻辑的事实依据
+
+本文件记录当前已确认的 Kit 结构快照。后续如果调整 Kit，必须同步更新本文件。
+
+## Kit 列表
+
+| Kit | 定位 |
+|---|---|
+| `local-starter` | 轻量单项目 Kit。 |
+| `local-matter` | 单项目事项型 Kit。 |
+| `hub` | 多项目管理中枢 Kit。 |
+| `satellite-starter` | 轻量卫星项目 Kit，不启用事项。 |
+| `satellite-matter` | 事项型卫星项目 Kit，启用事项。 |
+
+命名原则：Kit 名称不携带语言标签，只表达工作区形态。当前 `product/core/kits/` 下的结构默认以中文 profile 落地。英文 profile 的参考样例放在 `product/core/profiles/en/reference-kits/`，不进入正式 Kit 列表。
+
+## `local-starter`
+
+定位：轻量单项目 Kit。适合单项目、无事项机制、使用参考资料和输出目录的轻量工作区。
+
+```text
+.
+├── AGENTS.md
+├── README.md
+├── _系统/
+│   ├── 上下文/
+│   │   └── 项目状态.md
+│   ├── 任务/
+│   │   └── 当前工作.md
+│   ├── 身份/
+│   │   └── README.md
+│   └── 教训/
+│       └── README.md
+├── 参考资料/
+│   └── README.md
+└── 输出/
+    ├── 草稿/
+    │   └── README.md
+    └── 确认成果/
+        └── README.md
+```
+
+不包含：
+
+```text
+事项/
+_系统/上下文/决策.md
+```
+
+## `local-matter`
+
+定位：单项目事项型 Kit。适合需要长期事项追踪、跨会话接力和过程沉淀的单项目工作区。
+
+```text
+.
+├── AGENTS.md
+├── README.md
+├── _系统/
+│   ├── 上下文/
+│   │   ├── 项目状态.md
+│   │   └── 决策.md
+│   ├── 任务/
+│   │   └── 当前工作.md
+│   ├── 身份/
+│   │   └── README.md
+│   └── 教训/
+│       └── README.md
+├── 参考资料/
+│   └── README.md
+├── 输出/
+│   ├── 草稿/
+│   │   └── README.md
+│   └── 确认成果/
+│       └── README.md
+└── 事项/
+    ├── 注册表.md
+    └── _事项模板/
+        ├── README.md
+        ├── 进度.md
+        ├── 笔记.md
+        ├── 交接.md
+        └── 草稿/
+            └── .gitkeep
+```
+
+## `hub`
+
+定位：多项目管理中枢 Kit。用于建立主库 / 中枢，不直接创建卫星项目。
+
+```text
+.
+├── AGENTS.md
+├── README.md
+├── .incoming/
+│   └── README.md
+├── _系统/
+│   ├── 上下文/
+│   │   └── 项目状态.md
+│   └── 任务/
+│       └── 当前工作.md
+├── identity/
+│   └── README.md
+├── lessons/
+│   └── README.md
+├── 知识/
+│   └── README.md
+├── skills/
+│   └── README.md
+└── 项目/
+    ├── README.md
+    ├── registry.json
+    └── 联络/
+        └── README.md
+```
+
+说明：
+
+- `identity/`、`lessons/` 保留在中枢根目录，因为它们是主库重点维护的项目。
+- `项目/` 使用当前默认中文 profile 的目录名。
+- `skills/` 和 `.incoming/` 暂保留英文名，因为它们更像工具 / 协议入口。
+
+## `satellite-starter`
+
+定位：轻量卫星项目 Kit。适合接入主库，但不启用事项机制的项目。
+
+```text
+.
+├── AGENTS.md
+├── CLAUDE.md
+├── README.md
+├── .core-sync.json
+├── .internal/
+│   └── README.md
+├── .obsidian/
+│   └── README.md
+├── .agents/
+│   └── skills/
+│       └── README.md
+├── .claude/
+│   └── skills/
+│       └── README.md
+├── _系统/
+│   ├── 上下文/
+│   │   └── 当前项目.md
+│   ├── 任务/
+│   │   └── 当前工作.md
+│   ├── 身份/
+│   │   └── README.md
+│   ├── 教训/
+│   │   └── README.md
+│   ├── 主库同步/
+│   │   └── README.md
+│   └── 跨项目/
+│       ├── README.md
+│       ├── inbox/
+│       │   └── README.md
+│       └── outbox/
+│           └── README.md
+├── 知识/
+│   └── README.md
+├── 参考资料/
+│   └── README.md
+└── 输出/
+    ├── 草稿/
+    │   └── README.md
+    └── 确认成果/
+        └── README.md
+```
+
+不包含：
+
+```text
+事项/
+_系统/上下文/决策.md
+```
+
+## `satellite-matter`
+
+定位：事项型卫星项目 Kit。适合接入主库，并启用事项机制的项目。
+
+```text
+.
+├── AGENTS.md
+├── CLAUDE.md
+├── README.md
+├── .core-sync.json
+├── .internal/
+│   └── README.md
+├── .obsidian/
+│   └── README.md
+├── .agents/
+│   └── skills/
+│       └── README.md
+├── .claude/
+│   └── skills/
+│       └── README.md
+├── _系统/
+│   ├── 上下文/
+│   │   ├── 当前项目.md
+│   │   └── 决策.md
+│   ├── 任务/
+│   │   └── 当前工作.md
+│   ├── 身份/
+│   │   └── README.md
+│   ├── 教训/
+│   │   └── README.md
+│   ├── 主库同步/
+│   │   └── README.md
+│   └── 跨项目/
+│       ├── README.md
+│       ├── inbox/
+│       │   └── README.md
+│       └── outbox/
+│           └── README.md
+├── 知识/
+│   └── README.md
+├── 参考资料/
+│   └── README.md
+├── 输出/
+│   ├── 草稿/
+│   │   └── README.md
+│   └── 确认成果/
+│       └── README.md
+└── 事项/
+    ├── 注册表.md
+    └── _事项模板/
+        ├── README.md
+        ├── 进度.md
+        ├── 笔记.md
+        ├── 交接.md
+        └── 草稿/
+            └── .gitkeep
+```
+
+## 已确认的结构原则
+
+1. 当前正式 Kit 的结构描述默认使用中文 profile。
+2. `AGENTS.md`、`README.md`、`CLAUDE.md` 暂保留工具生态约定文件名。
+3. 单项目 Kit 中，`身份/` 和 `教训/` 属于 `_系统/`。
+4. 卫星项目 Kit 中，`身份/` 和 `教训/` 也放在 `_系统/`，表示它们是主库快照或项目内候选沉淀，不是主库本体。
+5. Hub Kit 中，`identity/`、`lessons/` 保留在根目录，因为它们是中枢重点维护对象。
+6. `日记/` 不进入 v0.1 Kit。
+7. 通用卫星项目不默认包含 `product/`；默认确认成果位置是 `输出/确认成果/`。
+8. `knowledge/` 在默认中文 profile 中落地为 `知识/`。
+9. 卫星项目分为 no-matter 与 matter 两类：`satellite-starter` 和 `satellite-matter`。
+10. 默认中文 profile 的决策文件使用 `_系统/上下文/决策.md`，当前工作文件使用 `_系统/任务/当前工作.md`。

package/core/kits/local-matter/AGENTS.md

@@ -0,0 +1,23 @@
+# StarWork 工作区规则
+
+## 开始前先读
+
+1. `_系统/上下文/项目状态.md`
+2. `_系统/任务/当前工作.md`
+3. 如启用事项模式，再读 `事项/注册表.md`
+
+## 写入边界
+
+- 项目状态写入 `_系统/上下文/项目状态.md`
+- 当前工作入口写入 `_系统/任务/当前工作.md`
+- 身份信息放入 `_系统/身份/`，默认只读
+- 项目教训放入 `_系统/教训/`
+- 原始资料放入 `参考资料/`，默认只读
+- AI 草稿放入 `输出/草稿/` 或事项的 `草稿/`
+- 用户确认后的成果放入项目声明的正式事实源
+
+## 需要确认
+
+- 修改身份、教训、共享知识或主库同步内容
+- 将草稿晋升为正式事实源
+- 创建、暂停或归档长期事项

package/core/kits/local-matter/README.md

@@ -0,0 +1,22 @@
+# 单项目 Matter Kit
+
+Preset: `local-matter`
+
+适合需要长期事项接力和过程沉淀的单项目用户。
+
+## 包含
+
+- 默认中文路径 profile
+- 轻量输出模式
+- 事项模式
+- 高影响决策记录
+- `_系统/身份/`
+- `_系统/教训/`
+- `参考资料/`
+- `输出/草稿/`
+- `输出/确认成果/`
+- `事项/注册表.md`
+
+## 事项模式要求
+
+启用事项模式时，应该同时安装或软链接 `matter-workspace` skill。

package/core/kits/local-matter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//345/206/263/347/255/226.md

@@ -0,0 +1,7 @@
+# 决策记录
+
+只记录高影响、已确认、会影响后续多个事项的决策。
+
+## 决策列表
+
+暂无。

package/core/kits/local-matter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//351/241/271/347/233/256/347/212/266/346/200/201.md

@@ -0,0 +1,25 @@
+# 项目状态
+
+## 项目目标
+
+待填写。
+
+## 当前阶段
+
+待填写。
+
+## 近期重点
+
+- 待填写。
+
+## 主要风险
+
+- 待填写。
+
+## 正式事实源
+
+待填写，例如 `输出/确认成果/`、`product/` 或项目自定义目录。
+
+## 下一步
+
+- 待填写。

package/core/kits/local-matter/_/347/263/273/347/273/237//344/273/273/345/212/241//345/275/223/345/211/215/345/267/245/344/275/234.md

@@ -0,0 +1,17 @@
+# 当前工作
+
+## 当前入口
+
+待填写。
+
+## 进行中
+
+- 待填写。
+
+## 阻塞或等待确认
+
+- 待填写。
+
+## 工作记录
+
+- 待填写。

package/core/kits/local-matter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md

@@ -0,0 +1,5 @@
+# 教训库
+
+这里存放本项目可复用的教训。
+
+一条有价值的教训应该能改变未来行为，而不只是总结发生了什么。

package/core/kits/local-matter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md

@@ -0,0 +1,5 @@
+# 身份信息
+
+这里存放本项目本地维护的身份、偏好和长期背景。
+
+默认只读。除非用户明确要求，不要修改。

package/core/kits/local-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277/README.md

@@ -0,0 +1,17 @@
+# Matter Title
+
+## Goal
+
+TBD.
+
+## Scope
+
+TBD.
+
+## Out of Scope
+
+TBD.
+
+## Formal Source Promotion Target
+
+TBD.

package/core/kits/local-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277//344/272/244/346/216/245.md

@@ -0,0 +1,3 @@
+# Handoff
+
+Use this file for cross-Agent or cross-project handoff notes.

package/core/kits/local-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277//347/254/224/350/256/260.md

@@ -0,0 +1,5 @@
+# Notes
+
+Use this file for discussion notes, research notes, and process judgments.
+
+Do not use it as the formal source of truth.

package/core/kits/local-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277//350/215/211/347/250/277/.gitkeep

@@ -0,0 +1 @@
+

package/core/kits/local-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277//350/277/233/345/272/246.md

@@ -0,0 +1,5 @@
+# Progress
+
+- Created: TBD
+- Status: active
+- Next step: TBD

package/core/kits/local-matter//344/272/213/351/241/271//346/263/250/345/206/214/350/241/250.md

@@ -0,0 +1,16 @@
+# Matters Registry
+
+## Active
+
+| matter_id | status | codex_thread_id | path | updated |
+|---|---|---|---|---|
+
+## Paused
+
+| matter_id | status | codex_thread_id | path | updated |
+|---|---|---|---|---|
+
+## Archived
+
+| matter_id | status | codex_thread_id | path | archived_at |
+|---|---|---|---|---|

package/core/kits/local-matter//345/217/202/350/200/203/350/265/204/346/226/231/README.md

@@ -0,0 +1,5 @@
+# 参考资料
+
+这里存放原始资料、参考链接、用户提供的素材。
+
+默认只读。除非用户明确要求，不要改写原始资料。

package/core/kits/local-matter//350/276/223/345/207/272//347/241/256/350/256/244/346/210/220/346/236/234/README.md

@@ -0,0 +1,5 @@
+# 确认成果
+
+这里存放用户确认后的成果。
+
+项目可以另行声明正式事实源；在 Starter Mode 中，本目录是默认确认成果位置。

package/core/kits/local-matter//350/276/223/345/207/272//350/215/211/347/250/277/README.md

@@ -0,0 +1,5 @@
+# 草稿
+
+这里存放 AI 生成但尚未经过用户确认的草稿。
+
+草稿不是正式事实源。

package/core/kits/local-starter/AGENTS.md

@@ -0,0 +1,23 @@
+# StarWork 工作区规则
+
+## 开始前先读
+
+1. `_系统/上下文/项目状态.md`
+2. `_系统/任务/当前工作.md`
+3. 如启用事项模式，再读 `事项/注册表.md`
+
+## 写入边界
+
+- 项目状态写入 `_系统/上下文/项目状态.md`
+- 当前工作入口写入 `_系统/任务/当前工作.md`
+- 身份信息放入 `_系统/身份/`，默认只读
+- 项目教训放入 `_系统/教训/`
+- 原始资料放入 `参考资料/`，默认只读
+- AI 草稿放入 `输出/草稿/`
+- 用户确认后的成果放入项目声明的正式事实源
+
+## 需要确认
+
+- 修改身份、教训、共享知识或主库同步内容
+- 将草稿晋升为正式事实源
+- 创建、暂停或归档长期事项

package/core/kits/local-starter/README.md

@@ -0,0 +1,23 @@
+# 单项目 Starter Kit
+
+Preset: `local-starter`
+
+适合学员当前模板和轻量单项目用户。
+
+## 包含
+
+- 默认中文路径 profile
+- `AGENTS.md`
+- `_系统/上下文/项目状态.md`
+- `_系统/任务/当前工作.md`
+- `_系统/身份/`
+- `_系统/教训/`
+- `参考资料/`
+- `输出/草稿/`
+- `输出/确认成果/`
+
+## 不默认包含
+
+- `事项/`
+- `_系统/上下文/决策.md`
+- 主库同步能力

package/core/kits/local-starter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//351/241/271/347/233/256/347/212/266/346/200/201.md

@@ -0,0 +1,25 @@
+# 项目状态
+
+## 项目目标
+
+待填写。
+
+## 当前阶段
+
+待填写。
+
+## 近期重点
+
+- 待填写。
+
+## 主要风险
+
+- 待填写。
+
+## 正式事实源
+
+待填写，例如 `输出/确认成果/`、`product/` 或项目自定义目录。
+
+## 下一步
+
+- 待填写。

package/core/kits/local-starter/_/347/263/273/347/273/237//344/273/273/345/212/241//345/275/223/345/211/215/345/267/245/344/275/234.md

@@ -0,0 +1,17 @@
+# 当前工作
+
+## 当前入口
+
+待填写。
+
+## 进行中
+
+- 待填写。
+
+## 阻塞或等待确认
+
+- 待填写。
+
+## 工作记录
+
+- 待填写。

package/core/kits/local-starter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md

@@ -0,0 +1,5 @@
+# 教训库
+
+这里存放本项目可复用的教训。
+
+一条有价值的教训应该能改变未来行为，而不只是总结发生了什么。

package/core/kits/local-starter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md

@@ -0,0 +1,5 @@
+# 身份信息
+
+这里存放本项目本地维护的身份、偏好和长期背景。
+
+默认只读。除非用户明确要求，不要修改。

package/core/kits/local-starter//345/217/202/350/200/203/350/265/204/346/226/231/README.md

@@ -0,0 +1,5 @@
+# 参考资料
+
+这里存放原始资料、参考链接、用户提供的素材。
+
+默认只读。除非用户明确要求，不要改写原始资料。

package/core/kits/local-starter//350/276/223/345/207/272//347/241/256/350/256/244/346/210/220/346/236/234/README.md

@@ -0,0 +1,5 @@
+# 确认成果
+
+这里存放用户确认后的成果。
+
+项目可以另行声明正式事实源；在 Starter Mode 中，本目录是默认确认成果位置。

package/core/kits/local-starter//350/276/223/345/207/272//350/215/211/347/250/277/README.md

@@ -0,0 +1,5 @@
+# 草稿
+
+这里存放 AI 生成但尚未经过用户确认的草稿。
+
+草稿不是正式事实源。

package/core/kits/satellite-matter/.agents/skills/README.md

@@ -0,0 +1,5 @@
+# Agents Skills
+
+这里按需放指向主库正式 skill 的软链接。
+
+不要把主库 skill 复制成项目内独立副本。

package/core/kits/satellite-matter/.claude/skills/README.md

@@ -0,0 +1,5 @@
+# Claude Skills
+
+这里按需放指向主库正式 skill 的软链接。
+
+不要把主库 skill 复制成项目内独立副本。