用途:cat-kit-agent-context 是 @cat-kit/agent-context 的文档,说明该 CLI 与 ac-workflow Skill 的安装输出、工作区元数据,供集成 agent-context、同步已安装 Skill、查证 API 时参考。
主要能力与安装:通过 npm add @cat-kit/agent-context 安装,运行环境为 Node.js(CLI / 工具链)。查证 API 时,generated/ 下的 .d.ts 与 npm dist 一致;发布物中的 ESM JavaScript 文件统一使用 .js 后缀,Skill 安装依赖的脚本发布在 dist/skill/scripts/。
Skill 产物约定:agent-context install 生成的 ac-workflow 对齐 Agent Skills 渐进式披露。默认只渲染 .agents/skills/ac-workflow/ 作为 canonical source,--tools 只创建可选兼容入口;兼容入口优先 symlink / junction 到 canonical source,不支持 symlink 或已有普通目录时按 copy fallback 同步。SKILL.md 是短导航入口:一条启动命令(node <SKILL_DIR>/scripts/get-context-info.js,同时完成格式校验)、按状态加用户意图查路由表、再读取协议。完整协议正文位于 references/*.md,确定动作后只读取对应文件。references/ask-user-question.md 含“何时禁止提问”红线与反向追问方法,协议不写死 host 工具名;references/_principles.md 是规划、实施、审查角色的共享专业素养基线,协议内只引用不重复。
状态与校验:上下文状态与编号来自 scripts/get-context-info.js 输出(JSON 加退出码),代理禁止自行扫描目录推断;scripts/validate-context.js 仅在主脚本启动失败时作为独立校验 fallback。description 需要避免普通 coding、code review、planning 或单纯 AGENTS.md 修改误触发。协议末尾的 review 追问使用复杂度阈值触发(影响范围、对外 API、数据库、安全敏感等),不再每次询问;rush 场景下禁止触发强制反向追问,任务若需要反向追问则转走 plan。
CLI 接入点:agent-context context 与 skill-eval 提供 CLI 等价接入点;prompt-gen 默认生成通用模板,个人偏好走 --profile whj。
限制:未提供收费、价格、平台覆盖或效果类信息;更多内容见 references/workspace.md 与 examples.md。