Feat/copilot

.copilot/profiles.json

@@ -0,0 +1,23 @@
+{
+    "profiles": {
+        "dev": {
+            "model": "gpt-5",
+            "reasoningEffort": "medium",
+            "workingDirectory": ".",
+            "skillDirs": [
+                "./skills",
+                "./.copilot/skills"
+            ],
+            "disabledSkills": [],
+            "availableTools": [],
+            "excludedTools": [],
+            "mcpServersJSON": "",
+            "customAgentsJSON": "",
+            "agent": "",
+            "customToolsJSON": "",
+            "streaming": false,
+            "enableDemoEchoTool": false,
+            "enableInfiniteSession": true
+        }
+    }
+}

.copilot/skills/README.md

@@ -0,0 +1,15 @@
+# Local Copilot Skills
+
+这个目录用于存放仅本仓库使用的 Copilot Skills。
+
+建议每个技能单独目录，文件名使用 `SKILL.md`。
+
+建议模板：
+
+- frontmatter：`name`、`description`、`argument-hint`、`metadata`
+- 正文：`目标`、`执行步骤`、`约束`、`输出契约`
+
+说明：
+
+- `metadata` 中可扩展 `summary/version/tags/use_when/tools`。
+- 顶层 frontmatter 请使用受支持字段，避免解析报错。

.copilot/skills/generic-sample/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: generic-sample
+description: "Use when: 需要通用问题处理模板（分析、实现、验证）时。"
+"argument-hint": "输入任务目标、约束、涉及模块与预期输出。"
+metadata:
+  summary: "通用执行技能模板，强调最小变更、可验证与明确输出。"
+  version: "1.0.0"
+  tags: ["template", "execution", "copilot"]
+  use_when:
+    - "任务尚未有专用 skill"
+    - "需要统一的分析-实现-验证流程"
+  tools: ["semantic_search", "grep_search", "read_file", "get_errors", "runTests"]
+---
+
+# Generic Execution Template
+
+## 目标
+- 将自然语言需求转为可执行、可验证的改动。
+
+## 执行步骤
+1. 明确目标与边界（输入/输出/约束/非目标）。
+2. 收集代码证据（入口、实现点、测试点）。
+3. 制定最小改动计划并分步实施。
+4. 每步改动后执行检查与测试。
+5. 输出结果、风险和后续建议。
+
+## 约束
+- 不编造事实，不省略关键假设。
+- 避免一次性大改；优先小步可回归。
+- 涉及接口变更时说明兼容策略。
+
+## 输出契约
+- 变更摘要（文件 + 目的）
+- 验证结果（测试/检查）
+- 已知风险与后续动作

.github/instructions/changelog.instructions.md

@@ -0,0 +1,35 @@
+---
+name: Changelog 专项规范
+description: 仅用于维护 .version/changelog，保证 Unreleased 与版本文件结构稳定、分类一致、条目可追溯
+applyTo: ".version/changelog/*.md"
+---
+
+# Changelog 维护规范
+
+本规则仅适用于 `.version/changelog/*.md`。
+
+## 结构约束
+
+- `Unreleased.md` 推荐分类：`新增` / `修复` / `变更` / `文档`。
+- 若某分类暂无内容，写“暂无”。
+
+## 内容约束
+
+- 仅基于可见改动编写条目，不杜撰能力或影响。
+- 单条应简洁、可读、可追溯，以动词开头。
+- 重复事项需合并去重，避免同义重复。
+- 非标准分类（如 `优化`、`重构`）必须归入标准四类（通常归 `变更`）。
+- 不改写历史版本文件语义，不重排已发布版本。
+
+## 落版约束（release）
+
+- 版本号来源于 `.version/VERSION`。
+- 落版文件：`.version/changelog/<VERSION>.md`。
+- 文件头格式：`# [<VERSION>] - <YYYY-MM-DD>`。
+- 落版前检查版本文件是否已存在，已存在时提示用户确认。
+- 落版后重建 `.version/changelog/Unreleased.md` 模板（四个分类）。
+- 落版后同步更新 `.version/changelog/README.md` 索引。
+
+## 协同建议
+
+- 建议通过 agent 提示词执行：`/changelog draft|release`。

.github/instructions/documentation.instructions.md

