用途:面向独立 Agent Skill 文件夹(SKILL.md 加可选 references、scripts、assets)进行查找、比较、评分、评审、创建、改进、修复、安装和同步。流程为 UNDERSTAND→DISCOVER→INSPECT→JUDE→RECOMMEND→USER GATE→ACT→CLEANUP→REVIEW→VERIFY。
主要能力与用法:按 Smart routes 按需加载参考文件。发现阶段加载 references/search-playbook.md、references/discovery-surfaces.md、references/discovery-manifests.md、references/recovery.md;判断阶段加载 references/quality-rubric.md 与 references/quality-signals.md;推荐阶段通过 references/output-format.md 呈现。设计结构加载 references/skill-anatomy.md、skill-authoring.md、skill-scripts.md、description-tuning.md;改进加载 skill-improve.md、self-improvement.md、skill-cleanup.md、improve-loop.md;完成前加载 skill-review.md 与 skill-review-rules.md。安装加载 install-gates.md、install-destinations.md,远程源用 fetch-remote.md,本地创建用 create-local-skill.md,同步用 skill-sync.md。代码研究委派给 references/octocode.md;来源追踪用 references/references.md 与 references-template.md。
脚本与关卡:创建或编辑后运行 scripts/skill-review.mjs,要求零 ERROR;scripts/skill-lint.mjs 是其同义别名。scripts/skill-sync.mjs 仅在干跑并获得人工批准后运行。需要 Octocode home 或 env 的技能脚本相对导入 ./octocode-config.mjs(由 packages/octocode-config 注入的构建产物),不得从技能中导入 @octocodeai/config。接线 hook 时将 assets/hooks/example-hook.sh 复制到 scripts/hooks/ 并从 frontmatter 路由。
相关路由:用 octocode-research 验证候选,octocode-prompt-optimizer 改进措辞,octocode-graph-eval 衡量行为,大型技能系统重构前用 octocode-rfc-generator。
限制与规则:SKILL.md 负责工作流、硬性关卡和路由,每个 reference 只负责一个概念且不重述流程;lobby 需列出所有 reference、script 及工作流。引用、判断或安装前必须查看真实 SKILL.md,按路径识别候选并每次写入都设关卡。达到明确匹配、两个 High 候选需择一、三个角度无增益或等待用户/授权批准时应停止。交付独立文件夹,每概念一个负责人,完成后剪除死代码或重复内容。假设未安装同级技能,只能命名加载而不能依赖其文件。安装与写入前需获批准、确认目标与来源,安装后运行 review 再报告完成。具体定价、平台支持范围等资料暂未提供。