用途
pod-init 是 CocoPlus 的初始化技能,目标是在当前工作目录中建立完整的 CocoPlus 项目包。它适用于首次将 CocoPlus 引入项目,或需要重置项目级 CocoPlus 配置的场景。
主要能力
该技能按固定流程完成以下工作:
- 预检:检查 .cocoplus/ 是否已存在,若存在则提示已初始化并停止;检查 Git 仓库是否存在,若不存在则询问是否执行 git init。
- 创建目录结构:创建 .cocoplus/ 及其全部必需子目录,包括 lifecycle、memory、prompts、monitors、brew、grove、grove/patterns、meter、snapshots、modes、config、fleet、pull、harvest、seeds、map、map/intermediate、map/archive、flow、flow/artifacts、flows、flows/templates、flows/templates/archive、proposals、proposals/archive、routines、session、personas、personas/archive、skills、cupper、recall、governance、sentinel。
- 复制模板文件:从插件模板目录复制 AGENTS.md、project.md、flow.json、notifications.json、safety-config.json、cocoplus.toml 以及四个监控配置(narrator、cost-tracker、quality-advisor、memory-capture)。其中 project.md 会通过交互提示收集项目名称、一句话描述、主要目标,并替换所有者信息为 git user name。
- 初始化模式标志:仅创建 safety.normal 与 memory.on 两个空标志文件,其他模式需开发者后续显式启用。
- 初始化生命周期元数据:创建 lifecycle/meta.json,初始 current_phase 为 not_started,同时生成 cocoplus-context.md 宪法上下文。
- 创建项目级 .gitignore:排除瞬态运行时文件、可再生成快照、日志、临时队列等。
- 创建根目录 AGENTS.md 跳转文件:指向 .cocoplus/AGENTS.md。
- 初始化角色与子代理注册表:包括 personas.json(8 个默认简写映射)、subagents.json、动态角色注册表等。
- 初始化会话状态:创建 PROGRESS.md、CONTEXT.md、任务队列、迭代预算、预算状态、状态文件等。
- 可选启用 CocoAudit:询问开发者是否启用会话审计轨迹,若启用则创建 cocoaudit.on 标志与 audit.md 文件。
- 校验 Pod 作用域声明:若项目计划在 CocoFlow 并行步骤中注册 pod,检查其 .agent.md 是否声明 excludes 字段,缺失时给出警告(非阻断)。
- 创建首次 Git 提交:添加 .cocoplus/、AGENTS.md、cocoplus.toml 并提交。
使用方式
用户调用该技能后,按预检、建目录、复制模板、写配置、创建状态文件、Git 提交的顺序执行。若 .cocoplus/ 已存在会直接停止;若 Git 未初始化会询问是否执行 git init。模板替换涉及 {{TIMESTAMP}}、{{SESSION_ID}}、{{PROJECT_NAME}}、{{PROJECT_DESCRIPTION}}、{{PROJECT_GOAL}}、{{OWNER}} 等占位符。成功后会输出目录结构摘要与下一步命令提示(如 $spec、$pod status、$cocoplus on)。
适用场景
适合首次为项目启用 CocoPlus 的开发者,尤其是需要在数据工程流程中管理生命周期、会话状态、角色与监控的项目。也适合需要合规审计轨迹的受监管环境,可通过 CocoAudit 选项开启。
限制
- 仅在 .cocoplus/ 不存在时执行,已初始化目录不会覆盖。
- 默认只启用 safety.normal 与 memory.on,其余模式需手动开启。
- 非控制台功能行为由 V2 原生技能实现,初始化不复制脚本文件到 .cocoplus/。
- 必须存在 Git 仓库或在询问后同意初始化,否则停止。
- Snowflake 数据库/架构字段默认留空,除非开发者提供。
- Pod 作用域校验仅为建议性,不阻断单独执行流程。