@xgent-ai/skills 0.5.0 → 0.6.0

package/skills/review-prd-dev-gaps/SKILL.md

@@ -1,18 +1,19 @@
 ---
 name: review-prd-dev-gaps
-description: 接受 PRD 与已完成的开发计划，追读里程碑完成记录并核对实际实现，将差异分为明确遗漏、合理变更和需用户 Triage 的实现差异；通过交互式问答确定处置，有 follow-up 时调用 dev-plan 创建 gaps plan。用于开发完成后的需求覆盖核查，不用于评审 PRD 质量、计划设计或单次代码 diff。
+argument-hint: "<PRD> <已完成开发计划...> [上轮报告] [复审/完整核查] [G-ID/范围] [仅报告] [报告路径]"
+description: 用于开发完成后的 PRD 覆盖核查；不用于 PRD 质量、计划设计或单次 diff 评审。对照已完成计划、记录和实现，区分遗漏与变更，交互裁定差异，必要时生成 gaps plan。
 ---
 
 # review-prd-dev-gaps · PRD 与开发交付差异核查
 
 目标：回答 **PRD 要求的能力实际上交付了什么，哪些漏做了，哪些调整有充分依据，哪些差异需要用户拍板，以及还要补什么。** 以 PRD 建立完整覆盖账本，以计划、完成记录和实际行为交叉核实，不把「计划已完成」等同于「PRD 已实现」。
 
-默认交付完整差异报告；存在应跟进事项时，再实际调用 `dev-plan` 产出独立 gaps plan。`references/` 相对本文件解析，回复语言跟随用户。
+默认交付完整差异报告；存在尚未被已有计划承接的已确定跟进事项时，再实际调用 `dev-plan` 产出独立 gaps plan。复审先核对已有计划，用户限定仅报告时不生成计划。`references/` 相对本文件解析，回复语言跟随用户。
 
 ## 边界
 
 - 输入为 PRD、已完成开发计划及其引用的完成记录；代码仓、测试、运行证据和历史决策用于核实。目标无法唯一确定时询问文档/仓库位置，先做不依赖该信息的调查，不擅自选择相邻文档。
-- 默认只写差异报告和新 gaps plan。原 PRD、原计划、完成记录和代码保持只读；文档同步也列为 follow-up，不自动修改历史完成事实。不自动实施、创建 issue、发布或发送评论。
+- 默认写差异报告、新 gaps plan 及已启用台账的事实索引（见文末）。原 PRD、原计划、完成记录和代码保持只读；文档同步也列为 follow-up，不自动修改历史完成事实。不自动实施、创建 issue、发布或发送评论。
 - 只核对 PRD 及已确认变更承诺的范围，不新增产品机会，不设问题数量或 top-N 截断。明确不在本期的需求保留追踪去向，不当成本期遗漏；未获确认的删减/延期不能算范围外。
 - 参考 `gen-specs-as-issues` 的文档对照实际行为、用户旅程和依赖分析思路，不继承其问题配额、评分公式或 issue 创建流程；运行时不依赖该参考技能。
 
@@ -24,6 +25,19 @@ description: 接受 PRD 与已完成的开发计划，追读里程碑完成记
 4. 核对完成声明与记录：里程碑退出条件、跳过/失败测试、局部验收与阶段终验是否一致。原计划实际未完成时说明输入前提不成立，继续核对可确认部分，不能把未完成项包装成「完成后新发现」的遗漏。
 5. 读取 [references/report-contract.md](references/report-contract.md)，确定报告路径，建立 `PRD → 计划/里程碑 → 完成记录 → 实际行为/验证` 的追踪账本。**从 PRD 向下追踪**，防止只审计划已有条目而漏掉从未进入计划的需求。
 
