@namewta/speculo 2.0.6 → 2.1.1

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 (273) hide show
  1. package/README.md +3 -0
  2. package/THIRD-PARTY-NOTICES.md +4 -0
  3. package/dist/src/agent-skills.d.ts +5 -0
  4. package/dist/src/agent-skills.js +10 -7
  5. package/dist/src/agent-skills.js.map +1 -1
  6. package/dist/src/cli.js +25 -36
  7. package/dist/src/cli.js.map +1 -1
  8. package/dist/src/coordination.d.ts +3 -3
  9. package/dist/src/coordination.js +21 -4
  10. package/dist/src/coordination.js.map +1 -1
  11. package/dist/src/doctor.js +8 -1
  12. package/dist/src/doctor.js.map +1 -1
  13. package/dist/src/external-files.d.ts +4 -2
  14. package/dist/src/external-files.js +4 -4
  15. package/dist/src/external-files.js.map +1 -1
  16. package/dist/src/hub-catalog.d.ts +11 -0
  17. package/dist/src/hub-catalog.js +91 -0
  18. package/dist/src/hub-catalog.js.map +1 -0
  19. package/dist/src/hub-resources.json +1 -0
  20. package/dist/src/hub-skills.d.ts +53 -0
  21. package/dist/src/hub-skills.js +157 -0
  22. package/dist/src/hub-skills.js.map +1 -0
  23. package/dist/src/index.d.ts +6 -0
  24. package/dist/src/index.js +48 -47
  25. package/dist/src/index.js.map +1 -1
  26. package/dist/src/install-ui.d.ts +16 -7
  27. package/dist/src/install-ui.js +143 -92
  28. package/dist/src/install-ui.js.map +1 -1
  29. package/dist/src/manifest.d.ts +2 -0
  30. package/dist/src/manifest.js +2 -0
  31. package/dist/src/manifest.js.map +1 -1
  32. package/dist/src/refresh.d.ts +1 -0
  33. package/dist/src/refresh.js +13 -10
  34. package/dist/src/refresh.js.map +1 -1
  35. package/dist/src/retained-workflows.d.ts +10 -0
  36. package/dist/src/retained-workflows.js +25 -0
  37. package/dist/src/retained-workflows.js.map +1 -0
  38. package/dist/src/runtime-entry.d.ts +1 -0
  39. package/dist/src/runtime-entry.js +1 -0
  40. package/dist/src/runtime-entry.js.map +1 -1
  41. package/dist/src/skill-trees.d.ts +27 -0
  42. package/dist/src/skill-trees.js +118 -0
  43. package/dist/src/skill-trees.js.map +1 -0
  44. package/dist/src/terminal-ui.d.ts +30 -0
  45. package/dist/src/terminal-ui.js +148 -0
  46. package/dist/src/terminal-ui.js.map +1 -0
  47. package/dist/src/transaction.d.ts +3 -14
  48. package/dist/src/transaction.js +20 -36
  49. package/dist/src/transaction.js.map +1 -1
  50. package/dist/src/workflow-install.d.ts +15 -0
  51. package/dist/src/workflow-install.js +104 -0
  52. package/dist/src/workflow-install.js.map +1 -0
  53. package/dist/src/workflows.js +1 -1
  54. package/dist/src/workflows.js.map +1 -1
  55. package/package.json +6 -2
  56. package/skills-hub/automation/grok-bot-team-steward/CHEATSHEET.md +17 -0
  57. package/skills-hub/automation/grok-bot-team-steward/INSTALL.md +23 -0
  58. package/skills-hub/automation/grok-bot-team-steward/LICENSE +21 -0
  59. package/skills-hub/automation/grok-bot-team-steward/README.md +9 -0
  60. package/skills-hub/automation/grok-bot-team-steward/SKILL.md +52 -0
  61. package/skills-hub/automation/grok-bot-team-steward/agents/openai.yaml +4 -0
  62. package/skills-hub/automation/grok-bot-team-steward/references/00-hard-rules.md +50 -0
  63. package/skills-hub/automation/grok-bot-team-steward/references/01-snapshot-schema.md +84 -0
  64. package/skills-hub/automation/grok-bot-team-steward/references/02-export-protocol.md +57 -0
  65. package/skills-hub/automation/grok-bot-team-steward/references/03-restore-protocol.md +64 -0
  66. package/skills-hub/automation/grok-bot-team-steward/references/04-inventory.md +37 -0
  67. package/skills-hub/automation/grok-bot-team-steward/references/05-conversations.md +71 -0
  68. package/skills-hub/automation/grok-bot-team-steward/references/06-sanitizer.md +39 -0
  69. package/skills-hub/automation/grok-bot-team-steward/references/07-prompts.md +87 -0
  70. package/skills-hub/automation/grok-bot-team-steward/references/08-verification.md +30 -0
  71. package/skills-hub/automation/grok-bot-team-steward/references/09-sources.md +31 -0
  72. package/skills-hub/automation/grok-bot-team-steward/scripts/scrub.sh +17 -0
  73. package/skills-hub/automation/grok-bot-team-steward/scripts/snapshot-name.sh +18 -0
  74. package/skills-hub/automation/grok-bot-team-steward/scripts/validate-snapshot.sh +62 -0
  75. package/skills-hub/automation/grok-bot-team-steward/steward/ACTIVATE.md +58 -0
  76. package/skills-hub/automation/grok-bot-team-steward/steward/SETUP-INSTRUCTIONS.md +33 -0
  77. package/skills-hub/automation/grok-bot-team-steward/steward/STEWARD-PROFILE.md +28 -0
  78. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/CHANGELOG.md +3 -0
  79. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/CHARTER.md +27 -0
  80. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/DROP-LIST.md +10 -0
  81. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/GAPS.md +6 -0
  82. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/INIT.md +14 -0
  83. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/MANIFEST.md +30 -0
  84. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/MANIFEST.yaml +20 -0
  85. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/ORG.md +15 -0
  86. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/README.md +8 -0
  87. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/RESTORE.md +13 -0
  88. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/ROSTER.md +11 -0
  89. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/GAPS.md +7 -0
  90. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/MEMORY.md +9 -0
  91. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/PROFILE.md +27 -0
  92. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/agent-spec.md +9 -0
  93. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/conversations/INDEX.md +5 -0
  94. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/conversations/main.md +9 -0
  95. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/routines.md +5 -0
  96. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/bots/_SLUG/skills.md +5 -0
  97. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/connectors.md +7 -0
  98. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/COMPLETED.md +6 -0
  99. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/CREATED.md +6 -0
  100. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/RESTORE-NOTES.md +13 -0
  101. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/SANITIZER.md +7 -0
  102. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/meta/SOURCE.md +8 -0
  103. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/rooms/_ROOM.md +8 -0
  104. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/routines/_ROUTINE.md +12 -0
  105. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/shared/shared-memory.md +5 -0
  106. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/shared/workspace-map.md +5 -0
  107. package/skills-hub/automation/grok-bot-team-steward/templates/snapshot/skills/_SKILL/SKILL.md +18 -0
  108. package/skills-hub/automation/herdr/SKILL.md +246 -0
  109. package/skills-hub/automation/orca/SKILL.md +328 -0
  110. package/skills-hub/coding/gitea-repo/LICENSE +21 -0
  111. package/skills-hub/coding/gitea-repo/SKILL.md +50 -0
  112. package/skills-hub/coding/gitea-repo/agents/openai.yaml +4 -0
  113. package/skills-hub/coding/gitea-repo/references/auth-and-scopes.md +58 -0
  114. package/skills-hub/coding/gitea-repo/references/endpoint-map.md +80 -0
  115. package/skills-hub/coding/gitea-repo/references/pagination-and-errors.md +34 -0
  116. package/skills-hub/coding/gitea-repo/scripts/gitea_api.py +814 -0
  117. package/skills-hub/coding/github-repo-steward/LICENSE +21 -0
  118. package/skills-hub/coding/github-repo-steward/SKILL.md +48 -0
  119. package/skills-hub/coding/github-repo-steward/agents/openai.yaml +4 -0
  120. package/skills-hub/coding/github-repo-steward/references/00-auth-and-tokens.md +73 -0
  121. package/skills-hub/coding/github-repo-steward/references/01-inventory.md +55 -0
  122. package/skills-hub/coding/github-repo-steward/references/02-lifecycle.md +57 -0
  123. package/skills-hub/coding/github-repo-steward/references/03-stars.md +42 -0
  124. package/skills-hub/coding/github-repo-steward/references/04-hygiene.md +40 -0
  125. package/skills-hub/coding/github-repo-steward/references/05-sources.md +42 -0
  126. package/skills-hub/coding/github-repo-steward/scripts/inventory.sh +64 -0
  127. package/skills-hub/coding/vscode-fullstack/LICENSE +21 -0
  128. package/skills-hub/coding/vscode-fullstack/SKILL.md +47 -0
  129. package/skills-hub/coding/vscode-fullstack/agents/openai.yaml +4 -0
  130. package/skills-hub/coding/vscode-fullstack/references/extensions-and-settings.md +181 -0
  131. package/skills-hub/coding/vscode-fullstack/references/profiles-and-validation.md +62 -0
  132. package/skills-hub/coding/vscode-fullstack/references/runtime-reuse.md +52 -0
  133. package/skills-hub/design/photo-retouch/LICENSE +21 -0
  134. package/skills-hub/design/photo-retouch/SKILL.md +50 -0
  135. package/skills-hub/design/photo-retouch/agents/openai.yaml +4 -0
  136. package/skills-hub/design/photo-retouch/references/basic-retouch.md +58 -0
  137. package/skills-hub/design/photo-retouch/references/formal-portrait.md +57 -0
  138. package/skills-hub/design/photo-retouch/references/object-and-canvas.md +82 -0
  139. package/skills-hub/design/photo-retouch/references/product-photo.md +41 -0
  140. package/skills-hub/design/photo-retouch/references/repair-and-look.md +61 -0
  141. package/skills-hub/design/photo-retouch/references/social-effects.md +55 -0
  142. package/skills-hub/design/photo-retouch/references/travel-creative.md +79 -0
  143. package/skills-hub/system/clash-client-profile/LICENSE +21 -0
  144. package/skills-hub/system/clash-client-profile/SKILL.md +79 -0
  145. package/skills-hub/system/clash-client-profile/agents/openai.yaml +4 -0
  146. package/skills-hub/system/clash-client-profile/references/acceptance.md +81 -0
  147. package/skills-hub/system/clash-client-profile/references/browser-privacy.md +35 -0
  148. package/skills-hub/system/clash-client-profile/references/clash-verge.md +40 -0
  149. package/skills-hub/system/clash-client-profile/references/dns-workflow.md +147 -0
  150. package/skills-hub/system/clash-client-profile/references/flclash.md +24 -0
  151. package/skills-hub/system/clash-client-profile/references/network-performance.md +25 -0
  152. package/skills-hub/system/clash-client-profile/references/platform-dns.md +109 -0
  153. package/skills-hub/system/clash-client-profile/references/sources.md +46 -0
  154. package/skills-hub/system/clash-client-profile/references/troubleshooting.md +82 -0
  155. package/skills-hub/system/clash-client-profile/scripts/dns_guard.py +650 -0
  156. package/skills-hub/system/clash-client-profile/scripts/proxy_doctor.py +213 -0
  157. package/skills-hub/system/clash-client-profile/scripts/render_rules.py +34 -0
  158. package/skills-hub/system/clash-client-profile/templates/ai-rules.yaml +18 -0
  159. package/skills-hub/system/clash-client-profile/templates/dns-request.example.json +9 -0
  160. package/skills-hub/system/clash-client-profile/templates/dns.yaml +8 -0
  161. package/skills-hub/system/linux-dev-disk-cleanup/LICENSE +21 -0
  162. package/skills-hub/system/linux-dev-disk-cleanup/SKILL.md +42 -0
  163. package/skills-hub/system/linux-dev-disk-cleanup/agents/openai.yaml +4 -0
  164. package/skills-hub/system/linux-dev-disk-cleanup/references/linux-cleanup-workflow.md +145 -0
  165. package/skills-hub/system/optimize-codex-config/LICENSE +21 -0
  166. package/skills-hub/system/optimize-codex-config/SKILL.md +101 -0
  167. package/skills-hub/system/optimize-codex-config/agents/openai.yaml +4 -0
  168. package/skills-hub/system/optimize-codex-config/assets/capabilities.example.json +22 -0
  169. package/skills-hub/system/optimize-codex-config/references/cli.md +35 -0
  170. package/skills-hub/system/optimize-codex-config/references/configuration-contract.md +33 -0
  171. package/skills-hub/system/optimize-codex-config/references/optimization-method.md +38 -0
  172. package/skills-hub/system/optimize-codex-config/references/privacy.md +41 -0
  173. package/skills-hub/system/optimize-codex-config/references/sources.md +24 -0
  174. package/skills-hub/system/optimize-codex-config/references/statusline.md +31 -0
  175. package/skills-hub/system/optimize-codex-config/references/transactions.md +32 -0
  176. package/skills-hub/system/optimize-codex-config/references/troubleshooting.md +95 -0
  177. package/skills-hub/system/optimize-codex-config/scripts/adapters/claude.mjs +24 -0
  178. package/skills-hub/system/optimize-codex-config/scripts/adapters/codex.mjs +10 -0
  179. package/skills-hub/system/optimize-codex-config/scripts/ai-cli-config.mjs +67 -0
  180. package/skills-hub/system/optimize-codex-config/scripts/audit-codex-config.mjs +762 -0
  181. package/skills-hub/system/optimize-codex-config/scripts/lib/document.mjs +166 -0
  182. package/skills-hub/system/optimize-codex-config/scripts/lib/inspect.mjs +211 -0
  183. package/skills-hub/system/optimize-codex-config/scripts/lib/io.mjs +104 -0
  184. package/skills-hub/system/optimize-codex-config/scripts/lib/plan.mjs +79 -0
  185. package/skills-hub/system/optimize-codex-config/scripts/lib/transaction.mjs +205 -0
  186. package/skills-hub/system/optimize-codex-config/scripts/lib/writers.mjs +46 -0
  187. package/skills-hub/system/optimize-codex-config/scripts/statusline/claude-statusline.mjs +94 -0
  188. package/skills-hub/system/optimize-codex-config/scripts/vendor/THIRD-PARTY-NOTICES.txt +250 -0
  189. package/skills-hub/system/optimize-codex-config/scripts/vendor/build-package-lock.json +488 -0
  190. package/skills-hub/system/optimize-codex-config/scripts/vendor/manifest.json +14 -0
  191. package/skills-hub/system/optimize-codex-config/scripts/vendor/parsers.mjs +16 -0
  192. package/skills-hub/system/proxy-region-locale/LICENSE +21 -0
  193. package/skills-hub/system/proxy-region-locale/SKILL.md +42 -0
  194. package/skills-hub/system/proxy-region-locale/agents/openai.yaml +4 -0
  195. package/skills-hub/system/proxy-region-locale/references/linux.md +35 -0
  196. package/skills-hub/system/proxy-region-locale/references/macos.md +31 -0
  197. package/skills-hub/system/proxy-region-locale/references/windows.md +45 -0
  198. package/skills-hub/system/system-health-audit/LICENSE +21 -0
  199. package/skills-hub/system/system-health-audit/SKILL.md +41 -0
  200. package/skills-hub/system/system-health-audit/agents/openai.yaml +4 -0
  201. package/skills-hub/system/system-health-audit/references/platforms.md +37 -0
  202. package/skills-hub/system/system-health-audit/scripts/system_audit.py +41 -0
  203. package/skills-hub/system/windows-dev-disk-cleanup/LICENSE +21 -0
  204. package/skills-hub/system/windows-dev-disk-cleanup/SKILL.md +40 -0
  205. package/skills-hub/system/windows-dev-disk-cleanup/agents/openai.yaml +4 -0
  206. package/skills-hub/system/windows-dev-disk-cleanup/references/windows-cleanup-workflow.md +121 -0
  207. package/skills-hub/writing/.gitkeep +0 -0
  208. package/skills-hub/writing/job-application/LICENSE +21 -0
  209. package/skills-hub/writing/job-application/SKILL.md +160 -0
  210. package/skills-hub/writing/job-application/agents/openai.yaml +4 -0
  211. package/skills-hub/writing/job-application/assets/resume.css +10 -0
  212. package/skills-hub/writing/job-application/config.example.json +9 -0
  213. package/skills-hub/writing/job-application/references/company-research.md +7 -0
  214. package/skills-hub/writing/job-application/references/corpus-schema.md +33 -0
  215. package/skills-hub/writing/job-application/references/honesty-gate.md +29 -0
  216. package/skills-hub/writing/job-application/references/improvement-plan.md +15 -0
  217. package/skills-hub/writing/job-application/references/ingest-protocol.md +18 -0
  218. package/skills-hub/writing/job-application/references/interview-speech.md +16 -0
  219. package/skills-hub/writing/job-application/references/jd-parse.md +18 -0
  220. package/skills-hub/writing/job-application/references/persist-paths.md +34 -0
  221. package/skills-hub/writing/job-application/references/question-bank.md +19 -0
  222. package/skills-hub/writing/job-application/references/rendering.md +9 -0
  223. package/skills-hub/writing/job-application/references/resume-playbook.md +30 -0
  224. package/skills-hub/writing/job-application/scripts/README.md +12 -0
  225. package/skills-hub/writing/job-application/scripts/ingest_kb.py +188 -0
  226. package/skills-hub/writing/job-application/scripts/render_resume.py +144 -0
  227. package/skills-hub/writing/job-application/scripts/validate_claims.py +52 -0
  228. package/skills-hub/writing/job-application/scripts/write_config.py +72 -0
  229. package/skills-hub/writing/job-application/templates/application-index.md +10 -0
  230. package/skills-hub/writing/job-application/templates/brief.md +16 -0
  231. package/skills-hub/writing/job-application/templates/changelog.md +6 -0
  232. package/skills-hub/writing/job-application/templates/company-research.md +15 -0
  233. package/skills-hub/writing/job-application/templates/corpus.md +11 -0
  234. package/skills-hub/writing/job-application/templates/evidence-map.md +5 -0
  235. package/skills-hub/writing/job-application/templates/framings.md +6 -0
  236. package/skills-hub/writing/job-application/templates/improvement-plan.md +16 -0
  237. package/skills-hub/writing/job-application/templates/ingest-log.md +4 -0
  238. package/skills-hub/writing/job-application/templates/known-gaps.md +4 -0
  239. package/skills-hub/writing/job-application/templates/match-report.md +21 -0
  240. package/skills-hub/writing/job-application/templates/methodology-cache.md +10 -0
  241. package/skills-hub/writing/job-application/templates/persist-index.md +11 -0
  242. package/skills-hub/writing/job-application/templates/profile.md +21 -0
  243. package/skills-hub/writing/job-application/templates/questions.md +22 -0
  244. package/skills-hub/writing/job-application/templates/resume-original.md +10 -0
  245. package/skills-hub/writing/job-application/templates/resume-tailored.md +21 -0
  246. package/skills-hub/writing/job-application/templates/sources-index.md +6 -0
  247. package/skills-hub/writing/job-application/templates/speech.md +19 -0
  248. package/skills-hub/writing/job-application/templates/stories.md +9 -0
  249. package/skills-hub/writing/job-application/templates/story-bank.md +11 -0
  250. package/skills-hub/writing/job-application/templates/strengths.md +4 -0
  251. package/skills-hub/writing/job-application/templates/style-memory.md +7 -0
  252. package/skills-hub/writing/ste-zh/LICENSE +21 -0
  253. package/skills-hub/writing/ste-zh/NOTICE.md +9 -0
  254. package/skills-hub/writing/ste-zh/SKILL.md +130 -0
  255. package/skills-hub/writing/ste-zh/agents/openai.yaml +6 -0
  256. package/skills-hub/writing/ste-zh/examples/zh-report.md +23 -0
  257. package/skills-hub/writing/ste-zh/references/english-modes.md +13 -0
  258. package/skills-hub/writing/ste-zh/references/terminology.md +13 -0
  259. package/skills-hub/writing/ste-zh/references/zh-rules.md +29 -0
  260. package/template/.speculo/refresh-contract.json +2 -0
  261. package/template/canonical/canonical-specdev-goal-plan.md +33 -25
  262. package/template/canonical/canonical-specdev-grill-with-docs.md +214 -206
  263. package/template/canonical/canonical-specdev-spec.md +214 -206
  264. package/template/canonical/canonical-specdev-tickets.md +214 -206
  265. package/template/canonical/canonical-specdev-wayfinder.md +214 -206
  266. package/template/lib/speculo-runtime.mjs +183 -8
  267. package/template/references/coordination/coordination-contract.md +11 -3
  268. package/template/references/coordination/modes/cli.md +2 -2
  269. package/template/references/coordination/modes/herdr.md +9 -9
  270. package/template/references/coordination/modes/orca.md +11 -11
  271. package/template/references/coordination/project-facts.schema.json +1 -0
  272. package/template/workflows/specdev/specdev-i-init-setup/SKILL.md +7 -6
  273. package/template/workflows/specdev/specdev-i-init-setup/references/first-setup.md +30 -1
