ProjectKuma/arise
2
0
Fork 0
Code Issues 18 Pull requests 1 Projects Releases Packages Wiki Activity

Skill检索侧补齐——inject_skills三级渐进披露（issue #108 Q4） #154

New issue
Closed
opened 2026-08-18 02:54:59 +00:00 by KumaAgent · 1 comment
KumaAgent commented 2026-08-18 02:54:59 +00:00
Member
Copy link

Parent

#108 Q4（issue #108 grill，2026-08-18 拍板：废弃 YAGNI，补检索侧）；ADR 更新见 PR #150

What to build

Skill 三级渐进披露的检索/注入侧——inject_skills 工具 + 三级披露（列表/全文/文件）+ 冷启动从向量
metadata 重建。写入侧（issue #41）已落地（反思周期内模型主动提议技能候选、过人设漂移守护后写进
Qdrant），检索侧此前用 YAGNI 理由延期，本票撤销延期、补齐。

原文（docs/adr/0006-agency-and-drive.md「更新（2026-08-18，issue #108 grill Q4）」节）：

决策：撤销延期，本轮一并补齐检索/注入侧。 inject_skills 工具 + 三级渐进披露（列表/全文/
文件）按 CONTEXT.md「技能（Skill）」条既有设计实现，不需要新设计——07-24 节推迟的只是"要不要做"，
"怎么做"从一开始就写在 CONTEXT.md 里，未曾模糊。

CONTEXT.md「技能（Skill）」条与 design.md 能动性层"技能"条已有完整设计描述（三级渐进披露/按需检索
注入/冷启动重建），实现期直接照此落地，不需要重新设计。

Acceptance criteria

  • inject_skills 工具按 CONTEXT.md「技能」条描述实现：按需检索注入，三级渐进披露（先给列表，
    模型要看某条再展开全文，超长内容转文件）
  • 冷启动从向量 metadata 重建技能列表的机制按 design.md 能动性层"技能"条描述实现
  • mermaid othertool 节点（design.md）对应现状确认无需改动（若实现形状与图示不符，回头更新图示）
  • 补测试：模型请求某条技能时能正确检索到并按三级披露展开；写入侧已有的技能条目现在真的能被
    读到（端到端验证"写了没人读"这个此前的半成品问题已解决）

Not in scope

  • 不改写入侧（issue #41 已落地的部分不动）
  • 不新设计披露策略——CONTEXT.md 已有的三级形状照实现，不要在实现期重新发明
## Parent #108 Q4（issue #108 grill，2026-08-18 拍板：废弃 YAGNI，补检索侧）；ADR 更新见 PR #150 ## What to build Skill 三级渐进披露的检索/注入侧——`inject_skills` 工具 + 三级披露（列表/全文/文件）+ 冷启动从向量 metadata 重建。写入侧（issue #41）已落地（反思周期内模型主动提议技能候选、过人设漂移守护后写进 Qdrant），检索侧此前用 YAGNI 理由延期，本票撤销延期、补齐。 原文（`docs/adr/0006-agency-and-drive.md`「更新（2026-08-18，issue #108 grill Q4）」节）： > **决策：撤销延期，本轮一并补齐检索/注入侧。** `inject_skills` 工具 + 三级渐进披露（列表/全文/ > 文件）按 CONTEXT.md「技能（Skill）」条既有设计实现，不需要新设计——07-24 节推迟的只是"要不要做"， > "怎么做"从一开始就写在 CONTEXT.md 里，未曾模糊。 CONTEXT.md「技能（Skill）」条与 design.md 能动性层"技能"条已有完整设计描述（三级渐进披露/按需检索 注入/冷启动重建），实现期直接照此落地，不需要重新设计。 ## Acceptance criteria - [ ] `inject_skills` 工具按 CONTEXT.md「技能」条描述实现：按需检索注入，三级渐进披露（先给列表， 模型要看某条再展开全文，超长内容转文件） - [ ] 冷启动从向量 metadata 重建技能列表的机制按 design.md 能动性层"技能"条描述实现 - [ ] mermaid `othertool` 节点（design.md）对应现状确认无需改动（若实现形状与图示不符，回头更新图示） - [ ] 补测试：模型请求某条技能时能正确检索到并按三级披露展开；写入侧已有的技能条目现在真的能被 读到（端到端验证"写了没人读"这个此前的半成品问题已解决） ## Not in scope - 不改写入侧（issue #41 已落地的部分不动） - 不新设计披露策略——CONTEXT.md 已有的三级形状照实现，不要在实现期重新发明
KumaAgent commented 2026-08-19 01:39:20 +00:00
Author
Member
Copy link

设计验证（design-verify）核实：本票 AC 明文要求'超长内容转文件'，但仓库目前没有任何 host 发文件能力（CapabilitySet 无文件位、EgressPort 无 send_file、ResourcePort 的 kind 是不含 file 的封闭枚举）——这不是实现期可以自行降级处理的灰色地带，是 AC 与现有基建的真实冲突。

已与用户确认：文件级单独拆到 #163（Skill全文级超长内容转文件——新增host发文件能力），本票收窄到列表+全文两级。本票落地的'全文'级对超长内容会做截断+提示处理，作为#163 落地前的临时行为（#163 的 AC 明确要求'能力未声明时保持本票落地的截断+提示现状不变'，衔接不会冲突）。

设计验证（design-verify）核实：本票 AC 明文要求'超长内容转文件'，但仓库目前没有任何 host 发文件能力（CapabilitySet 无文件位、EgressPort 无 send_file、ResourcePort 的 kind 是不含 file 的封闭枚举）——这不是实现期可以自行降级处理的灰色地带，是 AC 与现有基建的真实冲突。 已与用户确认：文件级单独拆到 #163（Skill全文级超长内容转文件——新增host发文件能力），本票收窄到列表+全文两级。本票落地的'全文'级对超长内容会做截断+提示处理，作为#163 落地前的临时行为（#163 的 AC 明确要求'能力未声明时保持本票落地的截断+提示现状不变'，衔接不会冲突）。
Yushu closed this issue 2026-08-19 03:10:13 +00:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
feat/189-delegate-task-cancellation-shield
No results found.
Labels
Clear labels   
状态：人类就绪
Requires human implementation

  
状态：待拆片
Issue is too large or underspecified — needs to be broken down into smaller child tickets before work can start

  
状态：待评估
Maintainer needs to evaluate this issue

  
状态：忽视
Will not be actioned

  
状态：智能体就绪
Fully specified, ready for an AFK agent

  
状态：等待信息
Waiting on reporter for more information

No labels
状态：人类就绪
状态：待拆片
状态：待评估
状态：忽视
状态：智能体就绪
状态：等待信息
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
ProjectKuma/arise#154
No description provided.