用途:project 技能把一条代码路径与 AIDA 对该代码的工作绑定起来,回答“哪个项目拥有此目录”,并支持创建、切换、结束和清理项目。
主要能力:无参数时运行 report,输出 CASE: 1/2/4,给出项目名、状态、代码路径、文件夹及检查报告;CASE 4 会列出已注册项目(最近使用优先),并可能提示版本 5 文件夹可被接管。create 需要代码路径、名称和框架三项事实,会先探测框架、确认路径、校验名称格式 ^[a-z][a-z0-9_]*$,再写入文件、首次提交、登记注册表并运行检查。switch 按精确名称或精确代码路径查找项目,可接管含 project_state.md 的版本 5 文件夹或含 project.json 的文件夹。
使用方式:命令通过 ${CLAUDE_PLUGIN_ROOT}/skills/project/scripts/project-actions.sh 与 detect-framework.sh 执行,例如 report、create --name ... --path ... --projects-home ... --framework ...、switch <target>、git-init <name>、task-rule、unregister、uninstall、record-declined、read-projects-base。运行模式由当前任务声明决定,未声明时默认交互模式;自主模式下部分需人工确认的动作会以退出码 70 拒绝。
适用场景:需要为代码目录建立项目归属、在多个项目间切换、接管旧版项目文件夹或查看项目检查报告时。
限制:task-rule、uninstall、task-rule-remove、record-declined、unregister 等动作需要人工参与;自主模式下缺少代码路径、名称或框架时会停止而非猜测;代码路径被拒绝时退出码 5 并回滚已写内容;项目基础目录仅由 create 和版本 5 接管写入一次,之后需手动编辑 ~/.claude/aida/settings.json 修改。