@jennie-shawn/starwork 0.1.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (228) hide show
  1. package/README.md +18 -0
  2. package/adapters/README.md +5 -0
  3. package/cli/README.md +52 -0
  4. package/cli/adapt-spec.md +61 -0
  5. package/cli/bin/starwork.js +8 -0
  6. package/cli/doctor-spec.md +516 -0
  7. package/cli/init-spec.md +435 -0
  8. package/cli/pack-install-spec.md +63 -0
  9. package/cli/spawn-blueprint-spec.md +657 -0
  10. package/cli/spawn-spec.md +439 -0
  11. package/cli/src/cli.js +1955 -0
  12. package/cli/test/init.test.js +436 -0
  13. package/core/README.md +51 -0
  14. package/core/baseline/README.md +12 -0
  15. package/core/baseline/file-boundaries.md +25 -0
  16. package/core/baseline/health-check.md +27 -0
  17. package/core/baseline/roles.md +26 -0
  18. package/core/baseline/spec.md +47 -0
  19. package/core/capabilities/README.md +15 -0
  20. package/core/capabilities/decisions/capability.md +26 -0
  21. package/core/capabilities/local-identity/capability.md +15 -0
  22. package/core/capabilities/local-identity/templates/identity/README.md +5 -0
  23. package/core/capabilities/local-lessons/capability.md +15 -0
  24. package/core/capabilities/local-lessons/templates/lessons/README.md +5 -0
  25. package/core/capabilities/main-repo-sync/capability.md +133 -0
  26. package/core/capabilities/main-repo-sync/templates/.core-sync.example.json +31 -0
  27. package/core/capabilities/main-repo-sync/templates/.internal/README.md +5 -0
  28. package/core/capabilities/matter-mode/capability.md +46 -0
  29. package/core/capabilities/matter-mode/templates/matters/_matter-template/README.md +17 -0
  30. package/core/capabilities/matter-mode/templates/matters/_matter-template/drafts/.gitkeep +1 -0
  31. package/core/capabilities/matter-mode/templates/matters/_matter-template/handoff.md +3 -0
  32. package/core/capabilities/matter-mode/templates/matters/_matter-template/notes.md +5 -0
  33. package/core/capabilities/matter-mode/templates/matters/_matter-template/progress.md +5 -0
  34. package/core/capabilities/matter-mode/templates/matters/registry.md +16 -0
  35. package/core/capabilities/skill-mount/capability.md +24 -0
  36. package/core/capabilities/starter-outputs/capability.md +25 -0
  37. package/core/capabilities/starter-outputs/templates/outputs/drafts/README.md +5 -0
  38. package/core/capabilities/starter-outputs/templates/outputs/final/README.md +5 -0
  39. package/core/capabilities/starter-outputs/templates/references/README.md +5 -0
  40. package/core/core-v0.1-protocol.md +201 -0
  41. package/core/kits/README.md +15 -0
  42. package/core/kits/hub/.incoming/README.md +5 -0
  43. package/core/kits/hub/AGENTS.md +26 -0
  44. package/core/kits/hub/README.md +25 -0
  45. 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 +24 -0
  46. 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 +17 -0
  47. package/core/kits/hub/identity/README.md +5 -0
  48. package/core/kits/hub/lessons/README.md +5 -0
  49. package/core/kits/hub/skills/README.md +5 -0
  50. package/core/kits/hub//347/237/245/350/257/206/README.md +5 -0
  51. package/core/kits/hub//351/241/271/347/233/256/README.md +5 -0
  52. package/core/kits/hub//351/241/271/347/233/256/registry.json +4 -0
  53. package/core/kits/hub//351/241/271/347/233/256//350/201/224/347/273/234/README.md +5 -0
  54. package/core/kits/kit-structure-reference.md +253 -0
  55. package/core/kits/local-matter/AGENTS.md +23 -0
  56. package/core/kits/local-matter/README.md +22 -0
  57. 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 +7 -0
  58. 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 +25 -0
  59. 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 +17 -0
  60. package/core/kits/local-matter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +5 -0
  61. package/core/kits/local-matter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +5 -0
  62. 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 +17 -0
  63. 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 +3 -0
  64. 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 +5 -0
  65. 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 +1 -0
  66. 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 +5 -0
  67. package/core/kits/local-matter//344/272/213/351/241/271//346/263/250/345/206/214/350/241/250.md +16 -0
  68. package/core/kits/local-matter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +5 -0
  69. 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 +5 -0
  70. package/core/kits/local-matter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +5 -0
  71. package/core/kits/local-starter/AGENTS.md +23 -0
  72. package/core/kits/local-starter/README.md +23 -0
  73. 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 +25 -0
  74. 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 +17 -0
  75. package/core/kits/local-starter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +5 -0
  76. package/core/kits/local-starter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +5 -0
  77. package/core/kits/local-starter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +5 -0
  78. 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 +5 -0
  79. package/core/kits/local-starter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +5 -0
  80. package/core/kits/satellite-matter/.agents/skills/README.md +5 -0
  81. package/core/kits/satellite-matter/.claude/skills/README.md +5 -0
  82. package/core/kits/satellite-matter/.core-sync.json +31 -0
  83. package/core/kits/satellite-matter/.internal/README.md +5 -0
  84. package/core/kits/satellite-matter/.obsidian/README.md +5 -0
  85. package/core/kits/satellite-matter/AGENTS.md +27 -0
  86. package/core/kits/satellite-matter/CLAUDE.md +5 -0
  87. package/core/kits/satellite-matter/README.md +40 -0
  88. package/core/kits/satellite-matter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//345/206/263/347/255/226.md +7 -0
  89. package/core/kits/satellite-matter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//345/275/223/345/211/215/351/241/271/347/233/256.md +29 -0
  90. package/core/kits/satellite-matter/_/347/263/273/347/273/237//344/270/273/345/272/223/345/220/214/346/255/245/README.md +42 -0
  91. package/core/kits/satellite-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 +17 -0
  92. package/core/kits/satellite-matter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +8 -0
  93. package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/README.md +9 -0
  94. package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/inbox/README.md +5 -0
  95. package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/outbox/README.md +5 -0
  96. package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +5 -0
  97. package/core/kits/satellite-matter//344/272/213/351/241/271/_/344/272/213/351/241/271/346/250/241/346/235/277/README.md +17 -0
  98. package/core/kits/satellite-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 +3 -0
  99. package/core/kits/satellite-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 +5 -0
  100. package/core/kits/satellite-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 +1 -0
  101. package/core/kits/satellite-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 +5 -0
  102. package/core/kits/satellite-matter//344/272/213/351/241/271//346/263/250/345/206/214/350/241/250.md +16 -0
  103. package/core/kits/satellite-matter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +5 -0
  104. package/core/kits/satellite-matter//347/237/245/350/257/206/README.md +5 -0
  105. package/core/kits/satellite-matter//350/276/223/345/207/272//347/241/256/350/256/244/346/210/220/346/236/234/README.md +5 -0
  106. package/core/kits/satellite-matter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +5 -0
  107. package/core/kits/satellite-starter/.agents/skills/README.md +5 -0
  108. package/core/kits/satellite-starter/.claude/skills/README.md +5 -0
  109. package/core/kits/satellite-starter/.core-sync.json +31 -0
  110. package/core/kits/satellite-starter/.internal/README.md +5 -0
  111. package/core/kits/satellite-starter/.obsidian/README.md +5 -0
  112. package/core/kits/satellite-starter/AGENTS.md +25 -0
  113. package/core/kits/satellite-starter/CLAUDE.md +5 -0
  114. package/core/kits/satellite-starter/README.md +42 -0
  115. package/core/kits/satellite-starter/_/347/263/273/347/273/237//344/270/212/344/270/213/346/226/207//345/275/223/345/211/215/351/241/271/347/233/256.md +29 -0
  116. package/core/kits/satellite-starter/_/347/263/273/347/273/237//344/270/273/345/272/223/345/220/214/346/255/245/README.md +40 -0
  117. package/core/kits/satellite-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 +17 -0
  118. package/core/kits/satellite-starter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +8 -0
  119. package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/README.md +9 -0
  120. package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/inbox/README.md +5 -0
  121. package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/outbox/README.md +5 -0
  122. package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +5 -0
  123. package/core/kits/satellite-starter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +5 -0
  124. package/core/kits/satellite-starter//347/237/245/350/257/206/README.md +5 -0
  125. package/core/kits/satellite-starter//350/276/223/345/207/272//347/241/256/350/256/244/346/210/220/346/236/234/README.md +5 -0
  126. package/core/kits/satellite-starter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +5 -0
  127. package/core/presets/README.md +26 -0
  128. package/core/presets/hub.yaml +10 -0
  129. package/core/presets/local-matter.yaml +14 -0
  130. package/core/presets/local-starter.yaml +12 -0
  131. package/core/presets/satellite-matter.yaml +17 -0
  132. package/core/presets/satellite-starter.yaml +15 -0
  133. package/core/profiles/README.md +18 -0
  134. package/core/profiles/en/labels.json +26 -0
  135. package/core/profiles/en/paths.json +21 -0
  136. package/core/profiles/en/profile.md +22 -0
  137. package/core/profiles/en/reference-kits/local-starter/AGENTS.md +23 -0
  138. package/core/profiles/en/reference-kits/local-starter/README.md +23 -0
  139. package/core/profiles/en/reference-kits/local-starter/_system/context/project-status.md +25 -0
  140. package/core/profiles/en/reference-kits/local-starter/_system/identity/README.md +5 -0
  141. package/core/profiles/en/reference-kits/local-starter/_system/lessons/README.md +5 -0
  142. package/core/profiles/en/reference-kits/local-starter/_system/tasks/current-work.md +17 -0
  143. package/core/profiles/en/reference-kits/local-starter/outputs/drafts/README.md +5 -0
  144. package/core/profiles/en/reference-kits/local-starter/outputs/final/README.md +5 -0
  145. package/core/profiles/en/reference-kits/local-starter/references/README.md +5 -0
  146. package/core/profiles/en/reference-presets/local-starter.yaml +12 -0
  147. package/core/profiles/en/templates/AGENTS.md +23 -0
  148. package/core/profiles/en/templates/_system/context/project-status.md +25 -0
  149. package/core/profiles/en/templates/_system/tasks/current-work.md +17 -0
  150. package/core/profiles/zh/labels.json +26 -0
  151. package/core/profiles/zh/paths.json +21 -0
  152. package/core/profiles/zh/profile.md +22 -0
  153. package/core/profiles/zh/templates/AGENTS.md +23 -0
  154. package/core/profiles/zh/templates/_/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 +25 -0
  155. package/core/profiles/zh/templates/_/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 +17 -0
  156. package/docs/README.md +18 -0
  157. package/docs/alpha-test-guide.md +124 -0
  158. package/docs/cli-capabilities.html +1088 -0
  159. package/docs/hub-management.html +750 -0
  160. package/docs/index.html +228 -0
  161. package/docs/product-direction.md +64 -0
  162. package/docs/product-shape-business-model.html +1024 -0
  163. package/docs/roadmap.html +899 -0
  164. package/docs/roadmap.md +272 -0
  165. package/docs/v0.1-plan.md +109 -0
  166. package/examples/README.md +3 -0
  167. package/package.json +32 -0
  168. package/packs/README.md +24 -0
  169. package/packs/content-creator/README.md +38 -0
  170. package/packs/content-creator/languages/en.json +40 -0
  171. package/packs/content-creator/languages/zh.json +40 -0
  172. package/packs/content-creator/pack.json +41 -0
  173. package/packs/content-creator/rules/en/file-boundaries.md +10 -0
  174. package/packs/content-creator/rules/en/overview.md +9 -0
  175. package/packs/content-creator/rules/en/review.md +13 -0
  176. package/packs/content-creator/rules/en/workflow.md +8 -0
  177. package/packs/content-creator/rules/zh/file-boundaries.md +10 -0
  178. package/packs/content-creator/rules/zh/overview.md +9 -0
  179. package/packs/content-creator/rules/zh/review.md +13 -0
  180. package/packs/content-creator/rules/zh/workflow.md +8 -0
  181. package/packs/content-creator/seed/en/account-profile/README.md +3 -0
  182. package/packs/content-creator/seed/en/analytics-review/README.md +3 -0
  183. package/packs/content-creator/seed/en/drafts-and-scripts/README.md +3 -0
  184. package/packs/content-creator/seed/en/ideas/README.md +3 -0
  185. package/packs/content-creator/seed/en/materials/README.md +3 -0
  186. package/packs/content-creator/seed/en/published/README.md +3 -0
  187. package/packs/content-creator/seed/zh//345/217/221/345/270/203/350/256/260/345/275/225/README.md +5 -0
  188. package/packs/content-creator/seed/zh//346/225/260/346/215/256/345/244/215/347/233/230/README.md +3 -0
  189. package/packs/content-creator/seed/zh//347/264/240/346/235/220/345/272/223/README.md +5 -0
  190. package/packs/content-creator/seed/zh//350/215/211/347/250/277/344/270/216/350/204/232/346/234/254/README.md +5 -0
  191. package/packs/content-creator/seed/zh//350/264/246/345/217/267/345/256/232/344/275/215/README.md +3 -0
  192. package/packs/content-creator/seed/zh//351/200/211/351/242/230/346/261/240/README.md +3 -0
  193. package/packs/content-creator/templates/en/content-brief.md +21 -0
  194. package/packs/content-creator/templates/en/publish-record.md +23 -0
  195. package/packs/content-creator/templates/en/weekly-review.md +21 -0
  196. package/packs/content-creator/templates/zh/content-brief.md +30 -0
  197. package/packs/content-creator/templates/zh/publish-record.md +21 -0
  198. package/packs/content-creator/templates/zh/weekly-review.md +22 -0
  199. package/packs/general/README.md +5 -0
  200. package/packs/general/languages/en.json +19 -0
  201. package/packs/general/languages/zh.json +19 -0
  202. package/packs/general/pack.json +20 -0
  203. package/packs/general/rules/en/overview.md +7 -0
  204. package/packs/general/rules/en/workflow.md +6 -0
  205. package/packs/general/rules/zh/overview.md +7 -0
  206. package/packs/general/rules/zh/workflow.md +6 -0
  207. package/packs/hub-management/README.md +5 -0
  208. package/packs/hub-management/languages/en.json +27 -0
  209. package/packs/hub-management/languages/zh.json +27 -0
  210. package/packs/hub-management/pack.json +28 -0
  211. package/packs/hub-management/rules/en/overview.md +7 -0
  212. package/packs/hub-management/rules/en/workflow.md +6 -0
  213. package/packs/hub-management/rules/zh/overview.md +7 -0
  214. package/packs/hub-management/rules/zh/workflow.md +6 -0
  215. package/packs/hub-management/seed/en/.incoming/README.md +3 -0
  216. package/packs/hub-management/seed/en/projects/coordination/README.md +5 -0
  217. package/packs/hub-management/seed/en/projects/registry.json +4 -0
  218. package/packs/hub-management/seed/zh/.incoming/README.md +5 -0
  219. package/packs/hub-management/seed/zh//351/241/271/347/233/256/registry.json +4 -0
  220. package/packs/hub-management/seed/zh//351/241/271/347/233/256//350/201/224/347/273/234/README.md +5 -0
  221. package/packs/pack-structure-spec.md +315 -0
  222. package/schemas/README.md +3 -0
  223. package/skills/README.md +17 -0
  224. package/skills/starworkInit/SKILL.md +289 -0
  225. package/skills/starworkInit/agents/openai.yaml +7 -0
  226. package/skills/starworkInit-spec.md +585 -0
  227. package/skills/starworkSpawn/SKILL.md +136 -0
  228. package/skills/starworkSpawn/agents/openai.yaml +7 -0
