用途:为自动接收 AGENTS.md 的智能体编写简短、持久的指令文件。该技能只负责撰写指南,不实现应用,也不执行其质量保证。
主要能力:依据准入规则筛选语句——受众(进入该目录的每个智能体都必须知道,根目录指整个仓库,嵌套指整个子树)、价值(能改变智能体本会做错的决策)、稳定性(长期约定或不变量,而非会话观察、版本、任务状态或临时变通)。提供 Web 与桌面两套规范模板,支持根目录与嵌套范围。
使用方式:先选定 Web 或桌面工作流并复制对应模板,再适配。使用内置 Python 3.9+ 标准库辅助脚本: python <skill-directory>/scripts/copy_template.py --workflow web --project-root <project-root> --candidate python <skill-directory>/scripts/copy_template.py --workflow desktop --project-root <project-root> --scope <existing-relative-subfolder> --candidate 脚本始终暂存 AGENTS.md.candidate,拒绝覆盖与项目外目标,验证字节并打印 SHA-256 凭证。始终使用 --candidate,在候选文件上适配,审查差异且无占位符后,以拒绝覆盖的方式发布,或经审阅编辑协调既有指南。
限制与约束:不要把标准布局、依赖版本、清单依赖、Git 教程、指令加载解释、特性迁移计划、未请求的 PRD/ADR 或不存在的技能写入。根目录目标 200–400 词,嵌套 40–120 词。保留七步 TDD 与测试分层定义;E2E 与手动 QA 使用零 mock 的完整应用。缺失访问或预算会阻断必需的真实检查,不得伪造通过。若模板无法读取或复制,应报告阻塞,不得编造近似内容。未提供具体项目事实时不得杜撰。