+## 修复效果复审
+
+用户要求“复审 / re-review / 检查修复效果”时启用；要求完整重审则仍执行完整流程。先读取 [报告合同](references/report-contract.md) 的复审约定。上轮报告以用户指定、当前上下文或明确的记录链接定位；多个候选无法确定时仅澄清对应范围，不按最新文件时间猜选。
+
+- 默认复审上轮全部问题、待核实项及直接受修复影响的回归；用户指定 ID/范围时只核对该范围，其余明确未复核。没有可用上轮报告时可继续当前对象审查，但不能声称旧问题已逐项关闭。
+- 读取上轮 G-ID、D-ID、原计划及已有关联 gaps plan 和完成记录；沿用仍有效的用户决定。逐项核对需求是否补齐及直接受影响的用户路径，不因计划自报完成关闭缺口。复审模式的覆盖账本标明本次范围，其余保留“本轮未复核”，不能冒称全 PRD 已覆盖。
+- 先查已有 gaps plan 是否承接剩余事项；已承接则链接原任务及真实进度，不重复创建计划。只有尚未承接且范围已确定的新增 follow-up 才进入第 5 节；“仅报告/只复核”只交付报告与后续建议，不调用 dev-plan 创建或修订计划。
+- 输出逐项复审表，沿用来源 ID 并保留上轮报告链接/版本。新一轮默认另存报告，保留历史结论；启用台账时登记独立评审对象并关联前轮，不能用本轮局部通过覆盖前轮未核查范围。
+
+```text
+$review-prd-dev-gaps docs/PRD-login.md goal/LOGIN.md goal/LOGIN-gaps.md，对照 goal/LOGIN.prd-dev-gaps.md 复审修复效果，逐项记录结果。
+```
+
 ## 2. 核实功能实现情况
 
 - 每个在范围内的需求/验收条件都要有覆盖行。一个需求部分满足时拆出未满足条件，不用已实现的主路径掩盖权限、异常、状态反馈或边界行为的缺口。跨里程碑能力检查最终用户旅程，不能只拼接各局部的完成声明。
@@ -71,7 +85,7 @@ description: 接受 PRD 与已完成的开发计划，追读里程碑完成记
 形成一份有来源的 follow-up 清单：未被明确豁免/延期的 A；C 决策要求的补齐或替代实现；B 或接受现状后必要的文档同步、验证补齐。证据缺口只有形成具体、已确定范围的调查/验证任务才纳入，不能包装成未经证实的修复需求。合并同根因任务，保留所有 G-ID/需求关联。
 
 - 已满足、无后续动作的 B、明确豁免或已延期到别期的事项不进入本次实施范围；报告保留理由、去向和重新评估条件。全部无 follow-up 时明确写「无需 gaps plan」，不创建空计划。
-- 清单非空时，**实际定位并读取可用的 `dev-plan/SKILL.md`，按其写计划流程、骨架和校验生成独立 gaps plan**；不止建议用户以后调用，也不在本技能复制一套开发计划模板。缺少该技能时查找可用安装位置；仍找不到则保留报告和交接清单，说明计划生成受阻，不能声称已创建。
+- 先按 G-ID、需求及实际范围核对已有 gaps plan；已承接事项链接原任务，不重复建计划。仍有未承接的已确定增量且用户未限定仅报告时，**实际定位并读取可用的 `dev-plan/SKILL.md`，按其写计划流程、骨架和校验生成独立 gaps plan**；不止建议用户以后调用，也不在本技能复制一套开发计划模板。缺少该技能时查找可用安装位置；仍找不到则保留报告和交接清单，说明计划生成受阻，不能声称已创建。
 - 交给 `dev-plan` 的输入：PRD、原计划及相关记录路径，差异报告、代码基线，选定 G-ID 和 D-ID，已确定目标与验收、排除/延期项、相关代码证据和依赖。原 PRD 提供来源，用户确认的变更提供新目标，当前代码提供起点；不能让下游再次按旧 PRD 推翻已确认决定。
 - 使用 `<原计划名>-gaps` 作为默认代号，输出目录、重名处理和最终状态遵守 `dev-plan`。保留 PRD 需求 ID，并追踪 `需求 → G-ID/D-ID → gaps 任务/里程碑 → 验收`；只规划增量，不重做已完成里程碑，不复制旧计划的完成记录，初始化新计划未开始的进度。
 - 未决 C 不得作为已选方案进入计划。若仍在等回答，先保存报告；独立且已确定的 follow-up 可先成独立范围的计划，显式排除待决项。未决项影响该计划范围或关键依赖时按 `dev-plan` 标 `Blocked`，不能用假设绕过；不得把部分计划说成全部差异已处理。