@@ -0,0 +1,31 @@
1
+ {
2
+ "core_source": "digital-twin-core",
3
+ "core_source_path": "/Users/shuxinding/digital-twin-core",
4
+ "core_version": "main@<commit-hash>",
5
+ "synced_at": "YYYY-MM-DDTHH:mm:ss+08:00",
6
+ "sync_mode": "bootstrap-copy",
7
+ "synced_resources": {
8
+ "identity": {
9
+ "mode": "snapshot-copy",
10
+ "path": "identity/"
11
+ },
12
+ "lessons": {
13
+ "mode": "snapshot-copy",
14
+ "path": "lessons/"
15
+ },
16
+ "internal_protocols": {
17
+ "mode": "selected-copy",
18
+ "path": ".internal/"
19
+ },
20
+ "obsidian": {
21
+ "mode": "config-copy",
22
+ "path": ".obsidian/"
23
+ },
24
+ "knowledge": {
25
+ "mode": "symlink-readonly",
26
+ "source": "/Users/shuxinding/digital-twin-core/knowledge",
27
+ "mount_path": "知识/"
28
+ }
29
+ },
30
+ "skills": []
31
+ }
@@ -0,0 +1,5 @@
1
+ # 内部协议
2
+
3
+ 这里放从主库复制过来的稳定协议快照,例如回写协议和合并策略。
4
+
5
+ 本目录不是项目工作区,不放草稿、任务记录或交付物。
@@ -0,0 +1,5 @@
1
+ # Obsidian 配置
2
+
3
+ 这里放从主库复制的 Obsidian 默认配置快照。
4
+
5
+ 项目可本地使用,但通用配置变更应优先回到主库维护,再按需同步到卫星项目。
@@ -0,0 +1,27 @@
1
+ # StarWork 工作区规则
2
+
3
+ ## 开始前先读
4
+
5
+ 1. `_系统/上下文/当前项目.md`
6
+ 2. `_系统/任务/当前工作.md`
7
+ 3. 如启用事项模式,再读 `事项/注册表.md`
8
+ 4. 涉及主库资源、共享 skill 或跨项目同步时,读 `_系统/主库同步/README.md`
9
+
10
+ ## 写入边界
11
+
12
+ - 项目状态写入 `_系统/上下文/当前项目.md`
13
+ - 当前工作入口写入 `_系统/任务/当前工作.md`
14
+ - 身份信息放入 `_系统/身份/`,默认只读
15
+ - 项目教训放入 `_系统/教训/`
16
+ - 共享知识入口放在 `知识/`,默认只读
17
+ - 原始资料放入 `参考资料/`,默认只读
18
+ - AI 草稿放入 `输出/草稿/` 或事项的 `草稿/`
19
+ - 用户确认后的成果放入项目声明的正式事实源
20
+ - 跨项目请求、回执和交接记录放入 `_系统/跨项目/`
21
+ - 主库同步规则说明放在 `_系统/主库同步/`;不要创建一个复制主库内容的 `main-repo/` 目录
22
+
23
+ ## 需要确认
24
+
25
+ - 修改身份、教训、共享知识或主库同步内容
26
+ - 将草稿晋升为正式事实源
27
+ - 创建、暂停或归档长期事项
@@ -0,0 +1,5 @@
1
+ # Claude 工作规则
2
+
3
+ 本文件用于给 Claude Code 或兼容 Agent 提供入口规则。
4
+
5
+ 优先遵守 `AGENTS.md`。如本文件与 `AGENTS.md` 冲突,以 `AGENTS.md` 为准,并提醒用户同步修正。
@@ -0,0 +1,40 @@
1
+ # 卫星项目 Matter Kit
2
+
3
+ Preset: `satellite-matter`
4
+
5
+ 适合接入主库、并启用事项机制的卫星项目。
6
+
7
+ ## 包含
8
+
9
+ - 默认中文路径 profile
10
+ - 轻量输出模式
11
+ - 事项模式
12
+ - Decisions
13
+ - 主库同步模式
14
+ - 共享 skill 软链接挂载能力
15
+
16
+ ## 规则
17
+
18
+ 主库是规则源和共享资源源,卫星项目是执行层。
19
+
20
+ 本 kit 预期包含:
21
+
22
+ - `_系统/主库同步/`:主库与卫星项目关系的可见说明
23
+ - `_系统/上下文/当前项目.md`:当前主库兼容的项目状态事实源
24
+ - `_系统/任务/当前工作.md`:当前工作入口
25
+ - `_系统/跨项目/`:跨项目联络单的本地收发记录
26
+ - `_系统/身份/`:来自主库的身份信息初始化快照或链接,默认只读
27
+ - `_系统/教训/`:来自主库的跨项目教训快照,以及项目内可复用教训候选
28
+ - `.internal/`:来自主库的选定协议文件快照
29
+ - `知识/`:指向主库 `knowledge/` 的只读链接
30
+ - `参考资料/`:本项目原始资料和参考材料
31
+ - `输出/`:本项目草稿和确认成果
32
+ - `事项/`:本项目事项推进过程
33
+ - `.core-sync.json`:记录主库来源、同步时间、共享资源和 skill 挂载信息
34
+ - `.agents/skills/`、`.claude/skills/`:按需软链接主库正式 skill
35
+
36
+ 项目特定事实进入项目自己的正式事实源,不写回主库正式目录。
37
+
38
+ `_系统/上下文/当前项目.md` 是卫星项目的项目状态事实源。不要同时维护另一份 `_系统/上下文/项目状态.md`。
39
+
40
+ 注意:`.core-sync.json`、`.internal/`、`.obsidian/` 是隐藏路径,很多文件管理器默认看不到。人类理解主库关系时,优先读 `_系统/主库同步/README.md`。
@@ -0,0 +1,7 @@
1
+ # 决策记录
2
+
3
+ 只记录高影响、已确认、会影响后续多个事项的决策。
4
+
5
+ ## 决策列表
6
+
7
+ 暂无。
@@ -0,0 +1,29 @@
1
+ # 当前项目状态
2
+
3
+ ## 项目目标
4
+
5
+ 待填写。
6
+
7
+ ## 当前阶段
8
+
9
+ 待填写。
10
+
11
+ ## 近期重点
12
+
13
+ - 待填写。
14
+
15
+ ## 主要风险
16
+
17
+ - 待填写。
18
+
19
+ ## 正式事实源
20
+
21
+ 待填写,例如 `输出/确认成果/` 或项目自定义目录。
22
+
23
+ ## 下一步
24
+
25
+ - 待填写。
26
+
27
+ ## 兼容说明
28
+
29
+ 当前主库多项目汇总机制读取 `_系统/上下文/当前项目.md`。如果未来迁移到其他命名,只能保留一个状态事实源,另一个应作为别名、指针或生成副本。
@@ -0,0 +1,42 @@
1
+ # 主库同步
2
+
3
+ 这里是本卫星项目与主库关系的可见说明。
4
+
5
+ 主库不是本项目的上级工作目录,也不是项目进度总账本。主库只提供跨项目共享机制;本项目自己的状态、事项、产物和决策仍然留在本项目内。
6
+
7
+ ## 来自主库的资源
8
+
9
+ | 本项目路径 | 来源 | 落地方式 | 默认规则 |
10
+ |---|---|---|---|
11
+ | `_系统/身份/` | 主库 `identity/` | 初始化快照或链接 | 默认只读;身份修正需要回写主库确认。 |
12
+ | `_系统/教训/` | 主库 `lessons/` + 本项目教训候选 | 初始化快照或本地沉淀 | 默认只读主库快照;新教训先留在项目内,确认可复用后再回写主库。 |
13
+ | `.internal/` | 主库 `.internal/` | 指定协议快照 | 默认只读;只放稳定协议,不放项目草稿。 |
14
+ | `.obsidian/` | 主库 `.obsidian/` | 配置快照 | 可本地使用;通用配置变更优先回主库维护。 |
15
+ | `知识/` | 主库 `knowledge/` | 只读软链接 | 不在卫星项目内直接改共享知识。 |
16
+ | `.agents/skills/` | 主库正式 skills | 按需软链接 | 不复制、不改造主库 skill;需要改造时创建项目专用 skill。 |
17
+ | `.claude/skills/` | 主库正式 skills | 按需软链接 | 同上。 |
18
+ | `.core-sync.json` | 本项目生成 | 同步元数据 | 记录主库来源、同步时间、资源和 skill 挂载信息。 |
19
+
20
+ ## 本项目自己的事实源
21
+
22
+ | 本项目路径 | 用途 |
23
+ |---|---|
24
+ | `_系统/上下文/当前项目.md` | 当前项目状态。主库只读取,不复制进 registry。 |
25
+ | `_系统/任务/当前工作.md` | 当前工作入口。 |
26
+ | `_系统/上下文/决策.md` | 高影响项目决策。 |
27
+ | `事项/` | 事项推进过程。 |
28
+ | `输出/确认成果/` | 默认确认成果位置;项目可以另行声明正式事实源。 |
29
+ | `参考资料/` | 本项目原始资料和参考材料。 |
30
+ | `_系统/跨项目/` | 跨项目联络单收发记录。 |
31
+
32
+ ## 回写主库时怎么做
33
+
34
+ - 身份、教训、知识、通用规则这类可能跨项目复用的内容,不直接改主库正式目录。
35
+ - 先在本项目内形成候选内容,再按主库约定提交到主库 `.incoming/` 或通过跨项目联络单请求主库处理。
36
+ - 项目特定内容留在本项目,不回写主库。
37
+
38
+ ## 为什么没有一个 `main-repo/` 文件夹
39
+
40
+ 主库不是被复制进来的子目录。卫星项目只保留必要的快照、链接和同步元数据。
41
+
42
+ 如果把所有主库内容塞进 `main-repo/`,用户会误以为可以在项目里直接维护主库;这会破坏主库和卫星项目的边界。
@@ -0,0 +1,17 @@
1
+ # 当前工作
2
+
3
+ ## 当前入口
4
+
5
+ 待填写。
6
+
7
+ ## 进行中
8
+
9
+ - 待填写。
10
+
11
+ ## 阻塞或等待确认
12
+
13
+ - 待填写。
14
+
15
+ ## 工作记录
16
+
17
+ - 待填写。
@@ -0,0 +1,8 @@
1
+ # 教训
2
+
3
+ 这里存放本项目可见的教训信息。
4
+
5
+ - 来自主库的跨项目教训快照或链接,默认只读。
6
+ - 本项目内已经验证、后续会复用的经验,可以先作为项目教训候选留在这里。
7
+
8
+ 确认具有跨项目复用价值后,再通过主库回写流程提交。
@@ -0,0 +1,9 @@
1
+ # 跨项目联络
2
+
3
+ 这里存放跨项目 handoff 的本地记录。
4
+
5
+ - `inbox/`:其他项目发来的请求、同步和交接。
6
+ - `outbox/`:本项目发给其他项目或主库的请求、同步和交接。
7
+ - `state.json`:可选的本地索引,用于记录联络单状态、路径和更新时间。
8
+
9
+ 跨项目联络不会直接改写目标项目的业务事实源。目标项目收到后自行判断、处理和回执。
@@ -0,0 +1,5 @@
1
+ # Inbox
2
+
3
+ 这里放其他项目发来的跨项目联络单。
4
+
5
+ 收到后由本项目决定是否接受、补问、拒绝、完成或关闭。
@@ -0,0 +1,5 @@
1
+ # Outbox
2
+
3
+ 这里放本项目发给其他项目或主库的跨项目联络单。
4
+
5
+ 联络单应保留状态、中央路径和回执信息,方便后续追踪。
@@ -0,0 +1,5 @@
1
+ # 身份
2
+
3
+ 本目录用于放置主库分发的身份信息快照或链接。
4
+
5
+ 默认只读。需要修改身份信息时,应回到主库或通过项目约定的同步流程处理。
@@ -0,0 +1,17 @@
1
+ # Matter Title
2
+
3
+ ## Goal
4
+
5
+ TBD.
6
+
7
+ ## Scope
8
+
9
+ TBD.
10
+
11
+ ## Out of Scope
12
+
13
+ TBD.
14
+
15
+ ## Formal Source Promotion Target
16
+
17
+ TBD.
@@ -0,0 +1,3 @@
1
+ # Handoff
2
+
3
+ Use this file for cross-Agent or cross-project handoff notes.
@@ -0,0 +1,5 @@
1
+ # Notes
2
+
3
+ Use this file for discussion notes, research notes, and process judgments.
4
+
5
+ Do not use it as the formal source of truth.
@@ -0,0 +1,16 @@
1
+ # Matters Registry
2
+
3
+ ## Active
4
+
5
+ | matter_id | status | codex_thread_id | path | updated |
6
+ |---|---|---|---|---|
7
+
8
+ ## Paused
9
+
10
+ | matter_id | status | codex_thread_id | path | updated |
11
+ |---|---|---|---|---|
12
+
13
+ ## Archived
14
+
15
+ | matter_id | status | codex_thread_id | path | archived_at |
16
+ |---|---|---|---|---|
@@ -0,0 +1,5 @@
1
+ # 参考资料
2
+
3
+ 这里存放原始资料、参考链接、用户提供的素材。
4
+
5
+ 默认只读。除非用户明确要求,不要改写原始资料。
@@ -0,0 +1,5 @@
1
+ # 知识
2
+
3
+ 初始化真实卫星项目时,本路径应是指向主库 `knowledge/` 的只读软链接。
4
+
5
+ 不要在卫星项目中直接改写共享知识。需要沉淀公共知识时,通过主库约定的回写流程提交。
@@ -0,0 +1,5 @@
1
+ # 确认成果
2
+
3
+ 这里存放用户确认后的成果。
4
+
5
+ 项目可以另行声明正式事实源;在 Starter Mode 中,本目录是默认确认成果位置。
@@ -0,0 +1,5 @@
1
+ # 草稿
2
+
3
+ 这里存放 AI 生成但尚未经过用户确认的草稿。
4
+
5
+ 草稿不是正式事实源。
@@ -0,0 +1,5 @@
1
+ # Agents Skills
2
+
3
+ 这里按需放指向主库正式 skill 的软链接。
4
+
5
+ 不要把主库 skill 复制成项目内独立副本。
@@ -0,0 +1,5 @@
1
+ # Claude Skills
2
+
3
+ 这里按需放指向主库正式 skill 的软链接。
4
+
5
+ 不要把主库 skill 复制成项目内独立副本。
@@ -0,0 +1,31 @@
1
+ {
2
+ "core_source": "digital-twin-core",
3
+ "core_source_path": "/Users/shuxinding/digital-twin-core",
4
+ "core_version": "main@<commit-hash>",
5
+ "synced_at": "YYYY-MM-DDTHH:mm:ss+08:00",
6
+ "sync_mode": "bootstrap-copy",
7
+ "synced_resources": {
8
+ "identity": {
9
+ "mode": "snapshot-copy",
10
+ "path": "identity/"
11
+ },
12
+ "lessons": {
13
+ "mode": "snapshot-copy",
14
+ "path": "lessons/"
15
+ },
16
+ "internal_protocols": {
17
+ "mode": "selected-copy",
18
+ "path": ".internal/"
19
+ },
20
+ "obsidian": {
21
+ "mode": "config-copy",
22
+ "path": ".obsidian/"
23
+ },
24
+ "knowledge": {
25
+ "mode": "symlink-readonly",
26
+ "source": "/Users/shuxinding/digital-twin-core/knowledge",
27
+ "mount_path": "知识/"
28
+ }
29
+ },
30
+ "skills": []
31
+ }
@@ -0,0 +1,5 @@
1
+ # 内部协议
2
+
3
+ 这里放从主库复制过来的稳定协议快照,例如回写协议和合并策略。
4
+
5
+ 本目录不是项目工作区,不放草稿、任务记录或交付物。
@@ -0,0 +1,5 @@
1
+ # Obsidian 配置
2
+
3
+ 这里放从主库复制的 Obsidian 默认配置快照。
4
+
5
+ 项目可本地使用,但通用配置变更应优先回到主库维护,再按需同步到卫星项目。
@@ -0,0 +1,25 @@
1
+ # StarWork 工作区规则
2
+
3
+ ## 开始前先读
4
+
5
+ 1. `_系统/上下文/当前项目.md`
6
+ 2. `_系统/任务/当前工作.md`
7
+ 3. 涉及主库资源、共享 skill 或跨项目同步时,读 `_系统/主库同步/README.md`
8
+
9
+ ## 写入边界
10
+
11
+ - 项目状态写入 `_系统/上下文/当前项目.md`
12
+ - 当前工作入口写入 `_系统/任务/当前工作.md`
13
+ - 身份信息放入 `_系统/身份/`,默认只读
14
+ - 项目教训放入 `_系统/教训/`
15
+ - 共享知识入口放在 `知识/`,默认只读
16
+ - 原始资料放入 `参考资料/`,默认只读
17
+ - AI 草稿放入 `输出/草稿/`
18
+ - 用户确认后的成果放入项目声明的正式事实源
19
+ - 跨项目请求、回执和交接记录放入 `_系统/跨项目/`
20
+ - 主库同步规则说明放在 `_系统/主库同步/`;不要创建一个复制主库内容的 `main-repo/` 目录
21
+
22
+ ## 需要确认
23
+
24
+ - 修改身份、教训、共享知识或主库同步内容
25
+ - 将草稿晋升为正式事实源
@@ -0,0 +1,5 @@
1
+ # Claude 工作规则
2
+
3
+ 本文件用于给 Claude Code 或兼容 Agent 提供入口规则。
4
+
5
+ 优先遵守 `AGENTS.md`。如本文件与 `AGENTS.md` 冲突,以 `AGENTS.md` 为准,并提醒用户同步修正。
@@ -0,0 +1,42 @@
1
+ # 卫星项目 Starter Kit
2
+
3
+ Preset: `satellite-starter`
4
+
5
+ 适合接入主库的轻量卫星项目。
6
+
7
+ ## 包含
8
+
9
+ - 默认中文路径 profile
10
+ - 轻量输出模式
11
+ - 主库同步模式
12
+ - 共享 skill 软链接挂载能力
13
+
14
+ ## 规则
15
+
16
+ 主库是规则源和共享资源源,卫星项目是执行层。
17
+
18
+ 本 kit 预期包含:
19
+
20
+ - `_系统/主库同步/`:主库与卫星项目关系的可见说明
21
+ - `_系统/上下文/当前项目.md`:当前主库兼容的项目状态事实源
22
+ - `_系统/任务/当前工作.md`:当前工作入口
23
+ - `_系统/跨项目/`:跨项目联络单的本地收发记录
24
+ - `_系统/身份/`:来自主库的身份信息初始化快照或链接,默认只读
25
+ - `_系统/教训/`:来自主库的跨项目教训快照,以及项目内可复用教训候选
26
+ - `.internal/`:来自主库的选定协议文件快照
27
+ - `知识/`:指向主库 `knowledge/` 的只读链接
28
+ - `参考资料/`:本项目原始资料和参考材料
29
+ - `输出/`:本项目草稿和确认成果
30
+ - `.core-sync.json`:记录主库来源、同步时间、共享资源和 skill 挂载信息
31
+ - `.agents/skills/`、`.claude/skills/`:按需软链接主库正式 skill
32
+
33
+ ## 不默认包含
34
+
35
+ - `事项/`
36
+ - `_系统/上下文/决策.md`
37
+
38
+ 项目特定事实进入项目自己的正式事实源,不写回主库正式目录。
39
+
40
+ `_系统/上下文/当前项目.md` 是卫星项目的项目状态事实源。不要同时维护另一份 `_系统/上下文/项目状态.md`。
41
+
42
+ 注意:`.core-sync.json`、`.internal/`、`.obsidian/` 是隐藏路径,很多文件管理器默认看不到。人类理解主库关系时,优先读 `_系统/主库同步/README.md`。
@@ -0,0 +1,29 @@
1
+ # 当前项目状态
2
+
3
+ ## 项目目标
4
+
5
+ 待填写。
6
+
7
+ ## 当前阶段
8
+
9
+ 待填写。
10
+
11
+ ## 近期重点
12
+
13
+ - 待填写。
14
+
15
+ ## 主要风险
16
+
17
+ - 待填写。
18
+
19
+ ## 正式事实源
20
+
21
+ 待填写,例如 `输出/确认成果/` 或项目自定义目录。
22
+
23
+ ## 下一步
24
+
25
+ - 待填写。
26
+
27
+ ## 兼容说明
28
+
29
+ 当前主库多项目汇总机制读取 `_系统/上下文/当前项目.md`。如果未来迁移到其他命名,只能保留一个状态事实源,另一个应作为别名、指针或生成副本。
@@ -0,0 +1,40 @@
1
+ # 主库同步
2
+
3
+ 这里是本卫星项目与主库关系的可见说明。
4
+
5
+ 主库不是本项目的上级工作目录,也不是项目进度总账本。主库只提供跨项目共享机制;本项目自己的状态、当前工作、参考资料、草稿和确认成果仍然留在本项目内。
6
+
7
+ ## 来自主库的资源
8
+
9
+ | 本项目路径 | 来源 | 落地方式 | 默认规则 |
10
+ |---|---|---|---|
11
+ | `_系统/身份/` | 主库 `identity/` | 初始化快照或链接 | 默认只读;身份修正需要回写主库确认。 |
12
+ | `_系统/教训/` | 主库 `lessons/` + 本项目教训候选 | 初始化快照或本地沉淀 | 默认只读主库快照;新教训先留在项目内,确认可复用后再回写主库。 |
13
+ | `.internal/` | 主库 `.internal/` | 指定协议快照 | 默认只读;只放稳定协议,不放项目草稿。 |
14
+ | `.obsidian/` | 主库 `.obsidian/` | 配置快照 | 可本地使用;通用配置变更优先回主库维护。 |
15
+ | `知识/` | 主库 `knowledge/` | 只读软链接 | 不在卫星项目内直接改共享知识。 |
16
+ | `.agents/skills/` | 主库正式 skills | 按需软链接 | 不复制、不改造主库 skill;需要改造时创建项目专用 skill。 |
17
+ | `.claude/skills/` | 主库正式 skills | 按需软链接 | 同上。 |
18
+ | `.core-sync.json` | 本项目生成 | 同步元数据 | 记录主库来源、同步时间、资源和 skill 挂载信息。 |
19
+
20
+ ## 本项目自己的事实源
21
+
22
+ | 本项目路径 | 用途 |
23
+ |---|---|
24
+ | `_系统/上下文/当前项目.md` | 当前项目状态。主库只读取,不复制进 registry。 |
25
+ | `_系统/任务/当前工作.md` | 当前工作入口。 |
26
+ | `输出/确认成果/` | 默认确认成果位置;项目可以另行声明正式事实源。 |
27
+ | `参考资料/` | 本项目原始资料和参考材料。 |
28
+ | `_系统/跨项目/` | 跨项目联络单收发记录。 |
29
+
30
+ ## 回写主库时怎么做
31
+
32
+ - 身份、教训、知识、通用规则这类可能跨项目复用的内容,不直接改主库正式目录。
33
+ - 先在本项目内形成候选内容,再按主库约定提交到主库 `.incoming/` 或通过跨项目联络单请求主库处理。
34
+ - 项目特定内容留在本项目,不回写主库。
35
+
36
+ ## 为什么没有一个 `main-repo/` 文件夹
37
+
38
+ 主库不是被复制进来的子目录。卫星项目只保留必要的快照、链接和同步元数据。
39
+
40
+ 如果把所有主库内容塞进 `main-repo/`,用户会误以为可以在项目里直接维护主库;这会破坏主库和卫星项目的边界。
@@ -0,0 +1,17 @@
1
+ # 当前工作
2
+
3
+ ## 当前入口
4
+
5
+ 待填写。
6
+
7
+ ## 进行中
8
+
9
+ - 待填写。
10
+
11
+ ## 阻塞或等待确认
12
+
13
+ - 待填写。
14
+
15
+ ## 工作记录
16
+
17
+ - 待填写。
@@ -0,0 +1,8 @@
1
+ # 教训
2
+
3
+ 这里存放本项目可见的教训信息。
4
+
5
+ - 来自主库的跨项目教训快照或链接,默认只读。
6
+ - 本项目内已经验证、后续会复用的经验,可以先作为项目教训候选留在这里。
7
+
8
+ 确认具有跨项目复用价值后,再通过主库回写流程提交。
@@ -0,0 +1,9 @@
1
+ # 跨项目联络
2
+
3
+ 这里存放跨项目 handoff 的本地记录。
4
+
5
+ - `inbox/`:其他项目发来的请求、同步和交接。
6
+ - `outbox/`:本项目发给其他项目或主库的请求、同步和交接。
7
+ - `state.json`:可选的本地索引,用于记录联络单状态、路径和更新时间。
8
+
9
+ 跨项目联络不会直接改写目标项目的业务事实源。目标项目收到后自行判断、处理和回执。
@@ -0,0 +1,5 @@
1
+ # Inbox
2
+
3
+ 这里放其他项目发来的跨项目联络单。
4
+
5
+ 收到后由本项目决定是否接受、补问、拒绝、完成或关闭。
@@ -0,0 +1,5 @@
1
+ # Outbox
2
+
3
+ 这里放本项目发给其他项目或主库的跨项目联络单。
4
+
5
+ 联络单应保留状态、中央路径和回执信息,方便后续追踪。
@@ -0,0 +1,5 @@
1
+ # 身份
2
+
3
+ 本目录用于放置主库分发的身份信息快照或链接。
4
+
5
+ 默认只读。需要修改身份信息时,应回到主库或通过项目约定的同步流程处理。
@@ -0,0 +1,5 @@
1
+ # 参考资料
2
+
3
+ 这里存放原始资料、参考链接、用户提供的素材。
4
+
5
+ 默认只读。除非用户明确要求,不要改写原始资料。
@@ -0,0 +1,5 @@
1
+ # 知识
2
+
3
+ 初始化真实卫星项目时,本路径应是指向主库 `knowledge/` 的只读软链接。
4
+
5
+ 不要在卫星项目中直接改写共享知识。需要沉淀公共知识时,通过主库约定的回写流程提交。
@@ -0,0 +1,5 @@
1
+ # 确认成果
2
+
3
+ 这里存放用户确认后的成果。
4
+
5
+ 项目可以另行声明正式事实源;在 Starter Mode 中,本目录是默认确认成果位置。
@@ -0,0 +1,5 @@
1
+ # 草稿
2
+
3
+ 这里存放 AI 生成但尚未经过用户确认的草稿。
4
+
5
+ 草稿不是正式事实源。