project-init 是 easy-claude 集合中的项目初始化协调技能,目标是在一条幂等路线中初始化或重新评估便携式项目上下文,只配置项目与任务实际支持的能力。它本身不替代底层技能,而是决定何时运行哪个技能。
用途:在缺少所需配置、文档或根指令文件时,于常规工作前运行;也可在新项目搭建或重新评估时使用,统一建立项目身份与上下文文件体系。
主要能力:
- 状态评估:通过 shell 检查判断项目是全新、引导、修复还是重评估,并记录证据。
- 项目配置:要求配置文件有效,最低有效内容为非空 project.name;可选能力区段仅依据仓库证据添加。
- 参考文档:始终处理 lessons.md 与 docs-index-reference.md,task-specific referenceDocs 单独选择。
- 根 AI 上下文:刷新 CLAUDE.md、AGENTS.md 等根指令文件,保留用户撰写内容,采用智能合并而非盲目覆盖。
- 条件性工作:仅在选定或有证据时运行扫描、规范工作流($workflow-code-to-spec)、宿主镜像同步(Codex 镜像)与知识图谱刷新($graph-code --mode=build)。
- 终审门禁:在设置改动后通过 $changes-review --defer=whole-target 与 $why-review 进行审查;未修改任何产物时报告无变化结果。
- 帮助模式:--help 等请求为只读终端模式,说明初始化会决定哪些事项,不创建任务、不扫描、不生成或编辑文件。
使用方式:作为技能被调用,支持 --help 查看初始化决策面。执行前必须先创建完整任务计划,包含评估、设置路线、技能调用、验证、报告与经验总结等可观察任务。流程包含 Phase -1 任务计划、Phase 0 状态评估、Phase 1 路线决策、Phase 2 执行顺序、Phase 2.5 条件性规范工作流、Phase 2.6 终审技能、Phase 3 初始化门禁未运行时的代理规则、Phase 4 验证、Phase 5 条件性图谱刷新,最后输出报告。
适用场景:需要建立或修复便携式项目上下文、配置根 AI 指令文件、同步 Codex 镜像、按证据选择扫描或规范工作流时。
限制:配置文件为必需,但只有 project.name 强制;可选区段缺失不视为配置不完整。扫描仅在选定或有证据的内置目标、或明确标记 scanTarget: "generic" 的自定义文档时运行。规范工作流仅在已有规范语料或已接受的能力范围提供真实归属目标时运行,代码或包名本身不构成接受。图谱刷新仅在工具可用且相关时作为后台子代理运行。Codex 镜像通过 $ai-context-refresh 完成交接解析;不可用时报告精确的 $sync-codex 路线。