@@ -82,3 +96,9 @@ description: 接受 PRD 与已完成的开发计划，追读里程碑完成记
 按报告合同保存并回读完整报告，检查：PRD 覆盖无静默漏行，A/B/C 有证据，待核实与待决未伪装成已解决，用户决定已落实到 follow-up，计划只含确认范围且链接真实。结束前核对输入/代码基线是否变化，只复核受影响结论。
 
 最终回复给报告链接、三类差异数量、待核实/待决数量，以及 gaps plan 的实际链接与状态（或无需生成/受阻原因）。报告落盘、用户决策、计划生成分别说明完成情况；有未决/缺证时不宣称整份 PRD 已完整交付。
+
+## 项目状态回写
+
+若仓库已登记状态台账，或存在仓根 `.xgent-ai/sdlc/protocol.md`（兼容已有 `docs/project-status/protocol.md`；两套并存且未登记切换时先核对，不能双写），交付原产物后读取台账的回写规则（默认目录读上述协议），按其格式新增本次事实记录并刷新受影响的状态页与必要索引；未启用时不自动建表，不依赖另装技能。只读/仅聊天/不保存要求优先，登记失败须说明，不影响如实交付已完成的原产物。
+
+登记独立差异核查对象及 PRD/计划关联、版本、待决与 follow-up 去向；复审关联前轮，保留未覆盖 G-ID 及历史结论。新 gaps plan 保持独立对象，关联原计划和差异 ID，不改变原计划的历史完成记录。

package/skills/review-prd-dev-gaps/references/report-contract.md

@@ -7,6 +7,20 @@
 - Triage 前先保存已有核查结果和待决问题；回答到达后在同一报告更新决策和去向，计划交付后补真实链接。恢复会话时先读报告、确认基线与已有决定，避免重复询问。
 - 用户明确仅聊天/不写文件时在聊天中交付完整内容，该限制同时传给 `dev-plan`。工具不能写入或写入失败时说明「未落盘」及原因，保留完整内容和未完成项，不链接不存在的文件。
 
+## 复审记录
+
+复审报告在标题及评审对象之后注明：上轮报告的相对链接与版本、所审对象的前后版本、本轮范围、已有处置记录链接，以及“修复效果复审”或“完整重审”。历史报告与原结论保持不变；默认按本合同另存新报告。
+
+在原报告结构中增加“上轮问题复审”表，与本轮新增问题分开：
+
+| 来源报告 / G-ID或稳定章节 | 上轮问题与结论 | 已有处置 / 修后版本 | 本轮结果 | 当前证据 / 验证 | 剩余动作 |
+| --- | --- | --- | --- | --- | --- |
+
+- 本轮结果统一用：**已解决、仍存在、部分解决、回归、待核实、不再适用、本轮未复核**。已解决需符合原问题的关闭判据；回归需有先前解决及当前再次失败的证据；不再适用须有范围/契约变化依据，不代表实际修复。缺证不能记关闭，未选中的旧项标本轮未复核。
+- 来源身份使用“报告路径/原始版本 + G-ID”，有台账时同时保留评审对象 ID；同一链路沿用旧编号。多份报告的同号问题不合并，新问题分配未占用编号并明确属于本轮；同根因合并时保留来源映射，不重新编号抹掉历史。
+- 默认覆盖上轮全部问题及待核实项；用户限定范围时逐项列出未复核项或其完整 ID 清单。读取处置记录后独立核对实际结果，保留旧证据是否仍适用的理由；只检查修复影响到的必要回归，不自动重跑无关全量验证。
+- 总结分别给出“旧问题解决情况”“修复引入的新问题”“未覆盖/缺证范围”。本轮没有新增 findings 不等于旧问题已关闭；部分通过不扩大成整体通过。复审表结果是检查结论，SDLC 回写仍按仓内协议的固定状态与范围登记，不自造 state 枚举。
+
 ## 报告结构
 
 ### 1. 结论与范围

