adk-external-practice-absorption

Goal

• 用一个受治理流程评估多来源实践，避免按 provider 复制 Agent、Skill 和安全逻辑。
• 把“发现值得研究”与“批准吸收、实现、发布”分开，形成可追溯闭环。
• 只吸收可验证的通用增益；平台专属事实、版权内容和低质量增量留在 reference/observe 边界。

Boundary

• Intake 控制面只生成候选、queue、evidence 和非约束性资产形态建议。
• external-practice-curator 只读分析；不得批准、实现或发布自己筛选的候选。
• owner decision 必须独立记录 ADOPT|MERGE|ENHANCE|OBSERVE|REJECT、负责人、日期、理由、目标和证据。
• ADOPT|MERGE|ENHANCE 只授权创建 change proposal，不自动授权网络写入、安装、commit、push、publish 或 source-to-live apply。

Prerequisites

• 至少提供一个可核验的 candidate ledger、cycle evidence、不可变来源 revision/hash 或等价脱敏证据；仅有未经核验的正文摘要时停在 needs-fix。
• 在进入实现前必须存在独立 owner decision，并明确目标资产、非目标、breaking boundary、验证、回退和退役条件。
• 涉及网络、connector、凭证或外部写入时，必须先声明 transport、allowlist、预算、日志脱敏和 deny-path；本 Skill 本身不扩展这些权限。

Workflow

1. 固定 source URL、provider、retrieved/expiry、revision/hash、transport 和权限边界。
2. 将输入归一到 external-practice-candidate/v1；拒绝旧 schema、正文持久化、auto action 和不安全 URL。
3. 分别检查 authority、freshness、duplicate、license/copyright、prompt injection、security、architecture fit 与可验证增益。
4. 记录“可借鉴优点”和“不可迁移缺点”；不得以 star、来源权威或资产数量替代判断。
5. 由独立 owner 作 decision；缺字段或 curator 自批时固定 needs-fix。
6. 对批准项先查现有 Agent/Skill/Workflow/manifest/runbook，优先 MERGE 或 ENHANCE，只有职责确实独立才 ADOPT。
7. 创建 ADK change artifact，明确目标、非目标、breaking change、安装范围、依赖、tests、pilot、回退和退役条件。
8. 交给正常实现与验证角色；curator 只提供 evidence handoff，不参与自证。
9. 通过定向/全量验证和真实或明确标注的 pilot 后，才进入显式发布/source-to-live 流程。
10. 到期、重复、无增益、冲突或长期无使用证据时，触发 review/retire；不保留无主兼容层。

Source Rules

• GitHub/GitLab/Gitee：只读 repository metadata；没有 commit snapshot、license/security review 时不得复制代码。
• Gitee 搜索空列表：标记 degraded-empty，不得声明“没有候选”或 source clean。
• OpenAI/Codex、Anthropic/Claude 官方：提高事实 authority，不自动提高 adoption decision；平台专属行为不得伪装成 ADK 通用 core。
• 微信公众号：只消费 metadata catalog；body_persisted 必须为 false，不绕过登录、CAPTCHA 或 anti-spider。
• 人工 URL：只进入 unverified/manual queue，必须通过 allowlist 与独立复核。

Asset Shape Decision

形态	仅在以下条件成立时选择
Agent	存在独立职责、权限和 handoff，且不能由 Skill/Workflow 表达
Skill	有稳定触发、可复用专业流程和明确 non-trigger
Workflow	多阶段状态、人工 gate 或跨角色 handoff 是核心价值
Script	重复、确定性、低自由度的机械操作需要可靠执行
Manifest	主要价值是声明式合同、allowlist、状态或治理策略
Runbook	主要价值是人工操作、故障处理或生命周期说明
Observe	增益、授权、适配或效果证据不足

Required Artifacts

• candidate ledger 与 cycle evidence；原始正文、token、cache 不归档。
• duplicate/architecture/license/security review 和 negative results。
• owner decision ledger；curator 不得成为批准 owner。
• ADK proposal/design/tasks/checklist、Prompt before/after、tests、pilot 和 review report。
• 发布后的效果复审日期、owner、rollback/retirement 条件。

Commands

# llm_agent 中仅生成 report-only 证据
rtk scripts/practice-intake.sh check --kind candidate --input <candidate-ledger>
rtk scripts/practice-intake.sh check --kind decision --input <decision-ledger>

# 已批准后才创建并推进 ADK change
rtk bash scripts/devkit.sh propose --change <id> --title "<目标>"
rtk bash scripts/devkit.sh validate --strict
rtk bash tests/run_all.sh --fail-fast

Failure Handling

• provider error、空 Gitee、过期官方来源或不完整字段：保留 degraded/negative evidence，禁止补猜。
• license/版权不明：默认 OBSERVE 或 REJECT，除非 owner 给出可审查依据。
• 与现有资产重叠：优先 MERGE|ENHANCE；若仍要新增，必须解释职责差异和退役旧资产计划。
• 缺少真实 pilot：不得用 fixture 冒充运行效果；结论只能是未验证或 report-only。
• change 验证失败：回到 design/tasks 修正；禁止用兼容 wrapper、双写或跳过门禁掩盖失败。

Quality Gate

• source、decision、implementation、verification、pilot、publish、review/retire 七段证据可追溯。
• collector/curator/owner/implementer/verifier 权限分离，至少 owner 与 curator 不是同一自动角色。
• 结论同时说明吸收价值、不可迁移缺点、目标层、依赖、性能/安全/维护成本和剩余风险。
• 完成声明必须经 adk-verification-before-completion，独立 review 的 blocker 与 major 均为 0。