@@ -0,0 +1,33 @@
1
+ # 管家授权安装
2
+
3
+ 路径约定:执行或转发示例前,将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令;不得新建根目录来迎合模板。
4
+ 仅在用户明确要求创建或配置管家时执行本文件。仅加载技能、比较快照不创建 Bot、不修改 profile、不联系其他 Bot。已有管家先复用,不创建第二个管家。下列 `/workspace/grok-bot-team-steward/` 是部署示例,实际技能路径以本轮 SKILL.md 所在目录为准。
5
+
6
+ 把本文件发给一个新建的 Grok Bot。它读完后应把自己变成团队管家。
7
+
8
+ ## 你的身份
9
+
10
+ Name:管家
11
+ Title:Grok Bot 团队管家
12
+
13
+ Description 使用下面整段,保存到自己的 profile,不要缩写。
14
+
15
+ 你是 **管家**,本账号 Grok Bot 团队的档案官和冷启动员。主责只有两件:把当前团队写成 `/workspace/grok-bot-team-YYYY-MM-DD/` 快照;或读取这样一份快照,在本账号重建花名册、技能、群聊、记忆参考和暂停态例行任务。激活并遵守技能 `grok-bot-team-steward`。接收条件:用户要求快照、备份、持久化、导出、换机初始化、恢复、或上传了 `grok-bot-team-20*` 目录。做法:先判定 snapshot 还是 restore。snapshot 时盘点活花名册,让每个 Bot 自述 PROFILE / MEMORY / routines / 对话,再写共享层、脱敏、MANIFEST。restore 时先只读预览,等人连接插件并确认「按这份建」,再创建空白 Bot 并逐字写入 PROFILE,不使用 Duplicate 作为主路径。交付:快照目录绝对路径,或恢复对照表 + DROP LIST。授权:不发送外部邮件、不发帖、不付款、不改生产、不发起 OAuth、不向用户索要 token、不启用 routine。停止:完成 / 待确认 / 找不到快照 / 用户叫停。
16
+
17
+ ## 技能正文位置
18
+
19
+ 先在工作区定位:
20
+
21
+ ```
22
+ /workspace/grok-bot-team-steward/SKILL.md
23
+ ```
24
+
25
+ 若路径不同,搜索 `SKILL.md` 且目录名含 `grok-bot-team-steward`。读取该文件和同级 `references/`,保存为私有技能 `grok-bot-team-steward` 并启用给自己。
26
+
27
+ ## 保存后立刻做
28
+
29
+ 1. 回复:技能已启用。
30
+ 2. 扫描 `/workspace/grok-bot-team-20*`。
31
+ 3. 若存在完整快照且用户要初始化 → restore,先预览。
32
+ 4. 否则 → snapshot,先给出花名册草稿。
33
+ 5. 遵守硬规则:dated 目录不覆盖、不发明角色、不写密钥、routine 恢复为暂停、对话导不出就写 GAPS、不宣称 100% 一模一样。
@@ -0,0 +1,28 @@
1
+ # 团队管家
2
+
3
+ 路径约定:执行或转发示例前,将 `/workspace` 替换为本轮已确认工作区、技能路径替换为实际 SKILL.md 所在目录。未完成替换就不发送命令;不得新建根目录来迎合模板。
4
+ | 字段 | 值 |
5
+ |---|---|
6
+ | name | 管家 |
7
+ | title | Grok Bot 团队管家 |
8
+ | autonomy | L1。导出可自行落盘;恢复必须先预览再创建;启用 routine 必须用户点头 |
9
+
10
+ ## Description(整段贴进 Bot actions → Edit Profile)
11
+
12
+ 你是 **管家**,本账号 Grok Bot 团队的档案官和冷启动员。
13
+
14
+ 主责只有两件:把当前团队写成 `/workspace/grok-bot-team-YYYY-MM-DD/` 快照;或读取这样一份快照,在本账号重建花名册、技能、群聊、记忆参考和暂停态例行任务。
15
+
16
+ 激活并遵守技能 `grok-bot-team-steward`(本技能目录内 SKILL.md 与 references/)。与本描述冲突时以该技能的硬规则为准。
17
+
18
+ 接收条件:用户要求快照、备份、持久化、导出、换机初始化、恢复、或上传了 `grok-bot-team-20*` 目录。
19
+
20
+ 做法:先判定 snapshot 还是 restore。snapshot 时盘点活花名册,让每个 Bot 自述 PROFILE / MEMORY / routines / 对话,再写共享层、脱敏、MANIFEST。restore 时先只读预览,等人连接插件并确认「按这份建」,再创建空白 Bot 并逐字写入 PROFILE,不使用 Duplicate 作为主路径。
21
+
22
+ 交付:快照目录绝对路径,或恢复对照表 + DROP LIST。没有 MANIFEST 和 GAPS 不算完成。
23
+
24
+ 分工:你协调导出和重建。不抢业务 Bot 的专业工作。不创建花名册以外的 Bot。
25
+
26
+ 授权:不发送外部邮件、不发帖、不付款、不改生产、不发起 OAuth、不向用户索要 token、不启用 routine。Share 链接写入前必须脱敏。
27
+
28
+ 停止:完成 / 待用户确认花名册或插件 / 待授权启用 routine / 找不到快照 / 达工作量上限 / 用户叫停。
@@ -0,0 +1,3 @@
1
+ # CHANGELOG
2
+
3
+ - YYYY-MM-DD HH:MM — snapshot created by 管家
@@ -0,0 +1,27 @@
1
+ # CHARTER
2
+
3
+ ## 目标
4
+
5
+ - 主结果:
6
+ - 非目标:
7
+
8
+ ## 编制原则
9
+
10
+ - 最小有用花名册
11
+ - 全体 Bot 共享一台云电脑,Bot 不是安全边界
12
+ - 管家只做档案与冷启动,不抢业务执行
13
+
14
+ ## 语言与时区
15
+
16
+ - 语言:
17
+ - 时区:
18
+
19
+ ## 审批边界
20
+
21
+ 必须人工点头:外部发送、付款、发帖、合并、生产变更、创建花名册以外的 Bot、启用 routine、公开 Share。
22
+
23
+ 可自行完成:只读调研、起草、在 `/workspace` 写快照文件。
24
+
25
+ ## 停止条件
26
+
27
+ 完成 / 待输入 / 待授权 / 受阻 / 达上限 / 用户叫停。
@@ -0,0 +1,10 @@
1
+ # DROP LIST
2
+
3
+ 本快照明确带不走:
4
+
5
+ 1. 插件 OAuth 登录态
6
+ 2. 浏览器 cookie 与已登录网站
7
+ 3. 官方聊天时间线本体(只有 conversations/*.md)
8
+ 4. GAPS.md 里标记缺失的记忆或对话
9
+ 5. 未写入 shared/workspace-map.md 的云电脑自装软件
10
+ 6. 附件中超过导出上限且未拆分的文件
@@ -0,0 +1,6 @@
1
+ # GAPS(全队)
2
+
3
+ - conversations:
4
+ - memory:
5
+ - skills-text:
6
+ - workspace-copy:
@@ -0,0 +1,14 @@
1
+ # INIT(本快照自带)
2
+
3
+ 本文件属于 dated 快照,不是技能包。把本目录放到 `/workspace/` 后,对管家说:
4
+
5
+ ```
6
+ 读取本目录上一层或 /workspace/grok-bot-team-steward/ 里的 grok-bot-team-steward 技能。
7
+ restore 模式读取本目录。
8
+ 先只读预览 ROSTER / GAPS / DROP-LIST / connectors。
9
+ 我确认「按这份建」后再创建空白 Bot。
10
+ PROFILE 逐字粘贴。routine 一律暂停。
11
+ 不要 Duplicate。不要宣称官方聊天已恢复。
12
+ ```
13
+
14
+ 若技能包不在,把本目录 `../` 找不到 SKILL.md 时:仍按 ROSTER 与每个 `bots/<slug>/PROFILE.md` 创建,MEMORY.md 发给对应 Bot 读入。
@@ -0,0 +1,30 @@
1
+ # MANIFEST
2
+
3
+ - snapshot_id: grok-bot-team-YYYY-MM-DD
4
+ - created_at:
5
+ - completed_at:
6
+ - steward_name: 管家
7
+ - timezone:
8
+ - bots_count: 0
9
+ - rooms_count: 0
10
+ - skills_count: 0
11
+ - routines_count: 0
12
+ - conversations_files: 0
13
+
14
+ ## files
15
+
16
+ | path | role | source | complete |
17
+ |---|---|---|---|
18
+ | CHARTER.md | charter | steward | missing |
19
+ | ROSTER.md | roster | steward | missing |
20
+
21
+ source:`bot-self` | `steward` | `user`
22
+ complete:`yes` | `partial` | `missing`
23
+
24
+ ## gaps_summary
25
+
26
+ -
27
+
28
+ ## restore_hint
29
+
30
+ 对新账号上的管家说:读取 grok-bot-team-steward 技能,restore 本目录,先预览再创建。
@@ -0,0 +1,20 @@
1
+ schema: grok-bot-team-snapshot/v1
2
+ snapshot_id: grok-bot-team-YYYY-MM-DD
3
+ exported_at: ""
4
+ completed_at: ""
5
+ timezone: ""
6
+ exporter: 管家
7
+ source_skill: grok-bot-team-steward
8
+ status: in_progress
9
+ bots: []
10
+ rooms: []
11
+ skills: []
12
+ routines: []
13
+ connectors: []
14
+ conversations_coverage: {}
15
+ cannot_restore:
16
+ - OAuth and browser sessions
17
+ - cloud computer packages not listed in shared/workspace-map.md
18
+ - official chat history the platform refused to export
19
+ - attachments over the ~25MB cap that were not split
20
+ gaps: []
@@ -0,0 +1,15 @@
1
+ # ORG
2
+
3
+ ```
4
+ 用户
5
+ └─ 管家(档案 / 冷启动)
6
+ ├─ <Lead A>
7
+ │ └─ <Specialist>
8
+ └─ <Lead B>
9
+ ```
10
+
11
+ ## 交接
12
+
13
+ | 从 | 到 | 交什么 | 格式 |
14
+ |---|---|---|---|
15
+ | | | | 结果 / 来源版本 / 路径 / 已完成 / 缺口 / 授权 / 剩余工作量 |
@@ -0,0 +1,8 @@
1
+ # grok-bot-team-YYYY-MM-DD
2
+
3
+ 这是一份 Grok Bot 团队快照,不是技能包。
4
+
5
+ - 在原账号由管家按技能 `grok-bot-team-steward` 导出
6
+ - 换机时把本目录放到 `/workspace/grok-bot-team-YYYY-MM-DD/`,新建管家,激活同一技能,模式选 restore
7
+
8
+ 先读 `MANIFEST.md`、`ROSTER.md`、`GAPS.md`、`DROP-LIST.md`、`connectors.md`。
@@ -0,0 +1,13 @@
1
+ # RESTORE(本快照自带验收)
2
+
3
+ - [ ] 插件已按 connectors.md 重连
4
+ - [ ] Bot 数量与 ROSTER 一致
5
+ - [ ] 每个 PROFILE name/title/description 逐字一致
6
+ - [ ] 技能已保存并按 skills.md 启用
7
+ - [ ] 群聊成员与 rooms/ 一致
8
+ - [ ] 每个 Bot 复述了 MEMORY 中三条事实
9
+ - [ ] conversations 已作为参考喂入,未声称官方历史恢复
10
+ - [ ] routines 均为暂停
11
+ - [ ] DROP-LIST 已向用户宣读
12
+
13
+ 未勾完不许说初始化完成。
@@ -0,0 +1,11 @@
1
+ # ROSTER
2
+
3
+ | slug | name | title | rooms | skills | routines | conversations |
4
+ |---|---|---|---|---|---|---|
5
+ | example | Example | 一件具体工作 | hq | 0 | 0 | partial |
6
+
7
+ ## 创建规则
8
+
9
+ - 恢复时 name 与 PROFILE.md 逐字一致
10
+ - 禁止第二个同名 Bot
11
+ - 创建后第一条对外动作必须是草稿
@@ -0,0 +1,7 @@
1
+ # GAPS
2
+
3
+ - profile:
4
+ - memory:
5
+ - routines:
6
+ - skills:
7
+ - conversations:
@@ -0,0 +1,9 @@
1
+ # MEMORY
2
+
3
+ 现行事实(日期 + 来源):
4
+
5
+ - YYYY-MM-DD — — 来源:
6
+
7
+ 待核销:
8
+
9
+ - YYYY-MM-DD — — 原因:
@@ -0,0 +1,27 @@
1
+ # PROFILE
2
+
3
+ | 字段 | 值 |
4
+ |---|---|
5
+ | slug | example |
6
+ | name | Example |
7
+ | title | 一件具体工作 |
8
+ | autonomy | L1 草稿 |
9
+ | avatar | |
10
+
11
+ ## Description
12
+
13
+ 你是 **Example**,一名 Grok Bot。
14
+
15
+ 主责:
16
+
17
+ 接收条件:
18
+
19
+ 做法:
20
+
21
+ 交付:
22
+
23
+ 分工:
24
+
25
+ 授权:不发送、不付款、不改生产。外部动作必须人工批准。
26
+
27
+ 停止:完成 / 待输入 / 待授权 / 受阻 / 达上限 / 用户叫停。
@@ -0,0 +1,9 @@
1
+ # agent-spec
2
+
3
+ - slug:
4
+ - name:
5
+ - visible_id: Unknown
6
+ - enabled_skills: []
7
+ - routine_ids: []
8
+ - rooms: []
9
+ - home_dir:
@@ -0,0 +1,5 @@
1
+ # conversations
2
+
3
+ | file | range | messages | truncated | source |
4
+ |---|---|---|---|---|
5
+ | main.md | | 0 | yes | unknown |
@@ -0,0 +1,9 @@
1
+ ---
2
+ bot: example
3
+ source: unknown
4
+ range:
5
+ messages: 0
6
+ truncated: true
7
+ ---
8
+
9
+ (尚未导出。导不出时保留本文件并在 GAPS.md 说明原因,不要编造消息。)
@@ -0,0 +1,5 @@
1
+ # routines
2
+
3
+ | id | 名称 | 日程或触发 | 技能 | 状态 | 审批 | 缺源策略 | 最近一次运行 |
4
+ |---|---|---|---|---|---|---|---|
5
+ | | | | | paused | L1 | 跳过并记录 | Unknown |
@@ -0,0 +1,5 @@
1
+ # enabled skills
2
+
3
+ | id | 用途 |
4
+ |---|---|
5
+ | | |
@@ -0,0 +1,7 @@
1
+ # connectors
2
+
3
+ | 连接器 | 用途 | 需要它的 Bot | 换机重连 |
4
+ |---|---|---|---|
5
+ | GitHub | 私有仓存放快照 | 管家 | Settings → Plugins → GitHub |
6
+
7
+ 禁止写 token / cookie / refresh token。
@@ -0,0 +1,6 @@
1
+ # COMPLETED
2
+
3
+ - snapshot_id: grok-bot-team-YYYY-MM-DD
4
+ - completed_at:
5
+ - bots_written: 0
6
+ - open_gaps: 0
@@ -0,0 +1,6 @@
1
+ # CREATED
2
+
3
+ - snapshot_id: grok-bot-team-YYYY-MM-DD
4
+ - started_at:
5
+ - steward:
6
+ - operator:
@@ -0,0 +1,13 @@
1
+ # RESTORE NOTES
2
+
3
+ 仅恢复时填写。
4
+
5
+ - source_snapshot:
6
+ - restored_at:
7
+ - operator_confirm: 未确认 / 按这份建
8
+ - plugins_connected:
9
+ - bots_created:
10
+ - bots_failed:
11
+ - routines_paused:
12
+ - memory_readbacks:
13
+ - deviations: 用户当轮改了什么
@@ -0,0 +1,7 @@
1
+ # sanitizer
2
+
3
+ - scanned_at:
4
+ - files_scanned: 0
5
+ - redactions: 0
6
+ - skipped_files:
7
+ -
@@ -0,0 +1,8 @@
1
+ # SOURCE
2
+
3
+ - account_hint: Unknown(不要写邮箱原文)
4
+ - app: Grok Bot
5
+ - steward_skill: grok-bot-team-steward
6
+ - started_at:
7
+ - finished_at:
8
+ - notes:
@@ -0,0 +1,8 @@
1
+ # room
2
+
3
+ - slug:
4
+ - name:
5
+ - members:
6
+ - purpose:
7
+ - handoff: 结果 / 来源版本 / 成品路径 / 已完成 / 缺口 / 授权 / 剩余工作量
8
+ - never:
@@ -0,0 +1,12 @@
1
+ # routine
2
+
3
+ - id:
4
+ - name:
5
+ - owner_slug:
6
+ - cadence:
7
+ - skill:
8
+ - expected_result:
9
+ - approval: L1 草稿
10
+ - missing_source: 跳过并记录
11
+ - test_first: true
12
+ - status_on_restore: paused
@@ -0,0 +1,5 @@
1
+ # shared memory
2
+
3
+ 全队共享、不专属于某个 Bot 的现行事实。
4
+
5
+ - YYYY-MM-DD —
@@ -0,0 +1,5 @@
1
+ # workspace map
2
+
3
+ | path | 复制进快照 | 体积 | 备注 |
4
+ |---|---|---|---|
5
+ | /workspace/example | no | Unknown | |
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: example-skill
3
+ description: 在用户要求做某类可重复任务时使用。
4
+ ---
5
+
6
+ # example-skill
7
+
8
+ ## 1. 何时使用
9
+
10
+ ## 2. 所需输入与权限
11
+
12
+ ## 3. 工作步骤
13
+
14
+ ## 4. 如何验收
15
+
16
+ ## 5. 返回什么
17
+
18
+ ## 6. 何事必须批准