القائمة
何时使用需要为编程项目、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 内容贴回聊天，除非用户要求审阅全文。