用途:为新项目生成Claude Code等代理所需的项目上下文,让项目文档结构对齐全局协作协议。触发场景包括“初始化项目”“项目设置”“配置 Claude Code”“新建项目配置”,以及进入新项目需快速配置时。
主要能力:读取~/.claude/CLAUDE.md及其@include引用文件作为基准;读取自身config/profiles.yaml获取Skill源与各项目类型规则;通过scripts/init.sh detect检测项目类型(any_of、has_skill_md、extensions、dir_patterns,首个命中生效,未命中用default_profile);分析技术栈、目录结构、用途及已有.claude/、CLAUDE.md、docs/;生成AGENTS.md并让CLAUDE.md仅写@include ./AGENTS.md供多代理共享;复制settings.json与.gitignore模板;创建.codex/与.agents/目录并软链共享skills;生成ROADMAP.md、DECISIONS.md、ARCHITECTURE.md、DESIGN.md、CHANGELOG.md及任务清单等真实内容;skill-project类型可执行脚手架。
使用方式:先展示计划并等待确认;安装Skill用skill-manager以符号链接方式装入.claude/skills/;关键命令如mkdir -p .claude/skills/、bash scripts/init.sh codex "<project_dir>"、bash scripts/init.sh agents "<project_dir>"、bash scripts/init.sh scaffold "<project_dir>" "<skill_name>"。
限制:仅依据全局协议、配置与项目分析生成内容,不复制空模板或占位符;已有文件遵循幂等规则,相同软链跳过、已存在不覆盖,AGENTS.md/CLAUDE.md/任务文件已有内容时展示diff由用户决定覆盖、合并或跳过;任务文件仅作当前入口,不建快照或历史归档。