用途:创建、修复、拆分或协调仓库中的 AGENTS.md,让编码智能体获得简短、具体、可验证的项目指令;当用户明确要求或本地约定需要时,可额外生成 CLAUDE.md 伴随文件,但不重复共享规则。
主要能力:从仓库证据(现有指令、目录结构、清单文件、锁文件、任务定义、CI 与代表性源码/测试)推导命令、路径、架构、约定与限制;区分根级契约与仅在子树确有差异时使用的嵌套 AGENTS.md;保持根指令简短、项目特定、无冲突且可验证;标注不确定事实而非虚构。输出语言默认由用户指定,未指定时沿用仓库既有指令语言,否则默认韩语,代码标识符、命令、路径等保留原语言。
使用方式:先按 create、refactor、split、reconcile 分类并列出目标文件与排除项,再建立证据映射、设计根/嵌套边界,随后仅起草能映射到仓库证据的最小指令集。使用前依次阅读 rules/project-discovery.md、rules/instruction-design.md、rules/validation.md;修改此技能行为时检查 assets/evals/agentmd-maker-cases.jsonl 并保留既有用例、补充回归。
限制:不修改产品代码、清单、CI 或无关文档;不因“可能有用”就创建 CLAUDE.md、嵌套指令或运行时文件;网络、凭据、发布、部署、破坏性与生产操作均需显式授权;无法读取仓库文件时应请求最小必要项目树并阻止依赖未见内容的结论;若无编辑能力则返回补丁且不声称已应用;验证-修复循环最多 2 轮,关键检查未过则阻止交付。此技能包可用 node skills/skill-tester/scripts/validate-skills-corpus.mjs --root skills --only agentmd-maker --json 执行验证。