DGJ2 项目 Skill 架构 · 江斌知识库

01 · SYSTEM TOPOLOGY

总体架构

公司公共能力 → DGJ2 项目控制面 → 任务执行与证据

01

公司公共能力

PRD / Axure 提取
历史链路分析
API 与 Apipost
数据库设计与只读查询
日志、堡垒机与凭证读取
持续经验收割

输出：跨项目通用工作流

02

DGJ2 项目控制面

AGENTS.md 与项目档案
dgj2-project-maintainer
项目地图与保护文件
15 个项目领域 Skill
需求 / Bug 变更包
验证与发布闸门

输出：带项目约束的执行路径

03

任务执行与证据

代码与配置变更
接口、SQL、日志证据
正常 / 失败 / 旧链路验证
发布步骤与回滚
交付校验结果
经验候选与正式 Skill

输出：可验证、可发布、可复用的交付物

02 · SOURCE OF TRUTH

事实、源码与发现入口

每类资产保留一个权威位置

项目事实入口 doc/ai/index.md 导航项目档案、地图、变更包、契约、Runbook 和验证脚本。

Skill 唯一源码 doc/ai/skills/<skill-name>/ 项目 Skill 只在这里编辑、评审和跟随仓库版本演进。

Codex 发现入口 .agents/skills/<skill-name> 每个入口使用相对软链接指向项目源码，不维护第二份副本。

交付事实 doc/ai/changes/active/<CHANGE-ID>/ 需求、设计、实现任务、测试证据、发布与回滚信息集中在变更包。

03 · REPOSITORY LAYOUT

项目目录结构

项目资料随代码仓库版本演进

dgj2.0/ 项目仓库

AGENTS.md Agent 强制入口与项目约束

.agents/skills/ 15 个相对软链接，供 Codex 自动发现

doc/ai/ 项目 AI 研发资产根目录

index.md 项目资料总入口

project/ 项目、代码、数据、集成、环境、日志、分支地图

skills/ 15 个项目 Skill 的唯一源码

changes/active/ 当前需求与 Bug 变更包

changes/archive/ 完成并归档的交付记录

contracts/ API、事件、枚举、字段映射和示例

runbooks/ 本地、预发、生产、数据库、MQ、故障手册

templates/ PRD、Bug、API 交接模板

scripts/ 创建变更包、交付校验、漂移检查

candidates/ 首次出现、尚待复验的经验候选

reports/harvest/ 知识沉淀审计结果

tests/ 项目 AI 体系测试

Skill 链接关系 .agents/skills/name → ../../doc/ai/skills/name Codex 在项目内发现 Skill；评审和修改始终回到 doc/ai/skills/。

变更包生命周期 changes/active → delivery.yaml 校验 → changes/archive 需求和 Bug 的范围、设计、证据、发布与回滚记录保持在同一目录内。

经验升级路径 任务证据 → candidates → 已有 Skill / 新 Skill 一次性 ID、临时数据和未验证假设不进入长期项目知识。

04 · SKILL CATALOG

15 个项目 Skill

按名称或职责过滤

显示 15 / 15

入口与交付闸门

统一接任务、检查变更、准备发布。

3 个

dgj2-project-maintainer 所有 DGJ2 实质任务的首个入口；读取项目事实并路由后续工作。

dgj2-change-verifier 修改代码、配置、SQL 或接口文档后执行分类检查并生成交付证据。

dgj2-release-checklist-runner 发布前汇总分支、DDL、配置、脚本、重启、回滚和线上验证。

秒杀与接口领域

覆盖秒杀业务、库存、导入导出、端到端流程和前后端契约。

5 个

dgj-flash-sale-maintainer 秒杀活动 OPS、站点商品、购物车、订单、支付、退货和上下游集成。

dgj-flash-sale-inventory-debugger 库存、套包、在途、供给仓、效期和加购/下单库存口径排查。

dgj-flash-sale-import-export-debugger 模板、批量导入校验、Excel 字段映射、导出和 OSS 下载契约。

