loom-init-project

项目初始化 Skill

• .loom/ 是唯一长期维护点，存放项目原则、结构化记忆和 workflow。
• AGENTS.md 是 Codex/OpenCode 等通用 agent 的标准入口。
• Claude、Cursor、Copilot 只接收薄 wrapper 或规则副本，避免多处规则漂移。
• 初始化尽量自动化；不确定的信息用 [TODO] 标记，交给用户确认。

触发条件

用户只需要说 /loom-init-project、初始化项目 或 扫描项目生成配置。

内部执行方式

触发本 skill 后，判断当前目录是不是项目根目录，如果不是根目录，询问用户是否在当前目录运行：

第一步：确认角色（多选）

如果用户没有明确指定角色，先询问这个项目给谁用（可多选，取并集）：

• pm：PM 视角，生成产品上下文 .loom/rules/product.md，走 需求 → spec → 原型 流水线
• dev：研发视角，生成工程上下文（宪章 / subagent-context），走完整工程流水线

角色决定生成哪些 .loom/ 文件；workflow.yaml 始终是含全部 pipeline 的单文件，不裁剪。未指定时默认 dev（与历史行为一致）。把选择通过 --roles 传给脚本，例如 --roles pm,dev。

第二步：确认 agent 工具

如果用户没有明确指定 agent 工具，再询问要为哪些工具生成入口文件。可选项为：

• claude-code：生成 AGENTS.md+ CLAUDE.md
• codex：生成 AGENTS.md
• opencode：生成 AGENTS.md 并合并 opencode.json watcher ignore
• cursor：生成 .cursor/rules/loom.mdc
• copilot：生成 .github/copilot-instructions.md

拿到用户选择后，把角色和工具通过 --roles / --tools 显式传给脚本，例如：

node <skill-dir>/scripts/init-project.mjs --cwd <project-root> --roles pm,dev --tools claude-code,codex

第三步：确认图后端（仅当选了 dev）

如果用户没有明确指定图后端，询问这个项目使用哪个代码图谱/知识库后端。可选项为：

• codegraph（默认推荐）：基于 tree-sitter AST 的本地代码图谱，通过 MCP 实时查询。需要用户按需手动创建 .codegraph/ 索引，初始化脚本不自动建图。
• sourcegraph：基于 Sourcegraph 的代码搜索和引用查询。需要 Sourcegraph 实例或 MCP server，索引由用户自行搭建。
• scip：基于 SCIP/LSIF 精确索引。需要已生成的 .lsif 或 .scip 文件，索引由用户自行生成。
• none：不启用任何图后端，所有代码查询走源码搜索和 git diff。

未指定时默认 codegraph（与历史行为一致）。把选择通过 --graph-backend 传给脚本：

node <skill-dir>/scripts/init-project.mjs --cwd <project-root> --roles dev --tools codex --graph-backend codegraph

如果用户在调用 skill 时已经明确指定了图后端（例如"用 sourcegraph 初始化项目"），则跳过此询问。非交互环境（CI、脚本调用）未指定时默认 codegraph，不阻塞流程。

第四步：填充产品上下文（仅当选了 pm）

脚本对 pm 角色只写出 .loom/rules/product.md 模板（保留 {{...}} 占位符）。脚本运行后，问用户以下 5 题，再用 Edit 把答案填进 product.md，替换对应占位符：

1. 产品名 + 一句话描述 → {{PRODUCT_NAME}} / {{PRODUCT_ONELINE}}
2. 目标用户是谁 → {{TARGET_USERS}}
3. 核心价值 → {{CORE_VALUE}}
4. 主要平台（移动端 / PC / 两者）→ {{PLATFORM}}
5. UI 风格（Material / Ant Design / 简洁 / 无要求）+ 原型受众（研发评审 / 用户测试 / 投资人 demo）→ {{UI_STYLE}} / {{PROTOTYPE_AUDIENCE}}