package/skills/rust/SKILL.md

@@ -1,15 +1,6 @@
 ---
 name: rust
-description: >
-  Guide for writing idiomatic Rust code, based on Apollo GraphQL's best practices handbook plus async patterns for Tokio. Use this skill when:
-  (1) writing new Rust code or functions,
-  (2) reviewing or refactoring existing Rust code,
-  (3) deciding between borrowing vs cloning or ownership patterns,
-  (4) implementing error handling with Result types,
-  (5) optimizing Rust code for performance,
-  (6) writing tests or documentation for Rust projects,
-  (7) writing async Rust with Tokio - tasks, channels, streams, async traits, graceful shutdown,
-  (8) debugging async code: deadlocks, blocked runtimes, cancellation, Send bounds.
+description: Use when writing, reviewing, refactoring, testing or debugging Rust code. Covers ownership, errors, performance and Tokio async patterns.
 license: MIT
 compatibility: Rust 1.70+ (1.75+ for async fn in traits), Cargo
 allowed-tools: Bash(cargo:*) Bash(rustc:*) Bash(rustfmt:*) Bash(clippy:*) Read Write Edit Glob Grep

package/skills/security-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: security-audit
-description: 'AI-powered codebase security scanner that reasons about code like a security researcher — tracing data flows, understanding component interactions, and catching vulnerabilities that pattern-matching tools miss. Use this skill when asked to scan code for security vulnerabilities, find bugs, check for SQL injection, XSS, command injection, exposed API keys, hardcoded secrets, insecure dependencies, access control issues, or any request like "is my code secure?", "review for security issues", "audit this codebase", or "check for vulnerabilities". Also use proactively for a security check of changed code before a commit or deployment — especially changes to auth, API, database, dependency, or config files. Covers the OWASP Top 10: injection flaws, authentication and access control bugs, secrets exposure, weak cryptography, security misconfiguration, insecure dependencies, and business logic issues across JavaScript, TypeScript, Python, Java, PHP, Go, Ruby, and Rust.'
+description: 'Use for code security audits or checks before commits/deployments. Trace data flows to find injection, auth, secrets, dependency, cryptography and business logic vulnerabilities.'
 ---
 
 # Security Review

package/skills/sql-optimization/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: sql-optimization
-description: 'Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance.'
+description: 'Use when tuning SQL queries, indexes or database performance. Analyze execution plans, pagination and batch operations across SQL databases.'
 ---
 
 # SQL Performance Optimization Assistant

package/skills/story-points/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: story-points
-description: 按客观因子表给需求/工单估故事点（斐波那契档位）——因子分四轴：功能点的业务领域、触及的技术栈层、改动的复杂程度、验收的复杂度，与代码库和技术栈无关；并经 SPMS 的 MCP 面完成「读现状 → 判定 → 写回 plannedPoints → 复核 Sprint 容量」的闭环。凡用户要求「估点 / 估算故事点 / 给这条需求打几分 / 给 Sprint 的规划项估点 / 排期前先估一轮 / 复核迭代容量」，或给出一条需求并期望得到一个可复现、有判定依据的点数时，务必使用本 skill——即使用户没说「故事点」三个字。Use whenever the user wants story-point estimation for SPMS requirements/issues, sprint capacity review, or writing planned points back through the PMS MCP tools.
+argument-hint: "<需求/工单key...> [开发计划/技术影响说明] [代码基线] [只估算/写回] [Sprint]"
+description: 用于给 SPMS 需求或工单估故事点、复核 Sprint 容量。按客观因子输出可复现的斐波那契点数与依据；仅在要求时写回 plannedPoints。
 ---
 
 # story-points · 可复现的故事点估算

