Starwork

starwork

使用这个 skill 作为 StarWork 的统一入口。它负责产品解释、安装引导、模糊意图判断和能力路由，不复制专家 Skill 的完整流程。

第一屏

当用户说“StarWork 是什么”“怎么开始”“帮我用 StarWork”“把这个项目接入 StarWork”但还没有明确专家场景时，先这样回答：

StarWork 是给 AI 协作准备的项目工作台。

它会把项目说明、当前任务、协作规则、交接记录和健康检查入口放到固定位置，让 AI 每次进入项目时不用从零猜上下文。

我会先判断你现在是哪种情况，再带你走对应流程。整个过程会先预览，不会直接改业务代码，也不会直接覆盖已有 AI 规则文件。

然后只问一个问题：

你现在是想：
1. 安装 StarWork；
2. 创建或接入一个项目工作台；
3. 诊断一个旧目录；
4. 开启知识库；
5. 创建多个 Agent 分工；
6. 管理项目中心？

如果用户已经表达清楚意图，不要重复问，直接路由。

路由

完整路由规则见：

references/routing.md

常用判断：

• 安装 StarWork、让 AI 会用 StarWork：按 references/install.md 引导安装 CLI 和 Skills。
• 创建、接入、初始化项目工作台或项目中心：进入 starworkInit。
• 诊断旧目录、解释 doctor 结果、设计升级方案：进入 starworkDoctor。
• 开启、检查、维护项目知识库：进入 starworkKnowledge。
• 多 Agent 分工、lane、跨会话消息、Codex 会话控制：进入 starworkMultiagent。
• 从项目中心创建项目：如果当前工作台有项目中心 Kit，使用 starworkSpawn；否则先引导用户回到项目中心或创建项目中心。
• 巡检项目中心：如果当前工作台有项目中心 Kit，使用 starworkAudit。
• 阶段收尾、整理、归档：如果当前工作台有 neat-freak，优先使用它。

安装

安装最小流程见：

references/install.md

安装阶段只做 CLI + 全局系统 Skills 安装和验证，不初始化工作台，不创建测试目录。

全局系统 Skills 是：

• starwork
• starworkInit
• starworkDoctor
• starworkKnowledge
• starworkMultiagent

Kit 自带 Skill 和 Capability 项目内 Skill 只在对应工作台或能力开启后出现。

边界

• 不维护另一套初始化、知识库、诊断或多 Agent 详细流程。
• 不假设宿主支持自动 Skill-to-Skill 调用；用文本级路由契约说明下一步。
• 不在用户确认前执行写入命令。
• 不把 Kit 自带 Skill 当成全局系统 Skill。
• 不把普通资料整理误判成知识库能力；长期稳定知识才进入 starworkKnowledge。

StarWork 安装引导

本文件供 starwork 主 Skill 在“安装 StarWork / 让 AI 会用 StarWork”场景引用。

安装目标

安装阶段只完成三件事：

1. 确认 Node.js 和 npm 可用。 2. 安装或更新 StarWork CLI。 3. 安装或更新 StarWork 主入口和 L1 专家 Skills。

不要在安装阶段初始化工作台、创建测试目录或改动用户项目文件。

命令

检查环境：

node --version
npm --version

安装 CLI：

npm install -g @jennie-shawn/starwork@latest
starwork --version
starwork --help

安装 Skills：

npx skills add https://github.com/jennie-shawn/StarWork/tree/main/skills --full-depth -g -a codex -y

验证：

npx skills ls -g -a codex --json

应能看到这些全局系统 Skills：

• starwork
• starworkInit
• starworkDoctor
• starworkKnowledge
• starworkMultiagent

项目中心 Kit、项目工作台 Kit 和 Capability 会在对应工作台或能力开启后写入自己的 Skill，不属于这里的全局清单。

汇报话术

StarWork 已经装好了。

我已经确认两件事：
1. StarWork 命令可以正常运行。
2. 当前 AI 工具已经安装好 StarWork 主入口和专家 Skills。

现在你可以直接对我说“帮我用 StarWork”，我会从主入口判断下一步。

StarWork 主入口路由

本文件是 starwork 主 Skill 的路由参考。主 Skill 只判断方向，不复制专家 Skill 的完整流程。

层级

路由矩阵

模糊意图处理

如果用户只说“帮我用 StarWork”“这个项目怎么接入”“我该用哪个能力”，先给第一屏产品解释，再问一个选择题。

如果用户已经明确说出能力，不要拦在主入口：

• “开启知识库”直接进入 starworkKnowledge。
• “创建多个 Agent / 让开发 Agent 开始做”直接进入 starworkMultiagent。
• “诊断这个旧目录”直接进入 starworkDoctor。
• “初始化当前项目”直接进入 starworkInit。

冲突处理

• 用户请求普通资料整理或阶段收尾时，不要默认进入知识库；优先判断是否是 neat-freak 场景。
• 用户在普通项目里说“从项目中心创建项目”时，先说明这需要项目中心工作台；不要在普通项目里伪造项目中心能力。
• 用户在非 StarWork 目录里请求多 Agent、知识库或项目中心能力时，先回到 starworkInit 接入工作台。
• 当前宿主不支持自动切换 Skill 时，主入口可以按专家 Skill 的公开规则继续执行高层确认，但复杂细节仍以专家 Skill 为事实源。