用途:让智能体编码过程中的规格文档保持鲜活。它把会话中学到的内容与仓库内的意图文档进行对比,在写入任何内容前提出最小且安全的更新建议。
主要能力:仅针对仓库内的意图文档;除非用户明确要求自动更新,否则写入文件前需用户批准;事实、推断与建议必须分别标注;生命周期更新以新的原始条目记录,不修改旧条目。
输入:当前对话或会话摘要;存在 vault 时的相关原始条目与召回上下文;候选意图文档,通过命令 python <this-skill>/scripts/intent_targets.py --cwd "$PWD" 获取。
写入前输出:返回简洁提案,包含 Intent Sync Proposal、Mismatches(分别标注 Fact、Inference、Recommendation)、Proposed File Updates(如 DESIGN.md、AGENTS.md)以及 Minimal Diff Draft。
生命周期信号:开放问题转为已答复或提升为决策;风险转为已缓解或已接受;决策转为修订或被取代。不要重写请求范围之外的文件。若证据不足以更新文档,应说明并保持文档不变。
已批准写入模式:用户批准特定更新后,仅编辑获批的目标文件;当 vault 可用且变更具有未来路线图价值时,追加原始 decision 或 risk 条目;若更新了持久化文档且存在文档索引,则更新或添加索引条目。
证据规则:事实必须引用原始条目、当前文件或用户提供的会话上下文;推断必须使用模糊措辞;建议必须表述为拟议变更而非既定事实;缺少 vault 数据可以接受,此时仅使用对话与仓库文件。
限制:仅限仓库内意图文档;写入需用户批准;证据不足时不更新文档。其他收费、平台等信息暂未提供。