admin/ycode
1
0 Fork 0
Code Issues Packages Projects Releases Wiki Activity
Files
eaf0ed293a2234e46f0ec48740cb02dd748b239b
ycode/docs/高级项目经理-关德豪-拆解-20261016.md
T

12 KiB
Raw Blame History

最新迁移状态：主上下文已将本包安装到用户 YCode，原文/技能/头像资源与激活及原生鼠标召唤验证通过。四包共356项资源验收，详见四位专家迁入记录。本文“未安装/只读”描述保留为恢复子任务阶段范围。

高级项目经理｜关德豪：REA 包恢复与迁移拆解

日期：2026-10-16。本任务只恢复到独立 .tmp 目录与编写审计工具/本文；未安装、启用专家，未修改生产代码、用户 YCode 配置或原 WorkBuddy 目录，未执行原包脚本。

原版身份与证据

原路径由既有 REA plugins inventory 定位：C:/Users/Administrator/.workbuddy/plugins/marketplaces/experts/plugins/senior-project-manager。对该目录的所有读取均使用正式隔离 REA CLI；本地脚本只读取返回 Evidence 和已恢复文件。

完整目录 inventory：.tmp/rea-project-manager-inventory-20261016.json，Evidence ev_522a113c56cbba2471a47337ef72fa16e99acd0b358aced4fe1d7b38ec38ebd5。

  • rootSha256：304805c85b87e8266294fb3aaf283d45fc71d7977af064fcb1eed1199e9389e6。
  • inventory graph SHA：dc2c760e5b5600a46b76217f67de7c204863aa1f916d5a88f8bd968b811a068c。
  • REA coverage：container-entries / complete，82 个文件、1,879,348 字节。
  • 宿主 .downloaded_at 占 24 字节，只保留 inventory 的哈希记录，不写入恢复包。81 个功能/许可证文件应为 1,879,324 字节。

配置 .codebuddy-plugin/plugin.json：SHA c1626ce77b1fcd8372c8e86a1ae5a52615784cc9f61d2fca4f1780b9c4aa606e，首批文本 Evidence ev_afef644349eb07952a4b663c0aaed031c1f206c228fa51a7ee6e8df88ea204b1。

字段 原包准确值
name / agentName senior-project-manager
version 1.0.1
expertType agent；原包没有 agentType 字段
displayName zh 关德豪，en Dylan
profession zh 高级项目经理，en Senior Project Manager
displayDescription.zh 10年以上项目管理经验，精通瀑布和敏捷，是复杂项目定海神针
categoryId 10-ProjectQuality
agents ./agents/senior-project-manager.md
skills 唯一 ./skills/minimax-docx
avatar avatars/expert.png；310,105 字节；SHA d343e8581bf6d902b56e544b3f201cd836c8cc92cf883faff96fc71e0a393fd2

保留原中英文 defaultInitPrompt、3 个 tags 和 3 个 quickPrompts。中文第一条 quickPrompt 与 defaultInitPrompt 相同；另外两条是风险识别/应对、多团队沟通协作。

角色与工作流

Agent 文件：agents/senior-project-manager.md，5,696 字节，SHA d9187e37363679e5bb56879d35cdbdb73b319c0344ca157619d1f602db3c5bec，与 plugin 同批 Evidence。

原角色正文以 web 项目规格拆任务为核心：读取实际规格、引用准确需求、辨别歧义、控制范围，拆成开发者约 30–60 分钟可实施的任务；每项包含验收标准、修改文件、规格章节引用，再整理技术栈和质量要求。原 prompt 提及 Laravel、Livewire、FluxUI、Alpine.js 和截图验收；它们属于任务模板/用户项目上下文，并不是 plugin 声明的强制安装依赖。

以下三项是原 prompt 的使用者工作区输入/工具前提，完整包 inventory 内没有这些文件：

  • 输入规格 ai/memory-bank/site-setup.md。
  • 详细参考 ai/agents/pm.md。
  • 项目截图工具 ./qa-playwright-capture.sh。

输出任务表路径为 ai/memory-bank/tasks/[project-slug]-tasklist.md，应由真实任务产生，不要求预先存在。这三项缺失不能靠伪造空文件补齐。迁入 YCode 后，模型需要读取当前项目真实规格；引用文件不存在时应说明并由用户需求补充。原文声称 persistent memory/learn from projects，但包内未提供独立记忆实现；只能证明角色指令，不足以证明原宿主记忆等价。

