菜单
何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
分析代码库结构并生成中文 token-lean 架构文档。
用于构建或维护个人 LLM 驱动的知识库。触发词：将资料导入 wiki、查询 wiki 知识、检查 wiki 质量、'添加到 wiki'、'我了解什么关于'，或任何提到 'LLM wiki' 的场景。
当有书面实施计划要在单独会话中执行并带审查检查点时使用
用户明确要求隔离工作区、并行分支验证或临时试验时使用 - 创建隔离的 git worktree
开始开发编程相关对话时使用 - 建立如何查找和使用 skills，在做出任何响应前要求先检查适用的 skill
更新本项目的上游 submodule，并基于真实 git 变更分析生成文档报告。用于用户要求同步 `upstream/` 下仓库、检查上游最近更新、梳理新增内容、在 `docs/` 写更新说明，或筛选哪些更新值得优先吸收和推荐时。
| name | dev-create-agents-md |
| description | 何时使用需要为编程项目、monorepo 或多级目录创建/更新 AGENTS.md、CLAUDE.md 软链接、项目级 agent 操作手册、子目录局部规则、验证命令和 Coding Agent 上下文边界时使用。 |
为项目生成分层的 agent-readable 操作手册。根目录 AGENTS.md 写全局事实，子目录 AGENTS.md 只写相对父级新增或覆盖的规则；每个同级 CLAUDE.md 必须是指向 AGENTS.md 的软链接，避免多份规则分叉。
AGENTS.md 只记录会改变 agent 行为的稳定事实：目录边界、操作约束、验证命令、风格偏好、禁止事项、示例入口和升级路径。不要写日志、愿景、空泛原则或一次性任务过程。
1. 选目录层级 -> 验证：每个 AGENTS.md 都对应真实边界
2. 读取证据 -> 验证：每条规则能追溯到文件、脚本或用户指令
3. 写 AGENTS.md -> 验证：子目录只写差异，不复制父级
4. 建 CLAUDE.md 软链 -> 验证：readlink 指向 AGENTS.md
5. 复查冗余和命令 -> 验证：规则最小、命令可执行或明确说明未运行
默认只在这些位置创建或更新：
apps/*、packages/*、services/*、libs/*默认跳过：
.git/、node_modules/、.venv/、dist/、build/、coverage/至少检索：
find . -type f \( -name 'AGENTS.md' -o -name 'CLAUDE.md' \)rg --files 或同等文件清单package.json、pyproject.toml、Cargo.toml、go.mod、Makefile、CI workflow 等如果需要通用模板，读取 references/agents-md-pattern.md。不要把模板当事实；模板只提供结构，内容必须来自项目证据。
根目录建议覆盖：
子目录 AGENTS.md 只写：
避免：
每个创建或更新 AGENTS.md 的目录，都创建同级软链接：
uv run python skills/dev-create-agents-md/scripts/link_claude_to_agents.py <dir> [<dir> ...]
脚本会拒绝覆盖已有普通文件或指向其他位置的软链接；如确实要替换，先向用户说明风险，再使用 --force。
完成前检查：
AGENTS.md 内容是否能追溯到真实文件、命令或用户指令CLAUDE.md 是否为相对软链接 AGENTS.md最终回复列出创建/更新的目录、软链状态和验证命令。不要把完整 AGENTS.md 内容贴回聊天，除非用户要求审阅全文。