القائمة
用于接手并交付本仓库 GitHub 开发 issue；当用户给出 issue 编号、要求实现 issue、处理 issue 关联 change 或从 issue 推进 PR 时使用，先读取 issue/评论，按 rooted OpenSpec 补齐或复用 change，再实现、验证、更新任务并收口。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当 evidence_research_analyst 检索公开来源并压缩半导体事件证据时使用。
当半导体 MainAgent 需要分析已路由事件对 AI GPU、HBM、晶圆代工、设备、存储、供应链和风险的影响时使用。
按 QuantAgent OpenSpec change 实施任务。用户要求开始实现、继续实现、推进 tasks、或基于已审核 OpenSpec 写代码时使用；实现前会检查中文 artifacts、工程质量 gate 和 strict validate 状态。
归档已完成的 QuantAgent OpenSpec change，并在归档前检查 artifacts、tasks、delta spec 同步和中文/英文语法边界。用户要求 finalize、archive、归档 change 或同步 stable spec 时使用。
OpenSpec 探索模式，用于在创建或实施 change 前后澄清需求、调查代码、比较方案和沉淀决策；如需写入 OpenSpec artifacts，默认生成中文正文并保留英文校验语法。
为 QuantAgent 创建新的 OpenSpec change，并一次性生成可评审、可校验、可实施的 proposal、design、specs 和 tasks。用户要求提 proposal、创建 change、生成 OpenSpec、规划行为/架构/契约变更时使用。
| name | gh-issue-deliver |
| description | 用于接手并交付本仓库 GitHub 开发 issue；当用户给出 issue 编号、要求实现 issue、处理 issue 关联 change 或从 issue 推进 PR 时使用，先读取 issue/评论，按 rooted OpenSpec 补齐或复用 change，再实现、验证、更新任务并收口。 |
| license | Proprietary |
| compatibility | {"agent":"*","planning_mode_required":true,"structured_questioning_required":true} |
| metadata | {"language":"zh-CN","scope":"github-issue-delivery","repo":"BqLee-AI/QuantAgent"} |
这个 skill 用来解决 GitHub 开发 issue。它是 spec-aware 交付流程，不是“读到 issue 就直接改代码”。
核心目标是让 issue -> OpenSpec change -> implementation -> PR 形成同一条证据链。不要把实现判断只留在聊天里。
开始前只读当前 issue 必需上下文：
AGENTS.md、README.mdgh issue view <id> --repo BqLee-AI/QuantAgent --json title,body,labels,comments,url,statedocs/design/*.md，必要时再读 docs/prd/*.mdproposal.md、tasks.md、design.md 和 specs/**/spec.md.agents/skills/references/engineering-quality-gate.mdapps/web/**、前端 feature、route、API 调用、组件或运行时容器时，读 .agents/skills/references/web-architecture-gate.md.agents/skills/references/web-file-responsibility-and-feature-structure.mdapps/api/** 时，读 .agents/skills/references/api-architecture-gate.mdpackages/core/**、packages/plugin-sdk/** 或 plugins/** 时，读 .agents/skills/references/core-and-plugin-architecture-gate.mdreferences/workflow.md不要批量扫仓库。不要创建、读取或更新 docs/openspec。
先把 issue 收成四句话：
如果 issue 本身还很散，先问 1-3 个会改变实现路径的问题。不要问低价值偏好题，也不要把未确认设计问题直接下放给实现。
进入实现前必须按 .agents/skills/references/engineering-quality-gate.md 完成硬检查：
AGENTS.md、最近层级 AGENTS.md、issue/comment、相关 design/PRD/OpenSpec 和目标模块现有实现。.agents/skills/references/web-architecture-gate.md 说清 route、app runtime、API/BaseApi/FeatureApi、query/mutation、业务 hook、view component、README、中文注释和目录分组边界。.agents/skills/references/web-file-responsibility-and-feature-structure.md 说清具体文件职责，而不是把拆分决策留到编码时临场发挥。.agents/skills/references/api-architecture-gate.md 说清 router/service/repository/DTO/envelope 边界、DB 操作规范、缓存策略、并发保护和错误处理。.agents/skills/references/core-and-plugin-architecture-gate.md 说清 package 依赖方向、插件分层、DTO 契约、Registry 边界、ORM/Repository 规范和性能边界。实现前和收口时都要判断是否需要提醒用户沉淀：
AGENTS.md。docs/design/ 或开后续 issue。docs/prd/。遵守本仓库规则：
openspec/changes/<change-id>/。proposal.md、tasks.md 和受影响 spec。openspec validate <change-id> --type change --strict --json
处理方式：
当需要新建或重写 OpenSpec artifacts 时，优先使用 .agents/skills/openspec-propose 的流程；当已有 change 可实施时，优先使用 .agents/skills/openspec-apply-change 的流程。
OpenSpec 文档本身可能不合适，不能只在本地生成后继续写代码。只要新建或大幅更新了 OpenSpec artifacts，必须：
openspec validate <change-id> --type change --strict --json。.agents/skills/gh-pr-create 创建一个 OpenSpec-only PR。proposal.md、design.md、tasks.md、specs/**/spec.md 和必要说明。在 OpenSpec-only PR 获得维护者明确认可前，不允许：
如果 issue 已经关联一个维护者明确认可过的 OpenSpec PR 或已合入的 OpenSpec change，可以进入实现；如果只是本地 artifacts 或未获明确认可的 PR，必须先完成审核门槛。
不要把 design review、tasks planning 或验证入口设计写成 OpenSpec 外的第二套流程。它们是在继续加固同一个 change：
proposal.md：为什么现在开这个 change。design.md：主资产、路径、边界、失败链路和取舍。specs/**/spec.md：能力级 requirement 和 scenario。tasks.md：依赖图、并行切片、审核点和验证动作。tasks.md 或执行计划要体现依赖关系，而不是线性施工口号：
只有当前环境和用户明确允许委派时，才把独立任务交给子 Agent；否则在本线程完成，并说明没有委派的原因。
开始实现前检查 tasks.md 是否足够执行：
如果 tasks 太弱，先补强 artifacts 或向用户说明需要暂停审核。
实现时保持这些边界：
apps/api/ 只承载 HTTP 边界，不把核心领域逻辑塞进 router。apps/web/ 负责 React + Vite 前端；保持测试层级清楚。packages/core/ 承载共享配置、数据库、Alembic、错误和基础能力。packages/contracts/ 承载跨前后端契约与生成物边界。runtime/ 本地产物、secrets 或真实 .env。新增 package、依赖或技术栈时要额外谨慎：
选择当前风险需要的最小 harness：
openspec validate <change-id> --type change --strict --jsoncd apps/api && uv run python -m unittest discover -s src/testsbun run --cwd apps/web test:unitbun run --cwd apps/web test:e2ebun run --cwd apps/web test:ctbun run lint、bun run build、bun run fmt:check不要为了“完整”引入外部网络、真实交易服务、真实凭证或重型 E2E。
完成后返回：