repositories必须写在主项目根composer.json顶层，与require平级；type必须为"path"，url指向含合法composer.json的目录；本地包name须与require逐字一致，且需git初始化和symlink配置才能实时调试。
repositories 必须写在主项目根 composer.json 顶层
Composer 只读取你当前执行 composer install 或 composer update 的那个项目的根目录 composer.json 中的 repositories 字段，其他任何位置写的都无效。常见错误包括：把 repositories 塞进 extra、config 或本地包自己的 composer.json 里——这些全被忽略。
正确结构是和 require、autoload 平级：
{
"require": {
"acme/utils": "dev-main"
},
"repositories": [
{
"type": "path",
"url": "../acme-utils"
}
]
}
注意：repositories 是数组，不是对象；type 必须是 "path"（不是 "package" 或 "vcs"）；url 必须指向一个**含合法 composer.json 的目录**，不能以 / 结尾。
本地包的 name 和 require 必须逐字一致
这是 Could not find package 最常卡住的地方。Composer 不做大小写折叠、不忽略分隔符、不自动补 vendor 名。
- 主项目
require写的是"acme/utils": "dev-main" - 那本地包目录下的
composer.json中name就必须是"acme/utils"，不能是"Acme/utils"、"acme-utils"、"acme/utils-dev"或"acme\utils" - 路径中所有斜杠方向也必须一致（Unix 风格正斜杠
/）
另外，本地包目录下必须有 Git 仓库（至少 git init && git add . && git commit -m "init"），否则 Composer 无法识别 dev-main 这类分支别名。
启用 symlink 才能实时调试，且配置位置很关键
默认情况下，path 类型仓库在 Linux/macOS 上会尝试创建符号链接，在 Windows 上则静默 fallback 到复制模式——改本地代码根本不会反映到 vendor/ 下。
要强制启用 symlink，必须在**本地包自己的 composer.json** 里加：
{
"name": "acme/utils",
"options": {
"symlink": true
}
}
不是主项目的 composer.json，也不是 repositories 条目里加——这里加了也没用。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
Windows 用户还需以管理员身份运行终端；Docker 容器需加 --cap-add=SYS_ADMIN 并确保挂载支持 symlink。
验证是否生效：ls -la vendor/acme/utils（macOS/Linux）应看到 -> 指向源目录；Windows 上 dir vendorcmeutils 应显示“JUNCTION”。
autoload 更新和类找不到问题怎么解
即使 symlink 成功，新增类或修改 PSR-4 映射后，vendor/autoload.php 也不会自动感知——它只认上次 dump-autoload 生成的映射表。
每次改完本地包的 autoload 配置（比如新增命名空间、调整 src/ 路径），都必须手动刷新：
composer dump-autoload -o（推荐加 -o，生成优化版静态映射）
还要检查本地包 composer.json 中 autoload 是否写对：
-
"psr-4": {"Acme\Utils\": "src/"}—— 注意双反斜杠和末尾斜杠 - 如果用了
autoload-dev，测试类路径也得带末尾斜杠："Acme\Tests\": "tests/"
别在 require 'vendor/autoload.php' 前就 new 类，也别手动 require 具体文件——这会绕过自动加载机制，掩盖真实问题。
