starworkInit 属于 StarWork 技能体系,定位为“创建 / 接入 / 初始化 StarWork 工作台或项目中心”的引导型 skill。资料明确指出:starworkInit 不是 starwork init 命令本身;Skill 负责判断、解释、采访、预览、确认和整合入口规则,CLI 负责实际生成 dry-run、写入工作台文件和 doctor 检查。
【用途与入口边界】 starworkInit 只处理已经指向“创建、接入、初始化项目工作台或项目中心”的请求。如果用户只是询问产品总览、起步路径、安装入口或该用哪个 StarWork 能力,应回到 starwork 主入口。资料强调:除非用户还在讨论阶段,否则不要停在蓝图或建议;当用户明确说“创建、初始化、生成、改造成工作台”时,必须继续运行 CLI:先 starwork init --dry-run,得到用户确认后再 starwork init --yes,最后运行或建议运行 starwork doctor --target <path> 验证。执行 --yes 前,必须先让用户确认最终绝对路径;AI 可以建议文件夹名,但必须说明可修改,不能把建议文件夹名当成用户已同意的路径。
【主要能力】
- 意图判断:通过 references/intent-routing.md 判断用户意图。
- 初始化引导:覆盖首次初始化、MultiAgent 回流、标准 project / hub 初始化、定制目录或规则、已有非空项目、宿主适配等场景。
- 安全分层执行:检查阶段只读;dry-run 是预览,不写入文件;--yes 只有在用户确认绝对路径、写入范围和风险后才能执行;完成后运行或建议运行 starwork doctor --target <path>。
- 已有项目保守处理:已有非空项目必须走 --agent-docs draft,不直接覆盖 AGENTS.md、README.md、CLAUDE.md 或宿主入口;读取 .starwork/drafts/agent-docs-plan.json 和 proposed 草稿后,再根据项目上下文整合。
- 分层状态汇报:区分“已完成检查”“已完成写入预览”“工作台骨架已写入”“AI 入口待整合或已生效”“doctor 检查通过或还有待处理项”“MultiAgent 可以继续设计 AI 岗位,或需要先补齐入口 / 边界”。
【reference 加载规则】 命中具体场景前,先读取对应 reference。不同场景对应不同必读文件,例如:判断用户意图读 references/intent-routing.md;首次初始化或 MultiAgent 回流读 references/friendly-onboarding.md 与 references/initialization-flow.md;标准 project / hub 初始化读 references/initialization-flow.md 与 references/output-and-safety-rules.md;定制目录或规则读 references/custom-blueprint.md 与 references/output-and-safety-rules.md;已有非空项目读 references/existing-project-agent-docs.md 与 references/output-and-safety-rules.md;宿主适配读 references/host-adapter-flow.md 与 references/existing-project-agent-docs.md;询问知识库 / Pack 读 references/knowledge-and-pack-boundaries.md。reference 文件不存在或无法读取时,高风险动作必须停止,并提示用户“Skill 安装不完整,请重新用完整目录安装 StarWork Skills”,同时说明缺失文件路径。高风险动作包括:执行 --yes、合并入口规则、修改宿主规则、生成可执行 blueprint、写入定制规则。完整安装指 Skill 主文件、references/ 和 agents/ 随目录一起安装。references/README.md 说明完整目录安装和 reference 缺失停止规则。
【使用方式】 用户首次要求初始化、创建、接入或改造成 StarWork 工作台时,第一屏必须先讲产品,不要先问配置或直接给命令。资料给出了推荐开场内容:先用用户语言说明 StarWork 是给 AI 协作准备的项目工作台,会把项目说明、当前任务、协作规则、交接记录和健康检查入口放到固定位置,让 AI 每次进入项目时不用从零猜上下文;然后说明这次会带用户做三件事(确认工作台服务哪个项目、预览准备补哪些协作文件、确认后正式写入并做检查),并承诺先预览、不改业务代码、不覆盖已有 AI 规则文件。讲完产品后再进入第一个问题,每次只问一个问题,不要一次性问完类型、语言、路径、结构、知识库和宿主。
如果用户是从 starworkMultiagent 回流过来,或只说“想开启多 AI 协作 / 多 Agent 分工,但这个项目还没接入”,资料给出了 MultiAgent-only 回流第一屏口径:以用户语言说明这是先把用户带回安全接入这一步,需先确认三件事(项目是什么、当前在推进什么、不同 AI 哪些内容能整理、哪些不能随便改),并说明会先做一份写入预览,只告诉准备补哪些协作入口和边界,确认前不会改业务内容、不会覆盖已有 AI 规则文件;然后只问一个问题:把当前已有项目接入 StarWork,还是新建一个空项目工作台试用。
MultiAgent 快速起步规则:用户目标是“先开启多 AI 协作”时,默认只问最小必要信息——目标目录、新建还是已有项目、工作台语言、主要使用的 AI 工具(不确定可跳过)。如已有项目,读取现有入口并生成待整合草稿。不要默认展开知识库、Pack、Capability、复杂目录定制或多个宿主同时适配;用户主动要求定制时再进入完整初始化采访。每一步提问前先说明目的。
【dry-run 复述要求】 dry-run 复述必须包含:这是预览,还没有写入文件;准备新增的项;准备更新的项;不会改动的内容(业务代码、已有非空 AI 规则文件);需要用户确认的内容(目标路径是否正确、是否接受这些 StarWork 协作入口、是否继续合并待整合草稿)。
【已有项目与 pending merge】 已有项目 dry-run 前必须先说明会按更保守的方式处理:保留业务代码和现有资料;不直接覆盖已有 AGENTS.md、README.md、CLAUDE.md 或其他 AI 规则入口;先生成待整合草稿;让用户确认后再合并入口说明。如果出现 pending merge / pending_merge / 待整合状态,不要说多 AI 协作已经完全可用,要分层说明:工作台骨架已经写入,但 AI 入口还没有最终生效;因为项目已有规则文件,只生成了待整合草稿,没有直接覆盖;下一步会把现有规则和 StarWork 建议放在一起,让用户确认后再合并。
【适用场景】 适用的场景包括:用户明确要求创建、初始化、生成或改造成 StarWork 工作台;已有项目接入 StarWork;新建空项目工作台试用;从 starworkMultiagent 回流并需要先接入;定制目录或规则;宿主适配;用户询问知识库 / Pack 边界等。
【限制与安全边界】 不覆盖用户已有业务文件;不把初始化报告、dry-run 结果、doctor 结果、npm 安装过程写进 AGENTS.md 或 .starwork/rules/*.md;不把 adapter profile、host_native_dirs、workspace schema 这类内部词讲给小白用户;不让 blueprint 决定真实 target 路径,目标路径必须来自命令参数或用户明确确认;不把知识库和 Pack 放进默认采访链路,用户主动要求时再读取对应 reference。资料未提供该 skill 的收费、价格、平台、具体效果等事实,暂未提供。