dgj-flash-sale-flow-tester 从活动创建、OA 到站点购买、支付、待发货和退货的真实链路测试。

dgj-frontend-contract-verifier 对照代码响应、前端使用、Mock 与 Apipost，验证字段和业务口径。

环境、数据与治理

处理公共文件影响、预发证据、测试数据、分支和只读 SQL。

5 个

dgj-common-file-impact-reviewer 修改采购、库存、支付、OA 等公共文件前追踪旧调用方和回归面。

dgj-preprod-request-log-inspector 按接口、单号、request_id 或错误信息定位预发请求日志。

dgj-preprod-test-data-preparer 准备可审批、可运行、可购买的预发活动和关联库存/购物车数据。

dgj-release-branch-guard 控制功能分支、staging 合并、冲突处理和误提交恢复。

dgj-sql-query-runner 按环境和 sid 定位分表，执行开发、预发、生产只读查询。

专项故障排查

沉淀跨表、跨消息链路的高频复杂故障。

2 个

dgj-po-inbound-overreceipt-debugger 采购超入、重复 CG 入库、库存修复及 BI 报表仍显示异常的证据链。

inner-robot-message-debugger 机器人消息从长链路、Redis/Kafka、消费者到业务回调和展示的追踪。

05 · TASK ROUTING

任务路由

先匹配任务类型，再选择项目与公共 Skill

任务	触发场景	执行路径	必须留下的证据
PRD / Axure	新需求、历史需求补验	项目入口 → PRD 提取 → 历史链路 → 设计/任务 → 实现	PRD 变更包 + 接口文档 + 测试 + 发布手册
Bug / 事故	功能异常、数据不一致	项目入口 → 复现/证据 → 根因 → 最小保护修复 → 回归	Bug 变更包 + 根因证据 + 补偿边界
日志排查	预发/生产请求异常	日志 Skill → request_id/业务键 → 调用链 → SQL/代码回查	时间、环境、主机、日志锚点和结论
SQL 查询	订单、库存、支付、入库事实确认	只读连接 → sid/分表定位 → 查询 → 与日志/代码互证	脱敏 SQL、查询时间和只读结果
发布	预发、生产交付	分支保护 → 交付验证 → 发布清单 → 执行 → 回读	DDL/配置/脚本/回滚/验证结果

06 · DELIVERY GATES

交付闸门

delivery.yaml 未通过时不结束交付

G1

需求与范围

PRD 子页面已读取或标注不可访问
现有代码和历史流程已检查
影响范围和保护文件已识别

G2

实现与契约

实现与设计一致
行为条件保持窄范围
接口变化同步本地文档与 Apipost

G3

验证证据

PHP 语法与 diff 检查
正常、失败和旧链路回归
日志/SQL/接口结果写入变更包

G4

发布与沉淀

发布、回滚和验证步骤可执行
delivery.yaml 校验通过
经验进入地图、Skill 或候选池

requirement / bug-reportcurrent-flowimpact-analysisdesigntasksapi-contracttest-reportrelease-runbookdelivery.yaml

07 · CURRENT STATE

当前状态与后续完善项

数据截至 2026-07-23

项目入口与 Skill 发现已完成 AGENTS.md、项目索引、15 个 Skill 源码与 15 个相对发现链接已存在。

需求 / Bug 交付闭环已落地 具备模板、活动包、归档、交付校验、变更验证和发布检查能力。

关键领域与运维入口已覆盖 秒杀、公共文件、预发日志、SQL、分支、PO 入库和机器人消息已有专用 Skill。

补统一机器成熟度审计 项目档案具备较完整能力，但仍需用跨项目统一口径持续生成 L0-L4 审计结果。

持续收敛活动包与候选经验 当前 6 个活动变更包应在交付后归档；复验后的候选经验再升级为正式 Skill。

AGENTS.mddoc/ai/index.mddoc/ai/project/project.yamldoc/ai/project/skill-routing-map.mddoc/ai/skill-catalog.yamldoc/ai/project/protected-files.yaml