@jennie-shawn/starwork 0.1.0-alpha.2 → 0.1.0-alpha.21
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.
- package/README.md +111 -99
- package/adapters/README.md +34 -0
- package/adapters/claude-code/profile.json +55 -0
- package/adapters/claude-code/rules.md +13 -0
- package/adapters/claude-code/safety.md +6 -0
- package/adapters/codex/profile.json +55 -0
- package/adapters/codex/rules.md +12 -0
- package/adapters/codex/safety.md +5 -0
- package/adapters/contract.md +64 -0
- package/adapters/cursor/profile.json +60 -0
- package/adapters/cursor/rules.md +7 -0
- package/adapters/cursor/safety.md +6 -0
- package/adapters/trae/profile.json +61 -0
- package/adapters/trae/rules.md +7 -0
- package/adapters/trae/safety.md +7 -0
- package/cli/README.md +50 -9
- package/cli/audit-spec.md +403 -0
- package/cli/doctor-spec.md +109 -17
- package/cli/init-spec.md +81 -53
- package/cli/repair-spec.md +361 -0
- package/cli/spawn-blueprint-spec.md +18 -18
- package/cli/spawn-spec.md +103 -108
- package/cli/src/cli.js +9403 -1059
- package/cli/test/init.test.js +2566 -51
- package/cli/upgrade-spec.md +488 -0
- package/core/README.md +14 -3
- package/core/agent-lanes-session-naming-spec.md +364 -0
- package/core/agent-lanes-spec.md +507 -0
- package/core/baseline/file-boundaries.md +11 -3
- package/core/baseline/health-check.md +2 -2
- package/core/baseline/roles.md +0 -1
- package/core/baseline/spec.md +3 -2
- package/core/capabilities/README.md +5 -2
- package/core/capabilities/agent-lanes/capability.md +40 -0
- package/core/capabilities/decisions/capability.md +2 -2
- package/core/capabilities/knowledge/capability.md +72 -0
- package/core/capabilities/knowledge/skills/starworkKnowledgeProject/SKILL.md +57 -0
- package/core/capabilities/knowledge/skills/starworkKnowledgeProject/agents/openai.yaml +6 -0
- package/core/capabilities/knowledge/templates/en/README.md +20 -0
- package/core/capabilities/knowledge/templates/en/index.md +19 -0
- package/core/capabilities/knowledge/templates/en/log.md +16 -0
- package/core/capabilities/knowledge/templates/en/schema.md +60 -0
- package/core/capabilities/knowledge/templates/zh/README.md +20 -0
- package/core/capabilities/knowledge/templates/zh/index.md +19 -0
- package/core/capabilities/knowledge/templates/zh/log.md +16 -0
- package/core/capabilities/knowledge/templates/zh/schema.md +60 -0
- package/core/capabilities/main-repo-sync/capability.md +57 -34
- package/core/capabilities/skill-mount/capability.md +19 -5
- package/core/capabilities/starter-outputs/capability.md +9 -11
- package/core/capabilities/starter-outputs/templates/outputs/final/README.md +1 -1
- package/core/core-v0.1-protocol.md +23 -21
- package/core/kits/README.md +9 -1
- package/core/kits/hub/.incoming/README.md +4 -2
- package/core/kits/hub/.incoming/reports/.gitkeep +1 -0
- package/core/kits/hub/.incoming/skills/.gitkeep +1 -0
- package/core/kits/hub/.internal/twin-bot-merge-policy.md +5 -0
- package/core/kits/hub/.internal/twin-bot-writeback-protocol.md +5 -0
- package/core/kits/hub/.starwork/handoff/archived/.gitkeep +1 -0
- package/core/kits/hub/.starwork/handoff/inbox/.gitkeep +1 -0
- package/core/kits/hub/.starwork/handoff/outbox/.gitkeep +1 -0
- package/core/kits/hub/.starwork/handoff/sent/.gitkeep +1 -0
- package/core/kits/hub/.starwork/handoff/state.json +5 -0
- package/core/kits/hub/AGENTS.md +18 -12
- package/core/kits/hub/README.md +17 -9
- package/core/kits/hub/identity/README.md +2 -2
- package/core/kits/hub/knowledge/README.md +5 -0
- package/core/kits/hub/lessons/README.md +2 -2
- package/core/kits/hub/projects/README.md +5 -0
- package/core/kits/hub/projects/coordination/README.md +5 -0
- package/core/kits/hub/projects/coordination/messages/acknowledged/.gitkeep +1 -0
- package/core/kits/hub/projects/coordination/messages/closed/.gitkeep +1 -0
- package/core/kits/hub/projects/coordination/messages/delivered/.gitkeep +1 -0
- package/core/kits/hub/projects/coordination/messages/queued/.gitkeep +1 -0
- package/core/kits/hub/projects/coordination/reports/.gitkeep +1 -0
- package/core/kits/hub/skills/README.md +4 -2
- package/core/kits/hub/skills/registry.json +6 -0
- package/core/kits/hub/workspace/README.md +5 -0
- package/core/kits/kit-structure-reference.md +104 -191
- package/core/kits/project/.agents/skills/README.md +5 -0
- package/core/kits/project/.claude/skills/README.md +5 -0
- package/core/kits/project/.obsidian/README.md +5 -0
- package/core/kits/project/.starwork/handoff/archived/.gitkeep +1 -0
- package/core/kits/project/.starwork/handoff/inbox/.gitkeep +1 -0
- package/core/kits/project/.starwork/handoff/outbox/.gitkeep +1 -0
- package/core/kits/project/.starwork/handoff/sent/.gitkeep +1 -0
- package/core/kits/project/.starwork/handoff/state.json +5 -0
- package/core/kits/project/AGENTS.md +38 -0
- package/core/kits/project/README.md +44 -0
- package/core/kits/project/_/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 +25 -0
- package/core/kits/project/_/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
- package/core/kits/project/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +17 -0
- package/core/kits/project/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +24 -0
- package/core/kits/two-kit-architecture-spec.md +695 -0
- package/core/legacy/README.md +16 -0
- package/core/legacy/kits/satellite-starter/.starwork/handoff/archived/.gitkeep +1 -0
- package/core/legacy/kits/satellite-starter/.starwork/handoff/inbox/.gitkeep +1 -0
- package/core/legacy/kits/satellite-starter/.starwork/handoff/outbox/.gitkeep +1 -0
- package/core/legacy/kits/satellite-starter/.starwork/handoff/sent/.gitkeep +1 -0
- package/core/legacy/kits/satellite-starter/.starwork/handoff/state.json +5 -0
- package/core/{kits → legacy/kits}/satellite-starter/AGENTS.md +7 -1
- package/core/{kits → legacy/kits}/satellite-starter/README.md +4 -4
- package/core/{kits → legacy/kits}/satellite-starter/_/347/263/273/347/273/237//344/270/273/345/272/223/345/220/214/346/255/245/README.md +3 -3
- package/core/legacy/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
- package/core/{presets → legacy/presets}/satellite-starter.yaml +1 -1
- package/core/presets/README.md +17 -7
- package/core/presets/hub.yaml +23 -4
- package/core/presets/project.yaml +11 -0
- package/core/profiles/en/labels.json +2 -4
- package/core/profiles/en/paths.json +3 -4
- package/core/profiles/en/profile.md +7 -4
- package/core/profiles/en/templates/AGENTS.md +13 -9
- package/core/profiles/en/{reference-kits/local-starter/_system/context/project-status.md → templates/_system/context/current-project.md} +1 -1
- package/core/profiles/zh/labels.json +2 -4
- package/core/profiles/zh/paths.json +3 -5
- package/core/profiles/zh/profile.md +7 -4
- package/core/profiles/zh/templates/AGENTS.md +13 -9
- 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 → profiles/zh/templates/_/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} +1 -1
- package/core/project-rules-optimization-spec.md +510 -0
- package/core/skill-management-spec.md +591 -0
- package/core/starwork-runtime-layer-spec.md +344 -0
- package/docs/README.md +18 -4
- package/docs/agent-install-guide.md +132 -0
- package/docs/ai-consultant-brief.md +648 -0
- package/docs/alpha-test-guide.md +274 -17
- package/docs/cli-capabilities.html +206 -115
- package/docs/cli-skill-registry.html +801 -0
- package/docs/doctor-capabilities.html +631 -0
- package/docs/hub-management.html +60 -59
- package/docs/index.html +7 -5
- package/docs/issue-feedback-tracking-guide.md +447 -0
- package/docs/m2.10-core-kit-pack-boundary-cleanup-spec.md +567 -0
- package/docs/m2.6-alpha-core-flows-optimization-spec.md +441 -0
- package/docs/m2.6-project-init-feedback/README.md +27 -0
- package/docs/m2.6-project-init-feedback/m2.6-project-init-feedback-01-identity-spec.md +194 -0
- package/docs/m2.6-project-init-feedback/m2.6-project-init-feedback-02-hub-sync-boundary-spec.md +198 -0
- package/docs/m2.6-project-init-feedback/m2.6-project-init-feedback-03-current-project-purity-spec.md +238 -0
- package/docs/m2.6-project-init-feedback/m2.6-project-init-feedback-04-system-placeholder-templates-spec.md +213 -0
- package/docs/m2.6-project-init-feedback/m2.6-project-init-feedback-05-agents-guardrails-spec.md +265 -0
- package/docs/m2.7-init-github-issues-optimization-spec.md +350 -0
- package/docs/m2.8-workspace-naming-optimization-spec.md +633 -0
- package/docs/multiagent/01-codex-session-capabilities-and-starwork-implications.md +280 -0
- package/docs/multiagent/02-cursor-session-management-research-instructions.md +204 -0
- package/docs/multiagent/03-trae-session-management-research-instructions.md +205 -0
- package/docs/multiagent/04-claude-code-session-management-research-instructions.md +209 -0
- package/docs/multiagent/05-trae-solo-session-management-research-instructions.md +222 -0
- package/docs/multiagent/claude-code-session-management-research-result.md +201 -0
- package/docs/multiagent/cursor-session-management-research-result.md +101 -0
- package/docs/multiagent/session-control-support-matrix.md +20 -0
- package/docs/multiagent/trae-session-management-research-result.md +353 -0
- package/docs/multiagent/trae-solo-session-management-research-result.md +467 -0
- package/docs/product-direction.md +17 -9
- package/docs/product-shape-business-model.html +1 -1
- package/docs/roadmap.html +34 -20
- package/docs/roadmap.md +185 -20
- package/docs/v0.1-plan.md +32 -12
- package/kit-skills/README.md +11 -0
- package/kit-skills/neat-freak/SKILL.md +32 -0
- package/kit-skills/neat-freak/agents/openai.yaml +2 -0
- package/kit-skills/starworkAudit/SKILL.md +127 -0
- package/kit-skills/starworkAudit/references/issue-taxonomy.md +10 -0
- package/kit-skills/starworkAudit/references/repair-blueprint-guide.md +54 -0
- package/kit-skills/starworkAudit/references/response-guide.md +34 -0
- package/{skills → kit-skills}/starworkSpawn/SKILL.md +36 -14
- package/package.json +4 -3
- package/packs/content-creator/languages/en.json +4 -4
- package/packs/content-creator/languages/zh.json +4 -4
- package/packs/content-creator/pack.json +5 -5
- package/packs/general/languages/en.json +19 -2
- package/packs/general/languages/zh.json +19 -2
- package/packs/general/pack.json +8 -3
- package/packs/hub-management/languages/en.json +2 -2
- package/packs/hub-management/languages/zh.json +11 -10
- package/packs/hub-management/pack.json +2 -2
- package/packs/hub-management/rules/en/overview.md +2 -0
- package/packs/hub-management/rules/en/workflow.md +2 -1
- package/packs/hub-management/rules/zh/overview.md +4 -2
- package/packs/hub-management/rules/zh/workflow.md +3 -2
- package/packs/hub-management/seed/en/projects/coordination/README.md +2 -2
- package/packs/hub-management/seed/zh/projects/coordination/README.md +5 -0
- package/packs/pack-structure-spec.md +4 -4
- package/skills/README.md +28 -3
- package/skills/starwork/SKILL.md +81 -0
- package/skills/starwork/references/install.md +64 -0
- package/skills/starwork/references/routing.md +44 -0
- package/skills/starworkAudit-spec.md +354 -0
- package/skills/starworkDoctor/SKILL.md +435 -0
- package/skills/starworkDoctor/agents/openai.yaml +7 -0
- package/skills/starworkDoctor/references/agent-rules-template.md +64 -0
- package/skills/starworkDoctor/references/hub-upgrade.md +73 -0
- package/skills/starworkDoctor/references/response-guide.md +57 -0
- package/skills/starworkDoctor/references/rules-extraction-guide.md +92 -0
- package/skills/starworkDoctor-spec.md +764 -0
- package/skills/starworkInit/SKILL.md +285 -50
- package/skills/starworkInit-spec.md +106 -75
- package/skills/starworkKnowledge/SKILL.md +195 -0
- package/skills/starworkKnowledge/agents/openai.yaml +3 -0
- package/skills/starworkMultiagent/SKILL.md +302 -0
- package/skills/starworkMultiagent/agents/openai.yaml +7 -0
- package/skills/starworkMultiagent-skill-plan.md +234 -0
- package/skills/starworkMultiagent-spec.md +181 -0
- package/core/capabilities/matter-mode/capability.md +0 -46
- package/core/capabilities/matter-mode/templates/matters/_matter-template/README.md +0 -17
- package/core/capabilities/matter-mode/templates/matters/_matter-template/handoff.md +0 -3
- package/core/capabilities/matter-mode/templates/matters/_matter-template/notes.md +0 -5
- package/core/capabilities/matter-mode/templates/matters/_matter-template/progress.md +0 -5
- package/core/capabilities/matter-mode/templates/matters/registry.md +0 -16
- 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 -24
- package/core/kits/hub//347/237/245/350/257/206/README.md +0 -5
- package/core/kits/hub//351/241/271/347/233/256/README.md +0 -5
- package/core/kits/hub//351/241/271/347/233/256//350/201/224/347/273/234/README.md +0 -5
- package/core/kits/local-matter/AGENTS.md +0 -23
- package/core/kits/local-matter/README.md +0 -22
- 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 -7
- 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 -17
- package/core/kits/local-matter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +0 -5
- package/core/kits/local-matter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +0 -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 -17
- 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 -3
- 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 -5
- 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 -5
- package/core/kits/local-matter//344/272/213/351/241/271//346/263/250/345/206/214/350/241/250.md +0 -16
- 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 -5
- package/core/kits/local-starter/AGENTS.md +0 -23
- package/core/kits/local-starter/README.md +0 -23
- 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 -25
- 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 -17
- package/core/kits/local-starter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +0 -5
- package/core/kits/local-starter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +0 -5
- package/core/kits/local-starter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +0 -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 -5
- package/core/kits/local-starter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +0 -5
- package/core/kits/satellite-matter/AGENTS.md +0 -27
- package/core/kits/satellite-matter/README.md +0 -40
- 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 +0 -7
- 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 +0 -42
- 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 +0 -17
- package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/README.md +0 -9
- package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/inbox/README.md +0 -5
- package/core/kits/satellite-matter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/outbox/README.md +0 -5
- 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 +0 -17
- 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 +0 -3
- 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 +0 -5
- 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 +0 -5
- package/core/kits/satellite-matter//344/272/213/351/241/271//346/263/250/345/206/214/350/241/250.md +0 -16
- package/core/kits/satellite-matter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +0 -5
- 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 +0 -5
- package/core/kits/satellite-matter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +0 -5
- package/core/kits/satellite-starter/.agents/skills/README.md +0 -5
- package/core/kits/satellite-starter/.claude/skills/README.md +0 -5
- package/core/kits/satellite-starter/.core-sync.json +0 -31
- package/core/kits/satellite-starter/.internal/README.md +0 -5
- package/core/kits/satellite-starter/.obsidian/README.md +0 -5
- 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 +0 -29
- 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 +0 -17
- package/core/kits/satellite-starter/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md +0 -8
- package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/README.md +0 -9
- package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/inbox/README.md +0 -5
- package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/267/250/351/241/271/347/233/256/outbox/README.md +0 -5
- package/core/kits/satellite-starter/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md +0 -5
- package/core/kits/satellite-starter//345/217/202/350/200/203/350/265/204/346/226/231/README.md +0 -5
- package/core/kits/satellite-starter//347/237/245/350/257/206/README.md +0 -5
- 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 +0 -5
- package/core/kits/satellite-starter//350/276/223/345/207/272//350/215/211/347/250/277/README.md +0 -5
- package/core/presets/local-matter.yaml +0 -14
- package/core/presets/local-starter.yaml +0 -12
- package/core/presets/satellite-matter.yaml +0 -17
- package/core/profiles/en/reference-kits/local-starter/AGENTS.md +0 -23
- package/core/profiles/en/reference-kits/local-starter/README.md +0 -23
- package/core/profiles/en/reference-kits/local-starter/_system/identity/README.md +0 -5
- package/core/profiles/en/reference-kits/local-starter/_system/lessons/README.md +0 -5
- package/core/profiles/en/reference-kits/local-starter/_system/tasks/current-work.md +0 -17
- package/core/profiles/en/reference-kits/local-starter/outputs/drafts/README.md +0 -5
- package/core/profiles/en/reference-kits/local-starter/outputs/final/README.md +0 -5
- package/core/profiles/en/reference-kits/local-starter/references/README.md +0 -5
- package/core/profiles/en/reference-presets/local-starter.yaml +0 -12
- package/core/profiles/en/templates/_system/context/project-status.md +0 -25
- 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 +0 -25
- package/packs/hub-management/seed/zh//351/241/271/347/233/256//350/201/224/347/273/234/README.md +0 -5
- /package/core/{capabilities/matter-mode/templates/matters/_matter-template/drafts → kits/hub/.incoming/identity}/.gitkeep +0 -0
- /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" → hub/.incoming/knowledge/.gitkeep} +0 -0
- /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" → hub/.incoming/lessons/.gitkeep} +0 -0
- /package/core/kits/hub/{/351/241/271/347/233/256/registry.json" → projects/registry.json} +0 -0
- /package/core/kits/{satellite-matter → project}/CLAUDE.md +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/.agents/skills/README.md +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/.claude/skills/README.md +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/.core-sync.json +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/.internal/README.md +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/.obsidian/README.md +0 -0
- /package/core/{kits → legacy/kits}/satellite-starter/CLAUDE.md +0 -0
- /package/core/{kits/satellite-matter → legacy/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" +0 -0
- /package/core/{kits/hub → legacy/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" +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/_/347/263/273/347/273/237//346/225/231/350/256/255/README.md" +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}/_/347/263/273/347/273/237//350/272/253/344/273/275/README.md" +0 -0
- /package/core/{kits/local-matter → legacy/kits/satellite-starter}//345/217/202/350/200/203/350/265/204/346/226/231/README.md" +0 -0
- /package/core/{kits/satellite-matter → legacy/kits/satellite-starter}//347/237/245/350/257/206/README.md" +0 -0
- /package/core/{kits/local-matter → legacy/kits/satellite-starter}//350/276/223/345/207/272//350/215/211/347/250/277/README.md" +0 -0
- /package/{skills → kit-skills}/starworkSpawn/agents/openai.yaml +0 -0
- /package/packs/hub-management/seed/zh/{/351/241/271/347/233/256/registry.json" → projects/registry.json} +0 -0
|
@@ -0,0 +1,507 @@
|
|
|
1
|
+
# StarWork Agent Lanes 协作机制 SPEC
|
|
2
|
+
|
|
3
|
+
## 状态
|
|
4
|
+
|
|
5
|
+
- 版本:v0.1 draft
|
|
6
|
+
- 所属模块:StarWork Core / CLI / Adapters
|
|
7
|
+
- 相关能力:`agent-lanes`
|
|
8
|
+
- 相关 CLI:`starwork multiagent`
|
|
9
|
+
- 目标:定义同一项目内多个 Agent 会话如何按稳定职责位分工协作,并保持输出可发现、边界可审计、上下文可接力。
|
|
10
|
+
|
|
11
|
+
## 一句话定义
|
|
12
|
+
|
|
13
|
+
Agent Lanes 是 StarWork 的多 Agent 分工协作机制。
|
|
14
|
+
|
|
15
|
+
它不追踪“多个事项”,而是追踪“多个职责位”:
|
|
16
|
+
|
|
17
|
+
```text
|
|
18
|
+
<lane-id> lane 负责一个稳定工作面
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
每个 lane 可以绑定一个当前 Agent 会话。Agent 进入项目后,应先确认自己属于哪个 lane,再按该 lane 的写入边界工作。
|
|
22
|
+
|
|
23
|
+
StarWork 不内置固定 lane 清单。开发、写作、课程、研究、运营、法务、设计或客户交付项目都可以按自己的实际职责定义 lane。
|
|
24
|
+
|
|
25
|
+
## 背景
|
|
26
|
+
|
|
27
|
+
事项能力 解决的是“一个事项如何长期推进、记录和归档”。
|
|
28
|
+
|
|
29
|
+
多 Agent 协作常常不是按事项拆分,而是按工作面拆分:
|
|
30
|
+
|
|
31
|
+
- 开发项目中可能是接口、界面、验证。
|
|
32
|
+
- 内容项目中可能是选题、撰稿、审校、发布。
|
|
33
|
+
- 研究项目中可能是资料收集、分析、报告、复核。
|
|
34
|
+
- 客户交付项目中可能是需求、方案、执行、验收。
|
|
35
|
+
|
|
36
|
+
如果把每个 Agent 都建成一个 事项,会把机制做重,也会混淆“事情”和“职责”。因此 Agent Lanes 独立于 事项能力:它是协作层,不是事项层。
|
|
37
|
+
|
|
38
|
+
## 设计原则
|
|
39
|
+
|
|
40
|
+
1. 少到不能再少:只保留让多会话分工真正跑起来的能力。
|
|
41
|
+
2. 人和 Agent 都能读:v0.1 先使用 Markdown 作为事实源,不强制 JSON manifest。
|
|
42
|
+
3. 职责位稳定,会话可替换:lane 是长期职责,session 是当前接手它的会话。
|
|
43
|
+
4. 写入边界优先:先避免互相踩文件,再谈复杂协同。
|
|
44
|
+
5. 输出只登记,不搬运:其他 lane 需要读取的产物进入共享索引,产物本身仍留在合理位置。
|
|
45
|
+
6. 不引入任务系统:Agent Lanes 不做排期、看板、锁、自动调度或冲突仲裁。
|
|
46
|
+
7. 不预设职责分类:lane ID、数量和职责由项目场景定义,不由 Core 写死。
|
|
47
|
+
|
|
48
|
+
## 核心概念
|
|
49
|
+
|
|
50
|
+
| 概念 | 定义 |
|
|
51
|
+
|---|---|
|
|
52
|
+
| Lane | 一个稳定职责位,例如某个项目里的 `research`、`writing`、`review`。示例不是内置分类。 |
|
|
53
|
+
| Session | 当前接手某个 lane 的具体 Agent 会话,例如 Codex thread。 |
|
|
54
|
+
| Worklog | 某个 lane 的持续工作记录。它不是离职交接,而是当前上下文、输出、请求和下一步。 |
|
|
55
|
+
| Lane Workspace | 某个 lane 自己的过程工作区,用于放草稿、调研笔记、中间分析和临时产物。 |
|
|
56
|
+
| Shared Context | 跨 lane 共享索引,记录其他 Agent 需要读取的输出、请求和已确认约定。 |
|
|
57
|
+
| Write Scope | 某个 lane 可以主动修改的文件范围。 |
|
|
58
|
+
|
|
59
|
+
## 必要能力
|
|
60
|
+
|
|
61
|
+
### 1. Lane Registry
|
|
62
|
+
|
|
63
|
+
项目必须有一个稳定位置登记所有 lane。
|
|
64
|
+
|
|
65
|
+
默认中文路径:
|
|
66
|
+
|
|
67
|
+
```text
|
|
68
|
+
_系统/协作/agent-lanes.md
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
最小字段:
|
|
72
|
+
|
|
73
|
+
| 字段 | 含义 |
|
|
74
|
+
|---|---|
|
|
75
|
+
| `lane` | lane ID,建议使用英文短名,例如 `research`。 |
|
|
76
|
+
| `purpose` | 该 lane 的职责。 |
|
|
77
|
+
| `current_session` | 当前 CLI v0.1 兼容字段;目标结构中迁移到 `.starwork/agent-lanes/state.json`。 |
|
|
78
|
+
| `write_scope` | 该 lane 可主动修改的路径范围。 |
|
|
79
|
+
| `worklog` | 该 lane 的工作记录位置。 |
|
|
80
|
+
| `workspace` | 该 lane 的过程工作区位置。 |
|
|
81
|
+
|
|
82
|
+
目标分层:
|
|
83
|
+
|
|
84
|
+
```text
|
|
85
|
+
_系统/协作/agent-lanes.md # lane 稳定定义和写入范围
|
|
86
|
+
_系统/协作/shared.md # 跨 lane 可见索引
|
|
87
|
+
_系统/协作/lanes/<lane-id>/worklog.md # 项目协作记录
|
|
88
|
+
_系统/协作/lanes/<lane-id>/workspace/ # 项目过程材料
|
|
89
|
+
.starwork/agent-lanes/state.json # session binding 等机制状态
|
|
90
|
+
.starwork/agent-lanes/cache/ # 解析缓存
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Lane 的 worklog 和 workspace 属于项目协作内容,不进入 `.starwork/`。`.starwork/agent-lanes/` 只记录 StarWork 机制运行需要的绑定状态和缓存。
|
|
94
|
+
|
|
95
|
+
示例:
|
|
96
|
+
|
|
97
|
+
以下示例使用 `research`、`writing`、`review`,只为了说明格式;真实项目应替换成自己的 lane。
|
|
98
|
+
|
|
99
|
+
```md
|
|
100
|
+
# Agent Lanes
|
|
101
|
+
|
|
102
|
+
## Lanes
|
|
103
|
+
|
|
104
|
+
| lane | purpose | current_session | write_scope | worklog | workspace |
|
|
105
|
+
|---|---|---|---|---|---|
|
|
106
|
+
| research | 资料收集和事实核查 | codex:019e... | knowledge/**, notes/** | lanes/research/worklog.md | lanes/research/workspace |
|
|
107
|
+
| writing | 草稿撰写和结构整理 | unbound | drafts/**, product/docs/** | lanes/writing/worklog.md | lanes/writing/workspace |
|
|
108
|
+
| review | 审校、验证和风险检查 | unbound | reviews/**, product/docs/** | lanes/review/worklog.md | lanes/review/workspace |
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
### 2. Session Binding
|
|
112
|
+
|
|
113
|
+
会话绑定只回答一个问题:
|
|
114
|
+
|
|
115
|
+
```text
|
|
116
|
+
当前会话属于哪个 lane?
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
最小规则:
|
|
120
|
+
|
|
121
|
+
- 一个会话同一时间只绑定一个 lane。
|
|
122
|
+
- 一个 lane 同一时间最多一个主 session。
|
|
123
|
+
- Codex 优先使用 `CODEX_THREAD_ID` 作为 session ID。
|
|
124
|
+
- 读取不到真实 session ID 时,可使用手写 ID,例如 `codex:manual-research-1`。
|
|
125
|
+
- 未绑定 lane 的 Agent 不应默认接管整个项目。
|
|
126
|
+
|
|
127
|
+
### 2.1 Host Session Display Name
|
|
128
|
+
|
|
129
|
+
宿主会话显示名称是 Agent Lanes 的体验增强,不是事实源。
|
|
130
|
+
|
|
131
|
+
定义:
|
|
132
|
+
|
|
133
|
+
- 宿主工具中展示给用户看的会话标题,例如 Codex Desktop 的 thread name。
|
|
134
|
+
- 可在 `multiagent bind` 成功后 best-effort 同步。
|
|
135
|
+
- 不作为 lane binding 的事实源。
|
|
136
|
+
- 不参与冲突判断、write scope 判断或状态恢复。
|
|
137
|
+
|
|
138
|
+
当前 v0.1 支持:
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
starwork multiagent bind research \
|
|
142
|
+
--session codex:manual-research-1 \
|
|
143
|
+
--session-name "StarWork 资料预研 Agent"
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
实现边界:
|
|
147
|
+
|
|
148
|
+
- 改名失败不回滚 lane binding。
|
|
149
|
+
- 当前仅 Codex adapter 支持通过 app-server 协议同步。
|
|
150
|
+
- 不得直接改写宿主工具私有状态文件,例如 `~/.codex/state_5.sqlite` 或 `~/.codex/session_index.jsonl`。
|
|
151
|
+
|
|
152
|
+
### 3. Write Scope
|
|
153
|
+
|
|
154
|
+
每个 lane 必须声明写入范围。
|
|
155
|
+
|
|
156
|
+
规则:
|
|
157
|
+
|
|
158
|
+
- lane 内文件:可以主动修改。
|
|
159
|
+
- lane 外文件:修改前应先在 Shared Context 记录请求或说明理由。
|
|
160
|
+
- 共同入口文件,例如 `AGENTS.md`、Core 协议、公共 schema,默认视为 shared scope,需要明确对齐后再改。
|
|
161
|
+
|
|
162
|
+
Write Scope 是 Agent Lanes 的核心安全边界。没有写入边界,就只是给会话贴标签。
|
|
163
|
+
|
|
164
|
+
### 4. Worklog
|
|
165
|
+
|
|
166
|
+
每个 lane 必须有一个 worklog。
|
|
167
|
+
|
|
168
|
+
默认路径:
|
|
169
|
+
|
|
170
|
+
```text
|
|
171
|
+
_系统/协作/lanes/<lane-id>/worklog.md
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
最小模板:
|
|
175
|
+
|
|
176
|
+
```md
|
|
177
|
+
# Backend Worklog
|
|
178
|
+
|
|
179
|
+
## Current
|
|
180
|
+
|
|
181
|
+
当前正在处理什么。
|
|
182
|
+
|
|
183
|
+
## Outputs
|
|
184
|
+
|
|
185
|
+
| title | path | audience | status |
|
|
186
|
+
|---|---|---|---|
|
|
187
|
+
|
|
188
|
+
## Requests
|
|
189
|
+
|
|
190
|
+
| to | request | status | link |
|
|
191
|
+
|---|---|---|---|
|
|
192
|
+
|
|
193
|
+
## Notes
|
|
194
|
+
|
|
195
|
+
过程记录、临时判断、上下文说明。
|
|
196
|
+
|
|
197
|
+
## Next
|
|
198
|
+
|
|
199
|
+
下一步建议。
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
`worklog.md` 不是日报,也不是完整过程档案。它只保留让同一 lane 下一个会话能接住工作的必要信息。
|
|
203
|
+
|
|
204
|
+
### 5. Lane Workspace
|
|
205
|
+
|
|
206
|
+
每个 lane 默认有一个过程工作区。
|
|
207
|
+
|
|
208
|
+
默认路径:
|
|
209
|
+
|
|
210
|
+
```text
|
|
211
|
+
_系统/协作/lanes/<lane-id>/workspace/
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
最小文件:
|
|
215
|
+
|
|
216
|
+
```text
|
|
217
|
+
_系统/协作/lanes/<lane-id>/workspace/README.md
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
Lane Workspace 用来放该职责位自己产生的过程材料:
|
|
221
|
+
|
|
222
|
+
- 调研笔记。
|
|
223
|
+
- 未确认草稿。
|
|
224
|
+
- 中间分析。
|
|
225
|
+
- 临时实验结果。
|
|
226
|
+
- 给同一 lane 后续会话看的上下文材料。
|
|
227
|
+
|
|
228
|
+
Lane Workspace 不是项目正式输出目录。它更像该职责位的工作桌。
|
|
229
|
+
|
|
230
|
+
### 6. Shared Context
|
|
231
|
+
|
|
232
|
+
如果某个 lane 的输出需要其他 lane 读取,必须登记到共享索引。
|
|
233
|
+
|
|
234
|
+
默认路径:
|
|
235
|
+
|
|
236
|
+
```text
|
|
237
|
+
_系统/协作/shared.md
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
最小模板:
|
|
241
|
+
|
|
242
|
+
```md
|
|
243
|
+
# Shared Agent Context
|
|
244
|
+
|
|
245
|
+
## Shared Outputs
|
|
246
|
+
|
|
247
|
+
| from | title | path | audience | status | updated |
|
|
248
|
+
|---|---|---|---|---|---|
|
|
249
|
+
|
|
250
|
+
## Cross-Lane Requests
|
|
251
|
+
|
|
252
|
+
| from | to | request | status | link |
|
|
253
|
+
|---|---|---|---|---|
|
|
254
|
+
|
|
255
|
+
## Shared Agreements
|
|
256
|
+
|
|
257
|
+
| agreement | owner | status | link |
|
|
258
|
+
|---|---|---|---|
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
共享索引只放“别人需要知道的东西”,不复制完整内容。
|
|
262
|
+
|
|
263
|
+
示例:
|
|
264
|
+
|
|
265
|
+
```md
|
|
266
|
+
| research | Source summary | product/docs/source-summary.md | writing,review | draft | 2026-05-21 |
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
## 推荐目录结构
|
|
270
|
+
|
|
271
|
+
默认中文路径:
|
|
272
|
+
|
|
273
|
+
```text
|
|
274
|
+
_系统/协作/
|
|
275
|
+
├── agent-lanes.md
|
|
276
|
+
├── shared.md
|
|
277
|
+
└── lanes/
|
|
278
|
+
├── research/
|
|
279
|
+
│ ├── worklog.md
|
|
280
|
+
│ └── workspace/
|
|
281
|
+
│ └── README.md
|
|
282
|
+
├── writing/
|
|
283
|
+
│ ├── worklog.md
|
|
284
|
+
│ └── workspace/
|
|
285
|
+
│ └── README.md
|
|
286
|
+
└── review/
|
|
287
|
+
├── worklog.md
|
|
288
|
+
└── workspace/
|
|
289
|
+
└── README.md
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
v0.1 不默认创建 `notes/`、`drafts/`、`artifacts/` 子目录。
|
|
293
|
+
|
|
294
|
+
如果某个 lane 确实需要更细的过程材料分类,可以在自己的 workspace 内按需新增:
|
|
295
|
+
|
|
296
|
+
```text
|
|
297
|
+
_系统/协作/lanes/<lane-id>/workspace/notes/
|
|
298
|
+
_系统/协作/lanes/<lane-id>/workspace/drafts/
|
|
299
|
+
_系统/协作/lanes/<lane-id>/workspace/artifacts/
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
但这不是默认结构。
|
|
303
|
+
|
|
304
|
+
## 产物放置规则
|
|
305
|
+
|
|
306
|
+
| 内容类型 | 放置位置 |
|
|
307
|
+
|---|---|
|
|
308
|
+
| lane 当前上下文 | 对应 lane 的 `worklog.md` |
|
|
309
|
+
| lane 过程材料、草稿、中间分析 | 对应 lane 的 `workspace/` |
|
|
310
|
+
| 其他 lane 需要读取的索引 | `_系统/协作/shared.md` |
|
|
311
|
+
| 已确认的正式产物 | 晋升到项目正式事实源,例如 `product/` |
|
|
312
|
+
|
|
313
|
+
关键规则:
|
|
314
|
+
|
|
315
|
+
> 需要其他 Agent 读取的输出,必须在 Shared Context 登记;成熟产物仍以项目正式事实源为准。
|
|
316
|
+
|
|
317
|
+
推荐流转:
|
|
318
|
+
|
|
319
|
+
```text
|
|
320
|
+
lane workspace 产生过程材料
|
|
321
|
+
-> 如需其他 lane 读取,登记 shared.md
|
|
322
|
+
-> 如被确认有项目价值,晋升到正式输出目录
|
|
323
|
+
-> 晋升后以正式输出目录为准
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
## Agent 运行规则
|
|
327
|
+
|
|
328
|
+
当项目存在 `_系统/协作/agent-lanes.md` 时,Agent 进入项目后应:
|
|
329
|
+
|
|
330
|
+
1. 读取 `AGENTS.md`。
|
|
331
|
+
2. 读取项目状态和当前工作。
|
|
332
|
+
3. 读取 `_系统/协作/agent-lanes.md`。
|
|
333
|
+
4. 判断当前会话是否已经绑定 lane。
|
|
334
|
+
5. 若已绑定,只主动修改该 lane 的 `write_scope`。
|
|
335
|
+
6. 若未绑定,先请用户指定 lane,或在用户明确授权后创建 lane。
|
|
336
|
+
7. 需要其他 lane 配合时,写入 `_系统/协作/shared.md` 的 `Cross-Lane Requests`。
|
|
337
|
+
8. 产出需要其他 lane 读取的内容时,写入 `Shared Outputs`。
|
|
338
|
+
9. 结束当前工作前更新本 lane 的 `worklog.md`。
|
|
339
|
+
|
|
340
|
+
## CLI 设计
|
|
341
|
+
|
|
342
|
+
CLI 只做确定性文件操作,不替 Agent 判断项目该如何分工。
|
|
343
|
+
|
|
344
|
+
推荐命令名:
|
|
345
|
+
|
|
346
|
+
```bash
|
|
347
|
+
starwork multiagent
|
|
348
|
+
```
|
|
349
|
+
|
|
350
|
+
不用 `starwork agents`,避免和 Codex、Claude、Cursor 这类 Agent runtime 混淆。
|
|
351
|
+
|
|
352
|
+
### `starwork multiagent init`
|
|
353
|
+
|
|
354
|
+
创建最小协作结构。
|
|
355
|
+
|
|
356
|
+
```bash
|
|
357
|
+
starwork multiagent init
|
|
358
|
+
starwork multiagent init --lanes research,writing,review
|
|
359
|
+
starwork multiagent init --target ./my-project
|
|
360
|
+
```
|
|
361
|
+
|
|
362
|
+
行为:
|
|
363
|
+
|
|
364
|
+
- 创建 `_系统/协作/agent-lanes.md`。
|
|
365
|
+
- 创建 `_系统/协作/shared.md`。
|
|
366
|
+
- 为用户指定的 lane 创建 `worklog.md` 和 `workspace/README.md`。
|
|
367
|
+
- 不覆盖已有文件。
|
|
368
|
+
|
|
369
|
+
### `starwork multiagent add`
|
|
370
|
+
|
|
371
|
+
新增 lane。
|
|
372
|
+
|
|
373
|
+
以下命令只是示例。CLI 不内置 `research`,也不要求项目使用这一组 lane。
|
|
374
|
+
|
|
375
|
+
```bash
|
|
376
|
+
starwork multiagent add research \
|
|
377
|
+
--purpose "资料收集和事实核查" \
|
|
378
|
+
--write "knowledge/**,notes/**"
|
|
379
|
+
```
|
|
380
|
+
|
|
381
|
+
行为:
|
|
382
|
+
|
|
383
|
+
- 在 `agent-lanes.md` 的 `Lanes` 表增加一行。
|
|
384
|
+
- 创建 `_系统/协作/lanes/<lane-id>/worklog.md`。
|
|
385
|
+
- 创建 `_系统/协作/lanes/<lane-id>/workspace/README.md`。
|
|
386
|
+
- 当前 CLI v0.1 中 `current_session` 默认为 `unbound`;后续目标结构中由 `.starwork/agent-lanes/state.json` 记录绑定状态。
|
|
387
|
+
|
|
388
|
+
### `starwork multiagent bind`
|
|
389
|
+
|
|
390
|
+
将当前会话绑定到 lane。
|
|
391
|
+
|
|
392
|
+
```bash
|
|
393
|
+
starwork multiagent bind research
|
|
394
|
+
starwork multiagent bind research --agent codex
|
|
395
|
+
starwork multiagent bind research --session codex:manual-research-1
|
|
396
|
+
starwork multiagent bind research --session codex:manual-research-1 --session-name "Research Agent"
|
|
397
|
+
```
|
|
398
|
+
|
|
399
|
+
行为:
|
|
400
|
+
|
|
401
|
+
- Codex 环境优先读取 `CODEX_THREAD_ID`。
|
|
402
|
+
- 当前 CLI v0.1 更新 `agent-lanes.md` 中对应 lane 的 `current_session`。
|
|
403
|
+
- 如果传入 `--session-name`,绑定成功后 best-effort 同步宿主工具会话名;失败只提示 warning。
|
|
404
|
+
- 后续目标结构改为更新 `.starwork/agent-lanes/state.json`,可见 registry 不再承担机器绑定状态。
|
|
405
|
+
- 如果 lane 已绑定其他 session,必须提示冲突;非交互模式默认拒绝覆盖。
|
|
406
|
+
|
|
407
|
+
### `starwork multiagent release`
|
|
408
|
+
|
|
409
|
+
释放 lane 的当前会话绑定。
|
|
410
|
+
|
|
411
|
+
```bash
|
|
412
|
+
starwork multiagent release research
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
行为:
|
|
416
|
+
|
|
417
|
+
- 当前 CLI v0.1 将 `current_session` 改回 `unbound`。
|
|
418
|
+
- 后续目标结构改为清理 `.starwork/agent-lanes/state.json` 中的绑定。
|
|
419
|
+
- 提醒用户或 Agent 更新该 lane 的 `worklog.md`。
|
|
420
|
+
- 不删除任何记录。
|
|
421
|
+
|
|
422
|
+
### `starwork multiagent status`
|
|
423
|
+
|
|
424
|
+
查看当前分工。
|
|
425
|
+
|
|
426
|
+
```bash
|
|
427
|
+
starwork multiagent status
|
|
428
|
+
```
|
|
429
|
+
|
|
430
|
+
输出应包括:
|
|
431
|
+
|
|
432
|
+
- lane 列表。
|
|
433
|
+
- 当前 session 绑定状态。
|
|
434
|
+
- write scope 摘要。
|
|
435
|
+
- 最近需要关注的 shared requests。
|
|
436
|
+
|
|
437
|
+
### `starwork multiagent share`
|
|
438
|
+
|
|
439
|
+
登记一个跨 lane 可读输出。
|
|
440
|
+
|
|
441
|
+
```bash
|
|
442
|
+
starwork multiagent share research \
|
|
443
|
+
--title "Source summary" \
|
|
444
|
+
--path "product/docs/source-summary.md" \
|
|
445
|
+
--audience "writing,review" \
|
|
446
|
+
--status draft
|
|
447
|
+
```
|
|
448
|
+
|
|
449
|
+
行为:
|
|
450
|
+
|
|
451
|
+
- 在 `_系统/协作/shared.md` 的 `Shared Outputs` 中追加一行。
|
|
452
|
+
- 不移动、不复制目标文件。
|
|
453
|
+
|
|
454
|
+
### v0.1 CLI 不做什么
|
|
455
|
+
|
|
456
|
+
- 不自动决定 lane 划分。
|
|
457
|
+
- 不自动分配任务。
|
|
458
|
+
- 不做文件锁。
|
|
459
|
+
- 不做权限系统。
|
|
460
|
+
- 不做并发编辑仲裁。
|
|
461
|
+
- 不分析 git diff 来判断责任归属。
|
|
462
|
+
- 不把项目协作内容迁入 `.starwork/`。
|
|
463
|
+
- 不把 lane 写入 `matters/registry.md`。
|
|
464
|
+
|
|
465
|
+
## 与其他机制的关系
|
|
466
|
+
|
|
467
|
+
### 与 事项能力
|
|
468
|
+
|
|
469
|
+
Agent Lanes 不属于 事项能力。
|
|
470
|
+
|
|
471
|
+
- 事项机制 追踪事情。
|
|
472
|
+
- Lane 追踪职责。
|
|
473
|
+
|
|
474
|
+
二者可以同时存在,但互不替代。一个 lane 可以参与多个 事项,一个 事项 也可以需要多个 lane 协作。
|
|
475
|
+
|
|
476
|
+
### 与 Adapt
|
|
477
|
+
|
|
478
|
+
`starwork adapt` 负责让某个 Agent runtime 知道 StarWork 入口规则。
|
|
479
|
+
|
|
480
|
+
Agent Lanes 负责让进入项目后的会话知道自己在项目中的职责位。
|
|
481
|
+
|
|
482
|
+
### 与 Skills
|
|
483
|
+
|
|
484
|
+
未来可以新增 `starworkLanes` skill,帮助 Agent 判断是否需要 lane、如何采访用户、如何生成 lane 初始分工。
|
|
485
|
+
|
|
486
|
+
v0.1 不要求先有 skill;CLI 和 Markdown 结构已可手动运行。
|
|
487
|
+
|
|
488
|
+
## 验收标准
|
|
489
|
+
|
|
490
|
+
一套 Agent Lanes 机制成立,至少需要满足:
|
|
491
|
+
|
|
492
|
+
- 用户能在一个文件里看到当前所有 lane、会话绑定和写入范围。
|
|
493
|
+
- 一个新 Agent 会话能判断自己是否已绑定 lane。
|
|
494
|
+
- 多个由项目自定义的 lane 能在同一项目中并行工作而不默认互相修改文件。
|
|
495
|
+
- 一个 lane 的输出能通过 Shared Context 被其他 lane 发现。
|
|
496
|
+
- 任一 lane 结束工作前能通过 worklog 留下足够上下文。
|
|
497
|
+
- 不启用 事项能力 的单事务项目也能使用 Agent Lanes。
|
|
498
|
+
|
|
499
|
+
## 后续问题
|
|
500
|
+
|
|
501
|
+
这些问题暂不进入 v0.1:
|
|
502
|
+
|
|
503
|
+
- 是否需要 lane 级别的默认验证命令。
|
|
504
|
+
- 是否需要从 git diff 自动生成 worklog 摘要。
|
|
505
|
+
- 是否需要跨 lane 依赖图。
|
|
506
|
+
- 是否需要 Hub 统一管理多个项目的 lane 模板。
|
|
507
|
+
- 是否需要为不同场景提供可选 lane 模板,例如开发、写作、研究、客户交付;模板只能作为建议,不能成为 Core 内置固定职责。
|
|
@@ -14,12 +14,20 @@
|
|
|
14
14
|
|---|---|
|
|
15
15
|
| `decisions` | 只记录会影响后续工作的高影响、已确认决策。 |
|
|
16
16
|
| `starter-outputs` | `references/` 是只读原始资料;`outputs/drafts/` 是未确认 AI 草稿;`outputs/final/` 是用户确认成果。 |
|
|
17
|
-
| `matter-mode` | 事项目录是过程工作区;成熟内容必须晋升到项目正式事实源。 |
|
|
18
17
|
| `local-identity` | 项目本地身份参考,只能在用户确认后修改。 |
|
|
19
18
|
| `local-lessons` | 项目本地可复用教训,不是普通复盘流水。 |
|
|
20
|
-
| `main-repo-sync` | Hub
|
|
21
|
-
| `skill-mount` | 共享 skills
|
|
19
|
+
| `main-repo-sync` | Hub 资源通过快照、只读链接、`.starwork/sync.json`、legacy `.core-sync.json` 和审核队列进入卫星项目;Hub registry 不存项目进度正文。 |
|
|
20
|
+
| `skill-mount` | 共享 skills 从主库软链接挂载,不复制成独立分叉;项目实际挂载清单写入 `.starwork/skills.json`。 |
|
|
21
|
+
| `agent-lanes` | Lane 的职责、共享索引、worklog 和过程材料属于项目协作内容;session binding 等机器状态可以进入 `.starwork/agent-lanes/`。 |
|
|
22
22
|
|
|
23
23
|
## 正式事实源规则
|
|
24
24
|
|
|
25
25
|
每个工作区都必须声明正式事实源放在哪里。Core 不要求该目录一定叫 `product/`。
|
|
26
|
+
|
|
27
|
+
## `.starwork/` 边界
|
|
28
|
+
|
|
29
|
+
`.starwork/` 是 StarWork 机制运行层,只存放 StarWork 机制下才需要的状态、索引、manifest、队列、安装记录、缓存和报告。
|
|
30
|
+
|
|
31
|
+
当前项目的业务事实、事项过程、正式产物、草稿、知识、身份、教训和协作内容,不因为由 StarWork 创建、检查或被 Agent 读取,就进入 `.starwork/`。
|
|
32
|
+
|
|
33
|
+
详细规则见:[StarWork Runtime Layer SPEC](../starwork-runtime-layer-spec.md)。
|
|
@@ -7,7 +7,7 @@
|
|
|
7
7
|
- `system.tasks.current_work` 存在。
|
|
8
8
|
- 入口规则或项目状态中声明了正式事实源。
|
|
9
9
|
- 已启用的可选能力文件遵守自身边界。
|
|
10
|
-
- 使用 `main-repo-sync` 的卫星项目包含 `.core-sync.json`。
|
|
10
|
+
- 使用 `main-repo-sync` 的卫星项目包含 `.starwork/sync.json`,或 legacy `.core-sync.json`。
|
|
11
11
|
|
|
12
12
|
## 警告项
|
|
13
13
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
- 项目状态文件包含任务级流水,不论实际路径映射成 `_系统/上下文/项目状态.md`、`_系统/上下文/当前项目.md` 还是英文路径。
|
|
18
18
|
- 决策记录写入会议纪要或局部草稿选择。
|
|
19
19
|
- `references/` 被当成生成成果来改写。
|
|
20
|
-
-
|
|
20
|
+
- 事项机制 草稿被当成正式事实源。
|
|
21
21
|
- 卫星项目在未确认情况下修改主库快照或软链接 skill。
|
|
22
22
|
|
|
23
23
|
## 兼容性
|
package/core/baseline/roles.md
CHANGED
|
@@ -11,7 +11,6 @@
|
|
|
11
11
|
| `work.starter.references` | 否 | Starter Mode 中默认只读的原始资料。 |
|
|
12
12
|
| `work.starter.outputs_drafts` | 否 | 等待用户审阅的 AI 草稿。 |
|
|
13
13
|
| `work.starter.outputs_final` | 否 | 用户确认后的成果。 |
|
|
14
|
-
| `work.matters.registry` | 否 | Matter Mode 的事项索引。 |
|
|
15
14
|
| `identity.local` | 否 | 项目本地身份参考。 |
|
|
16
15
|
| `lessons.local` | 否 | 项目本地可复用教训。 |
|
|
17
16
|
| `main_repo.sync_metadata` | 否 | 卫星项目与主库同步的元数据。 |
|
package/core/baseline/spec.md
CHANGED
|
@@ -23,18 +23,19 @@ StarWork Core Baseline 是人和 AI Agent 共同使用一个工作区时的最
|
|
|
23
23
|
- 项目必须声明正式事实源在哪里。
|
|
24
24
|
- 过程材料不能被悄悄当成正式事实源。
|
|
25
25
|
- 只读参考层不能在没有用户明确确认的情况下被改写。
|
|
26
|
+
- `.starwork/` 只承载 StarWork 机制运行状态,不承载项目业务内容。
|
|
26
27
|
|
|
27
28
|
## 可选能力
|
|
28
29
|
|
|
29
30
|
Capabilities 可以增加文件和行为,但不能重新定义 baseline 的含义:
|
|
30
31
|
|
|
31
32
|
- `starter-outputs`
|
|
32
|
-
- `matter-mode`
|
|
33
33
|
- `decisions`
|
|
34
34
|
- `local-identity`
|
|
35
35
|
- `local-lessons`
|
|
36
36
|
- `main-repo-sync`
|
|
37
37
|
- `skill-mount`
|
|
38
|
+
- `agent-lanes`
|
|
38
39
|
|
|
39
40
|
## 不做什么
|
|
40
41
|
|
|
@@ -43,5 +44,5 @@ Core v0.1 不定义:
|
|
|
43
44
|
- Pack 专属工作流
|
|
44
45
|
- CLI 命令实现
|
|
45
46
|
- 特定 Agent Runtime 行为
|
|
46
|
-
-
|
|
47
|
+
- 除 `.starwork/` 机制运行状态外的强制性机器可读 manifest
|
|
47
48
|
- 所有用户都必须拥有事项目录
|
|
@@ -7,9 +7,12 @@ Capabilities 是 Core 的可选能力,可以通过 presets 组合。
|
|
|
7
7
|
## v0.1 包含
|
|
8
8
|
|
|
9
9
|
- `starter-outputs`:`references/` + `outputs/`
|
|
10
|
-
- `matter-mode`:事项工作区与事项维护要求
|
|
11
10
|
- `decisions`:高影响决策记录
|
|
12
11
|
- `local-identity`:项目本地身份
|
|
13
12
|
- `local-lessons`:项目本地教训
|
|
14
|
-
- `main-repo-sync
|
|
13
|
+
- `main-repo-sync`:项目中心与项目工作台的同步模型
|
|
15
14
|
- `skill-mount`:通过软链接挂载共享 skills
|
|
15
|
+
- `agent-lanes`:多 Agent 会话按职责位分工协作
|
|
16
|
+
- `knowledge`:项目本地知识库,可选开启,不属于 Project Kit 默认目录
|
|
17
|
+
|
|
18
|
+
`.starwork/` 机制运行层边界见:[StarWork Runtime Layer SPEC](../starwork-runtime-layer-spec.md)。Capabilities 可以使用 `.starwork/` 存放机制状态,但不能把项目业务内容、过程材料或正式成果迁入 `.starwork/`。
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
# Capability: agent-lanes v0.1
|
|
2
|
+
|
|
3
|
+
Agent Lanes 是用于同一项目内多 Agent 会话分工协作的可选能力。
|
|
4
|
+
|
|
5
|
+
它追踪职责位,不追踪事项。
|
|
6
|
+
|
|
7
|
+
## 新增
|
|
8
|
+
|
|
9
|
+
中文 profile 默认映射为:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
_系统/协作/agent-lanes.md
|
|
13
|
+
_系统/协作/shared.md
|
|
14
|
+
_系统/协作/lanes/<lane-id>/worklog.md
|
|
15
|
+
_系统/协作/lanes/<lane-id>/workspace/README.md
|
|
16
|
+
.starwork/agent-lanes/state.json
|
|
17
|
+
.starwork/agent-lanes/cache/
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## 规则
|
|
21
|
+
|
|
22
|
+
- Lane 是稳定职责位,具体 ID 和职责由项目场景定义。
|
|
23
|
+
- Session 是当前绑定到 lane 的具体 Agent 会话。
|
|
24
|
+
- 每个 lane 必须声明职责、当前会话、写入范围、worklog 和 workspace。
|
|
25
|
+
- Lane workspace 是过程区,用于放草稿、调研笔记、中间分析和临时产物;不是项目正式输出目录。
|
|
26
|
+
- 需要其他 lane 读取的输出必须登记到 shared context。
|
|
27
|
+
- 成熟产物应晋升到项目正式事实源;晋升后以正式事实源为准。
|
|
28
|
+
- Agent Lanes 不写入 事项索引,不参与 事项生命周期。
|
|
29
|
+
- Lane 的职责、共享索引、worklog 和 workspace 是项目协作内容,不进入 `.starwork/`。
|
|
30
|
+
- `.starwork/agent-lanes/` 只存放 session binding、解析缓存和机制状态。
|
|
31
|
+
|
|
32
|
+
当前 CLI v0.1 仍把 `current_session` 写在 `_系统/协作/agent-lanes.md`;后续可迁移为可见 registry + `.starwork/agent-lanes/state.json` 的拆分结构。
|
|
33
|
+
|
|
34
|
+
## SPEC
|
|
35
|
+
|
|
36
|
+
完整机制见:
|
|
37
|
+
|
|
38
|
+
```text
|
|
39
|
+
product/core/agent-lanes-spec.md
|
|
40
|
+
```
|