用途:创建或维护项目根目录的 CONTEXT.md,内容涵盖项目目标、产品边界、非目标、决策原则和领域语言术语表,供未来的人类与智能体阅读,用于指导实现决策。
主要能力:支持三种模式——review(评估现有 CONTEXT.md 并给出改进建议,不覆盖)、extend(保留已有内容,锐化目标、边界与术语表)、start fresh(替换为新文档)。会先检查现有项目上下文(CONTEXT.md、CONTEXT-MAP.md、docs/vision.md、README.md、AGENTS.md、docs/brand-system.md、docs/design-context.md、package.json 及体现产品形态的目录名),文件缺失不报错。若存在旧版 docs/vision.md 但无 CONTEXT.md,可将其内容并入新的根 CONTEXT.md。多上下文 monorepo 可创建根 CONTEXT-MAP.md 指向各包的 CONTEXT.md。
使用方式:调用时声明使用 /arc:vision;先判断适用模式,检查现有上下文,仅在方向不明时一次问一个聚焦问题(Claude Code 中用 AskUserQuestion,其他环境用单条简洁纯文本问题)。默认写入根 CONTEXT.md,结构为标题、简介、Goals、Product Boundary、Principles、Language、Open Questions,通常 500-900 词。完成后询问是否提交,确认后执行:git add CONTEXT.md;test -f CONTEXT-MAP.md && git add CONTEXT-MAP.md;git commit -m "docs: update project context"。
适用场景:项目启动或需要沉淀产品愿景与边界时;下游 Arc 技能(如 /arc:ideate)会读取 CONTEXT.md 获取产品与范围上下文。
限制:需要完整 Arc bundle,Arc 自有路径从插件根目录解析;非交互运行默认使用 Review 模式;不编造业务指标、客户细分、合规要求或承诺时间线;除 CONTEXT.md(及必要时 CONTEXT-MAP.md)外不新增宽泛文档;不静默提交。