README 介绍瀑布/敏捷、规划/风险管理等能力；Agent 实际指令更具体地面向 web 规格分析与任务拆解。迁移应原样保留两者，不能把介绍文案扩展成包中没有的 Jira/云端自动化。

内置 Word 技能

skills/minimax-docx/SKILL.md：version 1.0.0，MIT，SHA 446bc0c8a42d349f8da21766ca942ce10592f124d41ff747a0e2d474f2b903d1；首批技能文档 Evidence ev_de18a677e89d57b4255e66eab9811a327cdb870b01f20f2bbd325ffaf693e1a7。

包内范围 文件数 字节
minimax-docx 全部 75 1,558,489
scripts/ 47 899,457
scripts/dotnet/ 42 862,964
references/ 18 549,381
assets/ 7 92,325

技能三条流水线：A 创建新文档；B 编辑/填充现有内容；C 应用样式或模板（overlay / base-replace）。通过场景指南、C# SDK 示例和排版参考选择实现；写后运行 merge-runs、XSD、business 校验，失败可 fix-order 后重验；模板流程要求 gate-check、diff 和最终预览。

源使用入口是 dotnet run --project scripts/dotnet/MiniMaxAIDocx.Cli --。首次环境准备为 bash scripts/setup.sh 或 Windows powershell scripts/setup.ps1，每个 session 首次操作运行 scripts/env_check.sh。C# scaffold 引用 DocumentFormat.OpenXml, 3.2.0。这些是源文件说明，不代表当前机器已安装或已实际生成 Word。

素材并非现成 .docx 模板：包含 3 份样式 XML、4 份 XSD、18 份参考文档及 C# 示例。用户需要提供的输入 Word/模板不在包内。

恢复工具与覆盖

  • scripts/rea/project-manager-recover.mjs：固定 root SHA；每批不超过 16 个精确路径；严格验证 REA 返回 SHA、字节数、落盘 SHA 和 retained export。
  • scripts/rea/project-manager-audit.mjs：只分析已恢复文本，解析 JSON/YAML、项目依赖和环境脚本行，输出 .tmp/rea-project-manager-analysis-20261016.json。
  • 输出目录 .tmp/rea-project-manager-recovered-20261016/。
  • 输出 evidence-manifest.json 每项包含 {path,bytes,sha256,evidenceId,retainedExport}；额外记录 inventory pin、覆盖与排除的宿主标记。此 manifest 是迁移审计资料，不属于原专家包功能文件。

原 text 白名单后缀限制已由主上下文通过正式 provider 扩展，旧文本 13/13、新资源 16/16 自有 fixture 验证通过后再采集。本次完成 80 个文本 + 1 个 PNG = 81/81 功能/许可证文件，1,879,324 字节，pending 0。每个恢复文件与 inventory、REA export、落盘字节三方 SHA/size 一致。覆盖 82 个原文件中的全部功能文件；唯一排除 .downloaded_at 已单列，不混入用户会话标记。

最终 6 批导出 Evidence ID（所有原路径/逐文件哈希均见 manifest）：

  • ev_7faf6a7a38f49bf647382424d3e814639dfddd232458326090df4c2729b438fe
  • ev_0b805314c687a8cead2822d89391003759cd9ba9a06a064e335d74913ef3e1b5
  • ev_0212698678293b356f8a44a590507f8068a32edb2e603933824bd2c739424008
  • ev_8a4ef08d08b8b94b12bd116a53563dfc81e352eac44111f8480770e3af0820f7
  • ev_dc796646e432d60228236a48ead7eb406aa4488af2c97f740bda8686fcf0569a
  • ev_cb670443f47df8c0ee2b955e21b1838072d06fc1f8e0e1c85de5e10ea95440fc（PNG）

YCode 兼容边界

当前 YCode src/main/capabilities/experts.ts 已识别 .codebuddy-plugin/plugin.json、Agent YAML、expertType agent、相对 skills 路径、真实包 prompt，并将内置 SKILL 指令与 ycode_expert_resource 资源读取接入当前专家回合。此包没有 plugin 声明的 MCP/connector 依赖，也不是需团队调度的 team 包。

当前完整包 82 文件/约 1.88MB，低于 YCode 256 文件/4MiB 包限制；头像 310,105 字节也低于 500KiB 本地 data URL 阈值。原 description.zh 可能产生长度建议警告，属于原文，应保留。根上下文正在扩展 C#/XML/XSD/脚本等文本资源读取范围；只有 JSON/MD 可见不足以支撑 Word 技能。

