aisee:init

aisee:init

对外 skill 名称是 aisee:init；目录名保持 aisee-init/。执行脚本时从当前 skill 目录解析 <skill-dir>/scripts/...；安装后的 hook 命令只引用目标项目内 aisee/hooks/。

目标

把一个项目整理成 OpenSpec 驱动的 Aisee 项目配置。

本 skill 是项目接入 / 治理阶段能力，不是默认新功能迭代 happy path 的必经节点。对于已经接入并正常运行 OpenSpec 工作流的项目，只有在配置缺失、hooks 漂移、memory 缺口、目录迁移或治理审计时才应再次触发。

适用前提：

• 项目已经在使用 OpenSpec；或
• 用户明确要把当前项目接入 OpenSpec / Aisee。

如果用户明确表示当前项目不使用 OpenSpec，且也不打算接入 OpenSpec，本 skill 不适用；不要生成 OpenSpec 风格的项目 AGENTS.md、openspec/project.md、hooks 或 aisee/ 规划布局。

本 skill 负责：

• AGENTS.md：当前 Codex target 的项目规则、OpenSpec 工作流、工具调用约束、沙箱和验证要求。
• openspec/project.md：项目事实、技术栈、架构、开发命令；不放 AI 行为规则。
• aisee/docs/requirements/、aisee/docs/spec-migration/、aisee/docs/change-plan/：Aisee 当前主推链路相关目录。
• aisee/memory/rules.md 与 aisee/memory/index.md：项目本地记忆规则和记忆入口。
• aisee/docs/reflect/：会话复盘和 memory 候选区；不替代 aisee/memory/。
• 当前支持的 hook target 是 Codex：.codex/hooks.json 与 .codex/config.toml。
• aisee/hooks/：本技能安装到目标项目的 hook 脚本目录；runtime 从这里执行脚本，不依赖 skill 安装路径。

非目标：

• 不生成非 Codex hook target 配置。若用户需要其他 agent runtime，先输出差异和待设计项，不要套用 Codex hook 协议。
• 不安装或维护 OpenSpec custom schemas。

先决条件

执行任何初始化、审计或优化前，先确认项目已由 OpenSpec 初始化：

node -e "const fs=require('fs'); for (const [p,t] of [['openspec/specs','dir'],['openspec/changes','dir'],['openspec/changes/archive','dir']]) { try { const s=fs.statSync(p); console.log(p + ':' + ((t==='dir'?s.isDirectory():s.isFile())?'ok':'bad')); } catch { console.log(p + ':missing'); } }"
node -e "const {execSync}=require('child_process'); try { execSync('openspec --version',{stdio:'ignore'}); console.log('openspec:ok'); } catch { console.log('openspec:missing'); }"

如果缺少 openspec/specs/ 或 openspec/changes/，先判断用户是否明确要接入 OpenSpec：

• 若用户明确要接入：优先运行 aisee openspec ensure --json，并解析 JSON 结果；该命令会按当前 agent runtime 自动选择 OpenSpec tools（Codex 默认是 codex；无法识别时回退到 none），默认启用 Aisee 需要的 expanded workflow，确保 OpenSpec 的项目内 instructions / skills 已安装或已刷新。
• 若用户未明确要接入，或明确表示当前项目不使用 OpenSpec：停止，并说明 aisee:init 不适用；不要生成项目级 AGENTS.md 或其它 OpenSpec/Aisee 配置文件。