YCE Skill

YCE 是面向 AI Agent 的 提示词增强 + 语义代码检索 + 联网检索 + Y-Plan 规划 skill。 当前版本：3.8.1。

License

本项目以 GNU General Public License v3.0（GPL-3.0） 发布。

• 完整文本见仓库根目录 LICENSE
• 你可以自由使用、修改、分发本软件
• 若你分发本软件或其衍生作品，必须同样以 GPL-3.0（或兼容条款）开源，并保留版权与许可声明
• 本软件按“现状”提供，不附带任何明示或暗示担保

YCE Skill
Copyright (C) 2026 YCE contributors

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see .

使用本仓库即表示你知悉并同意遵循 GPL-3.0。
更完整的行为说明与 Agent 调用契约见 SKILL.md。

功能概览

• enhance：把模糊任务整理成可执行提示词；与检索、联网、规划共用 YCE_RELAY_TOKEN
• search：在本地项目内做语义代码定位（远端只做推理，不上传源码建索引）；问题已够具体时优先用这个
• network：外部联网检索（事实依据 / 调研 / 官方文档 / 竞品等），结果在 XML ``
• plan：Y-Plan 结构化规划（只规划不执行），结果在 XML ``；--with-search 可先做代码检索让计划贴合真实代码，支持 BYOK 自定义模型（服务端放行时）。默认开启，可在 .env 设 YCE_ENABLE_PLAN=false，或 bash install.sh --setup --no-plan / .\install.ps1 -Setup -NoPlan 关闭
• auto：增强后在同一次调用内强制收口到 search；无 YCE Key 时跳过 enhance 直接 search（不会自动联网）
• --with-network：由 Agent 判断后，在任意模式上显式附加联网
• 任务锚点：增强产出目标与阶段验收时自动建卡到项目 .yce/tasks/，task show/check/done/new 子命令 + 每次调用复述活跃卡，防止上下文压缩后目标漂移
• BYOK 自备模型：增强与 Y-Plan 均支持请求级自定义模型（YCE_ENHANCE_* / YCE_YPLAN_*），服务端开关放行后生效，密钥不落库

默认经公共 YCE 服务（https://yce.aigy.de）完成鉴权、代码语义检索、联网检索与 Y-Plan 规划；具体请求路径由 skill 内部处理，使用时只需配置 YCE_RELAY_TOKEN 即可。联网是否触发由 Agent 在调用时判断，CLI 不做关键词自动猜测。

快速开始

# 安装到本机 agent skills 目录
bash ./install.sh --install
bash ./install.sh --setup

# 检索（先 cd 到目标项目，或传 --cwd）
node ./scripts/yce.js "Locate the provider list retrieval logic" \
  --mode search \
  --cwd "/absolute/path/to/project"

配置检索密钥（YCE_RELAY_TOKEN）等环境变量，详见 SKILL.md 与 references/modes.md。

结果默认写入文件，stdout 只回一份小收据（），因为长 stdout 会被宿主静默截断、而截断后的文本无法自证。退出码本身就是闸门：`0` 可用，`2` 输出不完整，`3` 完整但没有可用主结果。细节从收据里的 `result_file` 读，文件最后一行是 哨兵，没读到它就说明没读完。任何时候可复核：

node ./scripts/validate-yce-result.mjs ""

仓库内容

构建发布包（可选）

bash ./scripts/build-release.sh

产物在 dist/（不会提交密钥或 .env）。

贡献与分发

• 欢迎提交 Issue / PR
• 分发修改版时请遵守 GPL-3.0：提供对应源码、保留许可证与版权声明
• 不要把含密钥的 .env 提交进版本库

相关项目

• y-plan — 规划 skill，内置 vendored YCE