运行时另需：真实 .NET SDK/OpenXML 依赖、转换/预览环境、当前项目可读写目录以及工具审批。当前 shell PATH 只发现 Python，未发现 dotnet/bash/pandoc/soffice；这是本机只读 PATH 探测，不是全盘安装检测。此任务未安装任何环境。包恢复、专家被列出和 prompt 生效均不等于 Word 三条流水线已验收。

精确运行依赖与原包内部差异

以下结论来自已恢复文件的静态源码，不是执行成功结论。

依赖/行为 原文件证据与实际值
.NET SDK scripts/env_check.sh 第 34–67 行检查 dotnet 与 major >=8；项目 TargetFramework=net8.0
Core 依赖 MiniMaxAIDocx.Core.csproj：DocumentFormat.OpenXml 3.5.1、System.CommandLine 2.0.5
CLI 依赖 MiniMaxAIDocx.Cli.csproj：System.CommandLine 2.0.5 与 Core project reference
首次还原/编译 env_check 第 79–96 行会执行 dotnet restore/build，可能访问 NuGet；它不是纯只读检查
Bash env_check/docx_preview/doc_to_docx 均为 Bash；Windows setup.ps1 不等于已解决所有 Bash 入口
Word 文本预览 docx_preview 第 26–38 行：pandoc 输出 plain text；没有 pandoc 时 unzip XML 前 100 行，没有截图/PDF 渲染
老 .doc 转换 doc_to_docx 第 25–38 行要求 soffice 并调用 LibreOffice headless conversion
可选工具 env_check 第 115–185 行把 pandoc/soffice/zip/unzip 标为 optional；缺少时对应能力下降
环境 env_check 第 12 行 DOTNET_CLI_UI_LANGUAGE=en，后段检查 UTF-8 LANG 和 .sh 可执行权限
初始安装 setup.ps1 / setup.sh 会调用 winget/choco/scoop 或系统包管理器、SDK 下载与 NuGet；原样保留但本任务未执行
外部 API plugin 没有 API key、MCP 或 connector 声明；所恢复 C#/shell/PowerShell 中未发现 HttpClient/Bearer/API_KEY 运行链，不能因此推断所有文档链接无需网络

上述 Core/CLI 项目、Program.cs、docx_preview/doc_to_docx 对应 Evidence ev_0b805314c687a8cead2822d89391003759cd9ba9a06a064e335d74913ef3e1b5；env_check/setup 对应 ev_dc796646e432d60228236a48ead7eb406aa4488af2c97f740bda8686fcf0569a。精确 SHA/路径/脚本行见 .tmp/rea-project-manager-analysis-20261016.json 和 evidence manifest。

需要保留并如实说明的原包差异：

  • SKILL scaffold 指定 OpenXml 3.2.0，实际项目固定 3.5.1，不能混称同版本。
  • SKILL scaffold 注释给出 run-script，但 Program.cs 只注册 create/edit/apply-template/validate/merge-runs/fix-order/analyze/diff 八条命令，没有 run-script 注册。直接 C# 项目路径与实际 CLI 路径需区别使用，不能声称那条示例已能运行。
  • 源引用的 scripts/...、references/...、assets/... 相对于技能根 expertRootDir/skills/minimax-docx，不是用户会话 cwd。迁移宿主需要明确真实安装路径，执行时仍走既有工具审批。
  • .slnx 在包内，但本机 SDK/解决方案加载/编译未执行；不把 env_check 的 >=8 条件当作完整构建兼容性证明。

验证结果与交接

node scripts/rea/project-manager-recover.mjs
node scripts/rea/project-manager-recover.mjs --check
node scripts/rea/project-manager-audit.mjs

三个命令均 PASS。恢复与离线核验断言：81 文件、1,879,324 字节、相同 root pin、逐文件大小与 SHA、对应 retained Evidence、没有 .downloaded_at、没有 pending。静态 audit 解析完整元数据、YAML、3 个 .NET 项目/solution 文件与 5 个环境/转换脚本。

主上下文已获完整恢复目录与 manifest，可开展真实安装、专家身份激活和资源读取验收；本子任务没有写用户 YCode。当前已验证的是原包完整恢复与静态依赖，不是 .NET 编译、Word 生成、模板套用或原宿主记忆等价。

Reference in new issue View Git Blame Copy Permalink