菜单
根据实际代码和结果反向更新 background 背景知识库。当用户想要：1) 刷新/更新 background 文档 2) 代码已变但文档未同步 3) 执行 /an-refresh 命令 4) 提到"更新背景"、"刷新背景"、"同步文档"、"反推文档"等关键词时触发此技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
将现有工程转换为 AI Native 项目结构。当用户想要：1) 将现有项目转换为 AI Native 格式 2) 为已有代码生成 background/conventions/artifacts 文档 3) 执行 /an-init 命令 4) 让 AI 理解并接管现有项目 时触发此技能。**始终使用中文与用户沟通。**
探测、生成和运行 AI Native 可执行命令清单，包括验证、构建、代码检查、类型检查、代码生成和本地开发命令。用户询问可执行规则、项目命令、验证命令，或 /an-init 后需要让 projects 工程可被 AI 直接运行时使用。
根据输入的任务描述，先智能判断任务复杂度与风险，再选择 L0 直接处理、L1 快速修复、L2 标准开发或 L3 完整流程。适用于开发任务、bug 修复、代码重构、配置修改、文档更新、需求实现等。当用户想要：1) 开始一个开发任务 2) 提供了任务/票据/想法的原始描述 3) 执行 /an-task 命令 4) 提到"开发"、"实现"、"修复"、"添加"等关键词时触发此技能。触发后不要默认套完整流程；小改动可不创建 artifacts，直接实现、验证并总结。
将大任务拆分为多个子任务，每个子任务的 requirements 文档控制在 200 行以内。当用户想要：1) 拆分一个大任务 2) 将任务分解为多个小任务 3) 执行 /an-task-split 命令 4) 提到"任务拆分"、"分解任务"、"大任务"、"拆分"等关键词时触发此技能。
| name | an-refresh |
| description | 根据实际代码和结果反向更新 background 背景知识库。当用户想要：1) 刷新/更新 background 文档 2) 代码已变但文档未同步 3) 执行 /an-refresh 命令 4) 提到"更新背景"、"刷新背景"、"同步文档"、"反推文档"等关键词时触发此技能。 |
根据 projects/ 中的实际代码和 artifacts/ 中的已完成工作，反向更新 background/ 文档。
核心理念：先有结果，后有文档。当代码先行落地，背景知识需要跟上。
满足任一即可触发：
| 场景 | 示例 |
|---|---|
| 显式调用 | 用户执行 /an-refresh |
| 文档过时 | 代码已变更但 background 未同步 |
| 里程碑后 | 完成一个重要功能后需要更新背景 |
| 定期刷新 | 用户主动要求检查并更新 |
扫描 → 差异确认 → 更新 → 确认
目标：扫描代码和文档，识别不一致。
行为：
优先运行结构化扫描脚本：
node .agents/skills/an-refresh/scripts/scan-projects.mjs --root projects --artifacts artifacts --format markdown
需要给后续处理保存 JSON 时：
node .agents/skills/an-refresh/scripts/scan-projects.mjs --root projects --artifacts artifacts --write artifacts/background-scan.json
background/ 下所有文档，了解当前记录的状态projects/ 目录，提取实际信息：
artifacts/ 任务，提取隐含的背景信息：
自动抽取重点：
| 来源 | 抽取内容 | 更新目标 |
|---|---|---|
| 特征文件、依赖和配置 | 技术栈、版本、脚本、依赖 | background/tech/stack.md |
| 对外入口和交互边界 | 功能入口、协议、集成点 | background/features.md、background/domains.md |
| 数据结构和持久化变更 | 数据模型和领域对象 | background/domains.md |
| 测试报告、质量评价报告 | 测试证据和质量状态 | background/features.md |
.agents/recipes.json | 验证、构建、代码生成命令 | conventions/code-style.md 或 background/tech/stack.md |
产出物：向用户展示扫描发现，格式如下：
📋 扫描结果
已检查的 background 文档：
- background/product/overview.md
- background/tech/stack.md
- ...
发现的差异：
1. [stack.md] 技术栈记录与实际不一致
2. [overview.md] 缺少已上线功能模块
3. [structure.md] 新增目录未记录
需要新增的文档：
- background/domains.md（当前不存在，但代码中已出现明显的领域模型）
无需更新的文档：
- background/tech/code-style.md（与实际一致）
目标：与用户确认哪些差异需要更新。
行为：
| 类别 | 说明 | 默认 |
|---|---|---|
| 必须更新 | 版本不匹配、缺失的模块 | 建议更新 |
| 建议更新 | 可能有用的上下文补充 | 询问用户 |
| 可选更新 | 细节优化、措辞改进 | 跳过 |
检查点：等待用户确认哪些差异需要更新。
目标：按确认的范围更新 background 文档。
行为：
an-init 中定义的格式创建## 更新记录
| 日期 | 更新内容 | 触发来源 |
|------|---------|---------|
| YYYY-MM-DD | {变更摘要} | {an-refresh / 用户指令} |
产出物：更新后的 background/ 文档。
目标：展示更新结果，确保一致性。
行为：
✅ 背景知识库已刷新
更新文件：
- background/tech/stack.md（更新技术栈和依赖摘要）
- background/product/overview.md（补充功能模块描述）
新增文件：
- background/domains.md（从代码中提取领域模型）
未变更：
- background/tech/code-style.md
conventions/ 下的规范文件| 范围 | 说明 | 涉及文件 |
|---|---|---|
| tech | 技术栈、依赖版本、工具链 | background/tech/stack.md |
| product | 产品功能、模块描述 | background/product/overview.md |
| domains | 领域模型、业务规则 | background/domains.md |
| structure | 目录结构规范 | conventions/structure.md |
| code-style | 代码风格 | conventions/code-style.md |
| features | 功能状态追踪 | background/features.md |
| all | 全部检查 | 以上所有 |
用户可通过参数指定范围：/an-refresh tech 只刷新技术栈相关。
⚠️ 待确认| 情况 | 处理 |
|---|---|
| background/ 为空 | 提示用户先执行 /an-init |
| projects/ 代码无法解析 | 跳过自动分析，提示用户手动提供信息 |
| 文档与代码冲突 | 以代码为准，但标记差异让用户确认 |
| 用户只想部分更新 | 按指定范围执行，跳过其他 |