package/skills/summarize/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: summarize
-description: 把一份素材（SPMS 的需求/开发计划/Issue、一份本地文档、或一个主题）讲成一份人人都读得懂的 HTML 报告，并提交到指定项目的「报告」Tab。凡用户输入 /summarize <素材> --project <项目>，或要求「给这条需求写份解读 / 把这份开发计划总结一下发到项目里 / 出一份报告放到项目报告区」时使用。Use when the user types /summarize <material>, or asks for a readable report to be produced and filed into an SPMS project's Reports tab.
+description: 用于 /summarize 或要求把素材解读、总结成报告并放入 SPMS 指定项目的「报告」Tab。生成易读 HTML，查重后提交；项目不明确时先询问。
 disable-model-invocation: true
 ---
 

package/skills/swarm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: swarm
-description: '组建并指挥一队并行工作的 agent 完成一个任务：选机制（后台 subagent / 动态 workflow / agent team）、选团队模式、设计角色与提示词、确认后编排执行与收尾。凡用户说「创建团队 / 组建团队 / 开个团队做这个 / 团队作战 / 蜂群 / swarm / 多 agent 协作 / parallel agents / spawn teammates / 并行跑几个 agent / 产品团队 / 需求评审团队 / 审计团队 / 一起 review 这个 PR」，或执行 `/swarm`，或交来一个明显需要多人分工的任务（跨层新功能、全库审计、难查的 bug、技术选型辩论、大规模重构迁移、需求设计与澄清评审）时，务必使用本 skill——即使用户没说「团队」两个字。也用于判断「这个任务到底要不要开团队」：很多时候后台 subagent 或动态 workflow 更便宜更快，本 skill 会先做这个判断。'
+description: '用于 /swarm、要求多 agent 协作、判断是否开团队，或明显需多人分工的复杂任务。先选单人、subagent、workflow 或团队机制，再编排角色、执行与验收。'
 ---
 
 # 蜂群 Swarm

package/skills/tdd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tdd
-description: "Use only when the user explicitly asks for TDD, a failing test, or a regression test, OR when the bug has an obvious cheap local test target. Skip when the test path is unclear, expensive, integration-heavy, or not requested."
+description: "Use for requested TDD/regression tests or cheap local bug tests; skip unclear or costly test paths. Reproduce the failure before fixing it."
 disable-model-invocation: true
 ---
 

package/skills/teach/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: teach
-description: "Explain a body of work plainly so a person actually understands it. Runs the `how` and `why` skills and weaves what they find into one clear explanation. Use for 'teach me this', 'help me really understand X', 'explain this change or subsystem to me'."
+description: "Use when asked to teach or explain a change or subsystem in depth. Combine how and why to explain what it does, how it works and why it was designed that way."
 disable-model-invocation: true
 ---
 

package/skills/test-plan/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: test-plan
-description: 由需求（PRD 正文 + 验收标准）成套产出测试用例草稿并写入 SPMS（TC-N，关联需求），覆盖正常路径/边界/权限/并发四类，逐条验收标准给出「标准 → 用例」映射,写入前先查重。凡用户要求「补测试用例 / 写测试用例 / 出测试计划 / 这条需求要怎么测 / 覆盖一下验收标准 / 测试用例够不够」时，务必使用本 skill——即使用户没说「用例」两个字。Use whenever the user wants test cases written, test coverage expanded, or a test plan derived from SPMS requirements and filed as TC-N via the PMS MCP tools.
+argument-hint: "<需求key或PRD> [验收范围] [仅文档/写入SPMS]"
+description: 用于从需求验收标准编写、补齐或检查测试用例及测试计划；产品目标与 UAT 状态定义归 prd。覆盖正常、边界、权限和并发场景，生成标准映射与 SPMS TC 草稿，写入前查重。
 ---
 
 # test-plan · 由验收标准产出成套用例

package/skills/why/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: why
-description: "Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior."
+description: "Use for design rationale, tradeoffs, regressions or postmortems; use how for runtime behavior. Gather evidence and explain why the code took its current shape."
 disable-model-invocation: true
 ---
 

package/skills/working-with-mbx/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: working-with-mbx
-description: Use when installing, activating, or troubleshooting mbx (Mr. Boxington), the shared compiler cache for Cargo - verifies that plain cargo actually goes through mbx, reads hit/miss/bypass summaries, diagnoses low cache reuse, and manages target/cache disk usage
+description: Use when installing, activating or troubleshooting mbx, the shared Cargo compiler cache. Verify Cargo integration, diagnose cache misses and manage disk usage.
 ---
 
 # Working with mbx