@@ -0,0 +1,36 @@
+---
+name: 文档专项规范
+description: 适用于仓库文档写作与维护（README/docs/example/internal），确保中文技术文风、结构一致、变更可追溯
+applyTo: "**/*.md"
+---
+
+# 仓库文档专项规范
+
+仅在“项目文档内容”场景生效（如 `README.md`、`docs/**`、`example/**/README.md`、`internal/**/README.md`）。
+
+## 基本要求
+
+- 默认使用中文技术文风，表达简洁、可执行、可复现。
+- 结构化写作：优先使用二级/三级标题与短列表，避免大段空泛描述。
+- 流程、架构、关系图优先使用 Mermaid。
+- 避免复制粘贴同一段说明到多个文档；优先“引用索引文档”或“链接到单一事实来源”。
+
+## 仓库约定（必须遵循）
+
+- 如果当前仓库存在 `docs/INDEX.md`，新增文档时需补充索引关系（如适用）。
+- 涉及架构或流程变化时，先更新 `docs/DESIGN.md`（如存在），再补示例/说明文档。
+- 行为变更需同步 `.version/changelog/Unreleased.md`；必要时同步其他评估或使用文档。
+- 术语需与当前仓库现有命名保持一致，不擅自发明新概念。
+
+## 写作与更新策略
+
+- 面向“当前仓库真实实现”写作，不杜撰未实现能力。
+- 描述命令时优先使用仓库中已存在的命令名与任务名。
+- 变更文档时说明“改了什么、为什么改、影响范围”。
+- 若仅做措辞润色，不应改动技术语义与行为结论。
+
+## Changelog 联动
+
+- 如涉及行为变化，建议同步更新 `.version/changelog/Unreleased.md`。
+- 建议通过相关 prompt 执行 changelog 维护。
+

.github/instructions/release.instructions.md

@@ -0,0 +1,25 @@
+---
+name: 发布前变更核对约束
+description: "Use when preparing a release or completing behavior-impacting changes, including changelog updates and release regression checks."
+---
+
+# 发布前核对规则
+
+用于“准备发布”或“完成具备行为影响的改动”时的统一核对。
+
+## 发布前检查清单
+
+- 变更说明已写入 `.version/changelog/Unreleased.md`，分类正确（新增/修复/变更/文档）。
+- 用户可见行为变化，已同步示例或说明文档。
+
+## 质量门槛
+
+- 执行完整回归测试并确认通过。
+- 仅基于真实改动与真实测试结果编写发布说明，不杜撰。
+
+## 落版流程
+
+- 首选通过 `fastgit changelog release` 或等效 agent prompt 执行。
+- 版本号来源于 `.version/VERSION`；若版本文件已存在，需确认是否递增。
+- 落版后重建 `Unreleased` 模板并更新 changelog 索引。
+- changelog 结构与落版细节以 `.github/instructions/changelog.instructions.md` 为准。

.github/prompts/changelog.prompt.md

@@ -0,0 +1,59 @@
+---
+name: changelog
+description: 维护 .version/changelog（更新 Unreleased 或执行版本落版）
+argument-hint: "模式：draft（更新 Unreleased）或 release（按 .version/VERSION 落版）"
+agent: agent
+---
+
+你是当前仓库的 Changelog 维护助手。
+
+## 目标
+
+- `draft` 模式：根据当前改动更新 `.version/changelog/Unreleased.md`。
+- `release` 模式：将 `Unreleased.md` 落版为版本文件，并重建空模板。
+
+## 必读上下文
+
+在开始前先读取：
+
+- `.version/changelog/Unreleased.md`
+- `.version/VERSION`
+
+## 通用规则
+
+1. 只基于可见改动生成条目，不杜撰。
+2. **标准分类**：`新增` / `修复` / `变更` / `文档`。
+   - 非标准分类（如 `优化`、`重构`）必须归入上述四类（通常归 `变更`）。
+3. 语言使用中文技术文风，单条以动词开头，简洁可追溯。
+4. 去重：同类项合并，避免语义重复。
+5. 不改写历史版本文件语义与顺序。
+
+## draft 模式
+
+1. 获取工作区 diff：运行 `git diff <base> --stat` 和 `git diff <base> --name-only` 确认改动范围。
+2. 仅更新 `.version/changelog/Unreleased.md`。
+3. 若缺少分类小节则补齐；无内容的小节写“暂无”。
+4. 归类规则：
+   - feat / 新增能力 → `新增`
+   - fix / bug 修正 → `修复`
+   - 重构、依赖迁移、行为调整、优化 → `变更`
+   - README、docs、注释更新 → `文档`
+
+## release 模式
+
+1. 读取 `.version/VERSION` 获取目标版本号（如 `v0.3.0`）。
+2. **版本冲突检查**：若 `.version/changelog/<VERSION>.md` 已存在，提示用户确认是否需要递增版本号，不自行覆盖。
+3. 创建版本文件 `.version/changelog/<VERSION>.md`：
+   - 标题格式：`# [<VERSION>] - <YYYY-MM-DD>`。
+   - 将 `Unreleased.md` 的内容迁移过去（分类统一为标准四类）。
+4. 重建 `Unreleased.md` 空模板（四个分类均写“暂无”）。
+5. 更新 `.version/changelog/README.md` 索引：在列表顶部（`Unreleased` 之后）插入新版本链接。
+6. 更新 `.version/VERSION` 为下一个预期版本号（**仅在用户确认后**，否则保持当前值）。
+
+## 输出要求
+
+- 直接给出文件修改结果。
+- 末尾附一段简短自检：
+  - 是否仅改动 `.version/` 范围内的文件；
+  - 分类是否统一为标准四类，是否完成去重；
+  - 历史版本文件是否未被修改。