# 代码开发工程 **Repository Path**: lance521/code-development-project ## Basic Information - **Project Name**: 代码开发工程 - **Description**: 开发工程技能 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-20 - **Last Updated**: 2026-09-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # code-development-project WorkBuddy 自定义「专家团(Agents)」与「技能(Skills)」的复用仓库。 本仓库用于把在 WorkBuddy 中创建的专家/技能沉淀下来，方便在多台电脑之间同步、复用。 --- ## 当前收录 `experts/my-experts/` 是一个完整的 WorkBuddy **本地 marketplace**，包含 1 个开发专家团（dev-team，9 个成员）与 6 个单专家： | 专家标识 | 名称 | 定位 | 关键能力 | |---|---|---|---| | `dev-team` | 开发专家团 | 遗留系统迭代开发 | 交付总监「程全通」编排 8 名专家：需求翻译 → 现状分析 → 方案审批 → 精准实现 → 契约检查 → 回归验证 + Bug 定位 + 性能优化，把一句话需求变成可交付结果 | | `requirement-ba` | 需求翻译官 | 需求规格化 | 条目化需求、业务规则、验收标准、增量识别（新增/已实现/微调） | | `code-archaeologist` | 代码考古学家 | 只读逆向工程 | **场景路由**（项目架构全景 A / 具体功能深挖 B / 功能盘点 C 自动判定）；入口一览 + 深度调用链(L0/L1/L2) + 业务语义翻译 + 清晰拆分的 Mermaid 图 + 配置溯源；需求文档比对与偏差发现；子功能自动拆文件；强制只读，不修改任何文件 | | `backend-surgeon` | 外科手术后端官 | 精准 Java 修改 | 行级精准编辑、限定 `src/main/java`、禁止重写整类、`mvn compile` 校验；输出 `.patch` / 前后代码对照 | | `compat-architect` | 兼容性架构师 | 方案评审 | 现状外设计（新表/新框架/边界/配置）多方案权衡、兼容性影响评估、决策记录 | | `contract-officer` | 契约兼容官 | 契约核验 | 实施前预检 + 实施后核验，Feign/序列化影响分级（兼容/需同步/破坏性） | | `regression-tester` | 回归测试官 | 回归验证 | 按验收标准设计用例、执行现有测试套件（mvn test）、需求→用例覆盖矩阵 | | `bug-locator` | Bug 定位官 | 禅道 Bug 定位 | 只给禅道 Bug 标题/编号 → 禅道 MCP 读题 → 需求对照 → 定位代码 → 定向考古 → 定性结论（**需求问题 / 代码问题 / 环境配置问题**，附证据 文件:行号 + 修改建议）；只定位不改码，修改交外科手术后端官 | | `perf-optimizer` | 性能优化师 | 性能优化 | 慢接口/高CPU/慢SQL/内存问题 → 瓶颈定位 → 成因分析（N+1/全表扫/锁/大对象）→ 量化优化方案（索引/缓存/批处理/异步，带预期收益）→ 验收验证（前后耗时/压测对比）；出方案+验收，实施交外科手术后端官 | ### 开发专家团架构 ```mermaid flowchart TD subgraph dev-team[开发专家团 dev-team] L[程全通
交付总监
编排·审批·汇编] L --> A[温楚清
需求翻译官] L --> B[顾久诚
代码考古学家] L --> C[刀正准
外科手术后端官] L --> D[葛拓新
兼容性架构师] L --> E[甄约安
契约兼容官] L --> F[何验全
回归测试官] L --> G[谢真源
Bug 定位官] L --> H[柳速成
性能优化师] end A -->|需求规格 REQ-n| C B -->|现状·调用链·影响面| C B -->|偏差权威结论| A C -->|现状外设计| D C -->|改动清单| E C -->|diff| F D -->|决策记录| L E -->|契约分级| L F -->|回归结果| L G -->|定位结论+修改建议| C H -->|量化优化方案| C ``` > 👇 想要看每专家的**详细工作流图**？跳到下方 [每位专家详情](#每位专家详情)。 **协作铁律**：团队创建必须且只能由主理人执行；成员专业产出必须由成员本人输出，主理人只做编排与汇编；所有跨成员信息流必须经主理人中转；现状外设计必须经用户审批后方可实施。 每个专家目录结构（以 `code-archaeologist` 为例）： ``` experts/my-experts/ ├── .codebuddy-plugin/marketplace.json # 集市清单，登记所有专家 └── plugins/ ├── code-archaeologist/ │ ├── .codebuddy-plugin/plugin.json # 专家元信息(名称/描述/标签/推荐提示词) │ ├── agents/code-archaeologist.md # 系统提示词 + 技能定义 + 输出规范 │ ├── avatars/expert.png # 头像(可手动替换) │ └── README.md ├── dev-team/ (团队专家团：agents/ 含 9 个成员 MD，v1.3.0) └── backend-surgeon/ (同上) ``` --- ## 每位专家详情 **dev-team 9 名成员**（含 1 团队主理人 + 8 成员，含两位新专家：Bug 定位官、性能优化师）：
程全通 · 交付总监 · dev-team-team-lead _把一句话需求变成可交付结果：拆任务·编排·审批·中转·汇编；需求对齐校验终态门禁。_ ```mermaid flowchart LR U[用户] -->|一句话需求| L[程全通
交付总监] L -->|Phase1 拆任务| P1[BA+考古
并行] P1 --> L L -->|Phase2 评审| P2[后端官
+架构] P2 -->|现状外| L L -->|交用户拍板| U P2 -->|Phase3 实施| P3[后端官
小步编译] P3 -->|Phase4 核验| P4[契约+回归] P4 -->|Phase5 交付| L L -->|汇编+需求对齐校验| U ```
温楚清 · 需求翻译官 · requirement-ba _需求正向拆规格；条目化+业务规则+验收标准+增量识别+需求基线维护；冲突标疑给考古学家权威判定。_ ```mermaid flowchart TD A[需求原文
PRD/会议纪要/口头] --> B[条目化
REQ-n 编号] B --> C[业务规则+边界
+验收标准] C --> D[增量识别
新增/已实现/微调] D --> E[挂接需求基线
docs/requirements] E --> F[标疑冲突
交考古裁定] ```
顾久诚 · 代码考古学家 · code-archaeologist _只读逆向工程；场景路由 A/B/C 自动判定；深度调用链+业务语义翻译+Mermaid图+配置溯源；需求↔实现偏差发现。_ ```mermaid flowchart TD A[用户给功能名] --> R{场景路由} R -->|A 全景| P[docs/project-map/] R -->|B 深挖| D[docs/code-context/] R -->|C 盘点| I[docs/feature-inventory/] P --> K[Controller→Service→Mapper
L0/L1/L2 深度调用链] D --> K I --> K K --> N[需求文档对照
主动发现偏差] N --> O[只读产出
不写代码] ```
刀正准 · 外科手术后端官 · backend-surgeon _行级精准 Java 实现；双文档驱动（考古+PRD）；现状内全权，现状外必审批；mvn compile 小步验证；只动 src/main/java。_ ```mermaid flowchart TD A[需求规格+考古报告] --> B[设计落位
现状内全权] B --> C{现状外?} C -->|是| D[出方案
交用户拍板] D -->|批准| E C -->|否| E[小步修改
mvn compile] E --> F[改动清单
+diff] F --> G[不重写整类
不改测试/配置/前端] ```
葛拓新 · 兼容性架构师 · compat-architect _现状外方案评审；多方案权衡+兼容性影响+演进余量；产出决策记录供用户拍板；只评审不实施。_ ```mermaid flowchart TD A[后端官的
现状外方案] --> B[2-3 候选
权衡矩阵] B --> C[兼容性影响
接口/数据/调用方] C --> D[演进余量
未来扩展] D --> E[决策记录
交用户拍板] E -->|批准| F[后端官实施] E -->|回退| A ```
甄约安 · 契约兼容官 · contract-officer _契约预检+核验；接口签名/Feign/序列化影响分析；分级（兼容/需同步/破坏性）→ 破坏性升级架构师+用户拍板。_ ```mermaid flowchart TD A[后端官改动清单] --> B[预检
签名/参数/返回结构] B --> C[Feign 调用方
+序列化兼容] C --> D{分级} D -->|兼容| E[通过] D -->|需同步| F[列调用方
同步升级] D -->|破坏性| G[升级架构师
制定方案] E --> H[实施后核验
实际diff] F --> H G --> H ```
何验全 · 回归测试官 · regression-tester _回归用例设计+执行现有测试套件；按验收标准生成正/反/边界用例；输出需求→用例覆盖矩阵；不写新测试代码。_ ```mermaid flowchart TD A[验收标准+影响面] --> B[正/反/边界
三类用例] B --> C[覆盖
改动点+调用方] C --> D[执行现有测试
mvn test] D --> E[结果矩阵
需求→用例] E --> F[环境阻塞
标注不造数据] ```
谢真源 · Bug 定位官 · bug-locator _禅道 MCP 读题→需求对照→定位代码→定性结论（需求/代码/环境）；只定位不改码。_ ```mermaid flowchart LR A[禅道 Bug
标题/编号] --> B[禅道 MCP
queryBug] B --> C[需求对照
预期vs实际] C --> D[定位代码
Grep 入口] D --> E[定向考古
调用链/配置] E --> F{定性} F -->|需求问题| G[回 BA 重估] F -->|代码问题| H[后端官实施] F -->|环境问题| I[向用户说明] ```
柳速成 · 性能优化师 · perf-optimizer _瓶颈定位→成因分析→量化方案→验收；N+1/全表扫/锁竞争识别；出方案+验收不实施。_ ```mermaid flowchart TD A[性能问题+量化目标] --> B[瓶颈定位
调用链拆解] B --> C[成因分析
N+1/全表扫/锁/大对象] C --> D[量化方案
预期收益+风险] D --> E{风险} E -->|高| F[架构师评审
用户拍板] E -->|低| G[后端官实施] F --> G G --> H[验收
前后耗时对比] ```
**6 个单专家**：
温楚清 · 需求翻译官(单) · requirement-ba-single _单专家：需求条目化+验收标准+增量识别；维护需求基线。_ ```mermaid flowchart TD A[原文] --> B[条目化] B --> C[业务规则+验收] C --> D[增量识别] D --> E[需求基线] ```
顾久诚 · 代码考古学家(单) · code-archaeologist-single _单专家：场景路由 A/B/C 自动判定；强制只读，不修改任何文件。_ ```mermaid flowchart LR A[功能名/类名] --> R{场景路由} R -->|A 全景| P[项目架构图] R -->|B 深挖| D[入口+调用链] R -->|C 盘点| I[功能清单] P --> O[只读产出] D --> O I --> O ```
刀正准 · 外科手术后端官(单) · backend-surgeon-single _单专家：行级精准编辑；限定 src/main/java；不重写整类；每步编译校验。_ ```mermaid flowchart TD A[需求+考古] --> B[设计落位] B --> C[小步修改] C --> D[mvn compile] D -->|通过| E[下一处] D -->|失败| F[回滚+报告] ```
葛拓新 · 兼容性架构师(单) · compat-architect-single _单专家：方案评审；多方案对比；不实施，只产出决策记录。_ ```mermaid flowchart TD A[方案] --> B[多方案权衡] B --> C[兼容性影响] C --> D[决策记录] D --> E[交用户拍板] ```
甄约安 · 契约兼容官(单) · contract-officer-single _单专家：契约分级（兼容/需同步/破坏性）；破坏性升级架构师。_ ```mermaid flowchart TD A[改动] --> B[签名/参数/返回] B --> C[Feign/序列化] C --> D[分级输出] D --> E[兼容/需同步/破坏性] ```
何验全 · 回归测试官(单) · regression-tester-single _单专家：按验收标准设计用例；执行现有测试；输出需求→用例覆盖矩阵。_ ```mermaid flowchart TD A[验收标准] --> B[正/反/边界] B --> C[执行 mvn test] C --> D[覆盖矩阵] ```
## 在其他电脑上安装(复用) ### 方式一：脚本一键安装（推荐） **Windows（PowerShell，以管理员或普通用户均可）：** ```powershell cd <仓库根目录> powershell -ExecutionPolicy Bypass -File install.ps1 ``` **macOS / Linux（bash）：** ```bash cd <仓库根目录> bash install.sh ``` 脚本会把 `experts/my-experts` **合并复制** 到本机 `~/.workbuddy/plugins/marketplaces/my-experts`（已存在则覆盖更新，不会删除你已有的其他专家）。 ### 方式二：手动复制 把仓库里的 `experts/my-experts` 整个文件夹，复制到本机的： - Windows：`C:\Users\<你的用户名>\.workbuddy\plugins\marketplaces\my-experts` - macOS / Linux：`~/.workbuddy/plugins/marketplaces/my-experts` --- ## 验证是否生效 1. 重新打开 WorkBuddy（或刷新「专家 / 我的专家」面板）。 2. 在左侧「专家」→「我的专家」中应能看到 **开发专家团（dev-team）**、**代码考古学家**、**外科手术后端官** 等全部专家。 3. 直接对话 `@开发专家团`，输入「帮我实现/分析某个需求」即可走完整流水线；或 `@代码考古学家`，输入「帮我梳理某业务逻辑，展示入口、深度链路与业务流程图」实测单专家。 > 若复制后未自动出现：打开 expert-manager 技能，运行其 register 命令重新登记 marketplace 即可。 --- ## 仓库约定 - `experts//`：每个子目录是一个独立 marketplace，结构与 `~/.workbuddy/plugins/marketplaces/` 完全一致。 - 新增专家时：在本机用 expert-manager 技能创建后，把对应 `plugins/` 目录同步回本仓库并提交推送即可。 - 头像 `avatars/expert.png` 为 512×512 PNG，可自由替换。 ## 更新日志 - **2026-08-27 v1.7.0** README：新增「每位专家详情」节，14 张 Mermaid 流程/能力图（dev-team 9 名成员 + 6 个单专家），details 折叠；架构图下加直达锚点。 - **2026-08-27 v1.6.0** dev-team v1.3.0：正式开发上线两位新专家——**Bug 定位官**（bug-locator，谢真源，禅道 MCP 读题→定性结论，只定位不改码）与**性能优化师**（perf-optimizer，柳速成，瓶颈定位→量化方案→验收）；新增 Workflow 4/5；plugin.json/team-lead/README 全部同步注册（9 成员）。 - **2026-08-27 v1.5.0** README：新增规划中专家——Bug 定位官（bug-locator，谢真源）、性能优化师（perf-optimizer，柳速成）完整介绍（定位/工作流/协作边界），架构图补充两位规划成员。 - **2026-08-27 v1.4.0** README：补全当前收录（dev-team 专家团 + 6 单专家），新增「开发专家团架构」Mermaid 图与协作铁律。 - **2026-08-20 v1.3.0** `code-archaeologist`：新增「防幻觉铁律」（无源码不画图）、强制调用链最小深度 ≥3、Mermaid 图强制 18px 字体，避免放大模糊。 - **2026-08-20 v1.4.0** `code-archaeologist`：Mermaid 防遮挡——单图 ≤8 节点、短标签、加大间距、每图后附 ID 映射表。 - **2026-08-20 v1.5.0** `code-archaeologist`：新增**场景路由**（A 项目架构全景 / B 具体功能 / C 功能盘点，按输入自动选模板与目录），子功能自动拆文件嵌套。 - **2026-08-20 v1.6.0** `code-archaeologist`：自审收敛——补全时序图/状态图语法要点、修正深度链路图 ID 与「禁数字 ID」规则矛盾、场景 C 输出路径统一为 `docs/feature-inventory/`、新增「报告完成前自检」、maxTurns 80→150 防大项目截断。 - **2026-08-20 v1.7.0** `code-archaeologist`：需求文档比对正式嵌入输出——单功能模板新增第 9 节「需求文档比对」（一致/偏差/文档缺失实现，文档冲突以代码为准、偏差记入风险）、项目全景新增 `08_req_compare.md`、自愈清单增项；明确「落盘文件是唯一最终交付物，对话内联为精选摘要」的边界约定。 - **2026-08-20 v1.8.0** `code-archaeologist`：按用户审查结论收口——①输出目录去日期前缀、重跑覆盖同名目录（不堆版本）；②对话内联收敛为「场景声明+入口精简+关键图+路径」，完整内容只在文件；③需求比对默认仅场景 B，场景 A 需显式要求；④新增第 6 节「影响面/爆炸半径」评估（下游 Feign/定时/MQ 依赖），支撑老系统改造改动影响判断。