AI SDD 开发规范-21-将 Skills 集成到你的智能体
将 Skills 集成到你的智能体
(Integrate skills into your agent)
本指南说明如何向你的 AI 智能体或开发工具添加 Agent Skills 支持。([代理技能][1])
集成方法(Integration approaches)
集成 Skills 有两种主要方式:
基于文件系统的智能体(Filesystem-based ...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-21-Agent Skills 规范
Agent Skills 规范
以下定义了 Agent Skills(智能体技能) 的完整格式规范。(代理技能)
目录结构
一个 Skill 必须是一个目录,该目录至少包含一个 SKILL.md 文件:
skill-name/
└── SKILL.md # 必需
你也可以选择在技能目录下包含额外的支持性子目录,例如:
scripts/
refer...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-21-AGENT SKILLS
什么是 Skills?
Agent Skills(智能体技能) 是一种轻量级、开放格式,用于通过专业知识和工作流来扩展 AI 智能体能力。
从本质上讲,一个 skill 就是一个包含 SKILL.md 文件的文件夹。
该文件至少包含元数据(名称和描述)以及指导智能体如何执行特定任务的指令。
Skills 还可以捆绑脚本、模板和参考资料。
my-skill/
├── SKILL.md ...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-20-设计文档模板 design
DESIGN.md(AI 可执行版)
文件定位:本次需求 / 变更的唯一实现依据(Single Source of Truth)
主要受众:AI 编程工具 + 人类 Reviewer
核心目标:将人类的设计意图,翻译为无歧义、可校验、可执行的实现说明。
0. 设计使用声明(必读)
本文档描述的是:“这一次要怎么改”,而不是项目长期设计
AI 只能依据本文档 + G...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-19-PROJECT_PROFILE.md
PROJECT_PROFILE.md
文件定位:项目语义与历史背景的权威说明文档
主要受众:首次参与本项目的 AI 与人类开发者
核心目标:用尽量少但稳定的信息,帮助 AI 与新成员快速建立对项目“是什么、为什么这样、哪里不能动”的整体认知。
1. 项目一句话说明(TL;DR)
用一句话回答:这个项目是做什么的,解决什么核心问题。
示例:
本项目是一个面向...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-18-可直接落地使用的《GEMINI.md 标准模板(历史项目)》
GEMINI.md
文件定位:AI 编程行为与工程规范的最高约束文件
适用对象:所有参与本项目代码生成、修改、重构的 AI 工具(如 Gemini CLI / Claude / Copilot 等)
优先级说明:当本文件内容与任何自然语言指令、临时提示、代码注释冲突时,以本文件为准。
0. 使用声明(必读)
你正在参与的是一个存在历史包袱的生产级项目,该项目对:
稳...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-16-AI 协作开发规范(历史项目版)
AI 协作开发规范(历史项目版)
1. 文档目标与适用范围
本规范用于历史项目 / 有技术债项目中,引导人类开发者与 AI 编程工具(如 Gemini CLI、Claude Code、Copilot 等)进行可控、可复现、可审计的协作开发。
目标不是最大化代码生成速度,而是:
降低 AI 输出的不确定性
避免对历史系统造成结构性破坏
提升 AI 在复杂上下文下的实现准确...
2025-11-20 06:12:33 |
AI
AI SDD 开发规范-16-GEMINI RULES+研发设计文档+project profile 的思路点评
chat
Q
历史项目中,我现在的 ai 编程思路是,通过 GEMINI.md 约束对应编程规范,PROJECT_PROFILE.md 生成项目介绍,协助 ai 理解 + 人做详细设计,从而提升AI编程准确率。你如何评价这种模式,中肯、建设性
A
你的这套模式,整体方向是非常成熟且工程化的,在当前 AI 编程能力边界下,属于“少数真正能在复杂历史项目中跑得通”的方法之一。下面我从客...
2025-11-20 06:12:33 |
AI