package/skills/working-with-mise/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: working-with-mise
-description: Use when adding, configuring, or troubleshooting mise-managed tools - ensures proper CLI usage, detects existing config files, and diagnoses PATH/activation issues when commands aren't found
+description: Use when adding, configuring or troubleshooting mise-managed tools. Detect existing configuration and diagnose PATH or shell activation problems.
 ---
 
 # Working with mise

package/skills/xgent-app-release/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xgent-app-release
-description: '把一个 App 的新版本发布到 XGENT.ai Portal —— 在 App 自己的 repo 里用 xrel_ 发布令牌一条命令提交「前端产物 dist / bump 版本 / 换镜像 / 整份 app.manifest 清单」，落成发布提案：无治理变更自动通过并应用，改权限面的进平台「发布审核」等批准；不登录门户控制台、不找门户运维代传。凡任务涉及发版/发布前端或后端镜像/上传产物/提交或修改 app.manifest.json/首次把 App 接入门户/release-cli/xrel_ 令牌/POST /api/market/release/、配 vite base、在 CI 里写发布步骤、或出现「`npx @xgent/release-cli` 取不到 / E404（它在私有包仓上）」「发布 401 / 404」「发布 200 但 ok:false」「PROPOSAL_PENDING / 一直 pending 等审」「/apps/listingKey/ 白屏或资源 404」「发上去了但线上没变 / 容器没换版」这类症状时，务必先用本 skill 再动手——即使用户只说「发个版」。Use whenever publishing or debugging an XGENT portal app release from the app''s own repo — frontend dist, backend image, or manifest/governance changes via release proposals: release tokens, packaging, version bumps, CI wiring, pending approvals, or a blank/404 /apps/listingKey/ page after a publish.'
+description: '用于从 App 仓库发布或排查 XGENT 门户版本：前端 dist、后端镜像、manifest 或首次接入。通过 release-cli 与发布令牌提交提案，处理 CI、待审及发布后故障。'
 ---
 
 # xgent-app-release · App 版本自助发布

package/skills/xgent-image-push/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: xgent-image-push
-description: 把 App 镜像构建并推送到自建的私有 Harbor 镜像仓库（地址由本地配置提供，不写在这个 skill 里）。用户提到发版、上线新版本、发布镜像、推镜像、docker push、打 tag 推仓库、配 CI 的镜像构建推送步骤、私有镜像仓库、Harbor、robot 账号推不上去、push 卡住推不动、ImagePullBackOff 之前的推送环节，都用这个 skill —— 哪怕他们只说"发个版"或"把这个服务的镜像推上去"没提仓库名字。它在推之前自动预检四条会让流水线静默失败的硬约束（链路、镜像架构、tag 不可变、保留策略），绕过它直接 docker push 很容易踩中其中一条。
+description: 用于 App 发版时构建、推送镜像到私有 Harbor，配置 CI 推送或排查 docker push 失败。仓库地址从本地配置读取；推送前检查链路、架构、tag 与保留策略。
 ---
 
 # 推镜像到私有仓库

package/skills/xgent-init/SKILL.md

@@ -2,7 +2,7 @@
 name: xgent-init
 metadata:
   internal: true
-description: 在 XGENT.ai Portal 出仓 App 自己的仓库里补齐 AGENTS.md / PRODUCT.md / DESIGN.md，保留 Portal 产品边界和设计规范，支持不同 coding agent。用户要求初始化出仓 App 规范、补齐产品或设计上下文时使用；读清单与代码事实，一轮问清缺的信息，已有文件不覆盖。install 本身只直接创建 AGENTS.md。
+description: 用于在 XGENT 出仓 App 仓库初始化或补齐 AGENTS.md、PRODUCT.md、DESIGN.md；已有文件不覆盖。保留 Portal 产品边界与设计规范。
 ---
 
 # xgent-init · 出仓 App 的 Agent、产品与设计上下文