93d1b21的任务收尾
This commit is contained in:
@@ -146,9 +146,34 @@ aide flow next-part impl "流程设计完成，开始实现"
|
||||
aide flow back-part <环节名> "<原因>"
|
||||
```
|
||||
|
||||
**注意**：执行 back-part 时会生成一个确认 key，需要先完成准备工作后执行 back-confirm 确认。
|
||||
|
||||
**示例**：
|
||||
```bash
|
||||
aide flow back-part flow-design "实现中发现设计遗漏，需要补充"
|
||||
# 输出: ⚠ 返工需要确认。请先完成准备工作，然后执行:
|
||||
# aide flow back-confirm --key abc123
|
||||
```
|
||||
|
||||
### aide flow back-confirm
|
||||
|
||||
确认返工请求并执行。
|
||||
|
||||
```bash
|
||||
aide flow back-confirm --key <key>
|
||||
```
|
||||
|
||||
**参数**：
|
||||
|
||||
| 参数 | 说明 |
|
||||
|------|------|
|
||||
| `--key` | back-part 生成的确认 key |
|
||||
|
||||
**示例**：
|
||||
```bash
|
||||
aide flow back-confirm --key abc123
|
||||
# 输出: ⚠ 回退到环节: flow-design
|
||||
# ⚠ 建议执行 /exit 重新开始对话
|
||||
```
|
||||
|
||||
### aide flow issue
|
||||
|
||||
106
aide-marketplace/aide-plugin/skills/readme-templates/SKILL.md
Normal file
106
aide-marketplace/aide-plugin/skills/readme-templates/SKILL.md
Normal file
@@ -0,0 +1,106 @@
|
||||
---
|
||||
name: readme-templates
|
||||
description: README 模板集。提供多种项目类型的 README 模板和可选模块，供 /aide:readme 命令使用。当需要生成或更新项目 README 时使用。
|
||||
---
|
||||
|
||||
# README 模板集
|
||||
|
||||
本 skill 提供一套完整的 README 模板体系，包含多种项目类型模板和可组合的功能模块。
|
||||
|
||||
## 模板选择指南
|
||||
|
||||
根据项目类型选择合适的基础模板：
|
||||
|
||||
| 项目类型 | 推荐模板 | 特点 |
|
||||
|----------|----------|------|
|
||||
| 小工具/脚本 | `minimal.md` | 精简，核心信息 |
|
||||
| 库/SDK | `library.md` | 安装、API、示例 |
|
||||
| 应用程序 | `application.md` | 功能、安装、配置 |
|
||||
| 文档/教程 | `documentation.md` | 结构清晰、导航便捷 |
|
||||
| 多项目仓库 | `monorepo.md` | 子项目索引、统一说明 |
|
||||
|
||||
## 模板结构
|
||||
|
||||
### templates/ - 完整模板
|
||||
|
||||
每个模板都是独立完整的 README 结构，包含该类型项目最常用的章节。
|
||||
|
||||
### modules/ - 可选模块
|
||||
|
||||
模块是可自由组合的内容块，用于扩展或定制 README：
|
||||
|
||||
| 模块 | 用途 | 推荐场景 |
|
||||
|------|------|----------|
|
||||
| `quickstart` | 5分钟上手 | 希望用户快速体验 |
|
||||
| `installation` | 详细安装 | 有多种安装方式 |
|
||||
| `examples` | 代码示例 | API 或工具类项目 |
|
||||
| `api` | 接口文档 | 库/SDK 项目 |
|
||||
| `configuration` | 配置说明 | 有配置文件的项目 |
|
||||
| `architecture` | 架构概述 | 复杂系统 |
|
||||
| `contributing` | 贡献指南 | 开源项目 |
|
||||
| `changelog` | 变更日志 | 需要版本追踪 |
|
||||
| `license` | 许可证 | 所有公开项目 |
|
||||
| `faq` | 常见问题 | 用户问题较多 |
|
||||
|
||||
## 推荐组合
|
||||
|
||||
### 开源库项目
|
||||
|
||||
```
|
||||
模板: library.md
|
||||
模块: + quickstart + examples + api + contributing + license
|
||||
```
|
||||
|
||||
### 内部工具项目
|
||||
|
||||
```
|
||||
模板: application.md
|
||||
模块: + installation + configuration + faq
|
||||
```
|
||||
|
||||
### 文档项目
|
||||
|
||||
```
|
||||
模板: documentation.md
|
||||
模块: + contributing
|
||||
```
|
||||
|
||||
### 微型脚本
|
||||
|
||||
```
|
||||
模板: minimal.md
|
||||
模块: （无需额外模块）
|
||||
```
|
||||
|
||||
## 占位符说明
|
||||
|
||||
模板中使用以下占位符，需根据实际项目填充：
|
||||
|
||||
| 占位符 | 说明 |
|
||||
|--------|------|
|
||||
| `{{PROJECT_NAME}}` | 项目名称 |
|
||||
| `{{PROJECT_DESCRIPTION}}` | 项目简介（一句话） |
|
||||
| `{{BADGE_SECTION}}` | 徽章区（可选） |
|
||||
| `{{FEATURES}}` | 功能特性列表 |
|
||||
| `{{INSTALLATION}}` | 安装步骤 |
|
||||
| `{{USAGE}}` | 基本用法 |
|
||||
| `{{EXAMPLES}}` | 示例代码 |
|
||||
| `{{API_DOCS}}` | API 文档 |
|
||||
| `{{CONFIGURATION}}` | 配置说明 |
|
||||
| `{{LICENSE}}` | 许可证类型 |
|
||||
| `{{AUTHOR}}` | 作者信息 |
|
||||
|
||||
## 使用方式
|
||||
|
||||
1. 根据项目类型选择基础模板
|
||||
2. 阅读项目代码，提取关键信息
|
||||
3. 根据需要添加可选模块
|
||||
4. 填充占位符，生成最终 README
|
||||
|
||||
## 编写原则
|
||||
|
||||
1. **用户视角**：从使用者角度组织内容
|
||||
2. **渐进披露**：重要信息在前，细节在后
|
||||
3. **可执行**：示例代码可直接运行
|
||||
4. **保持更新**：与代码同步更新
|
||||
5. **简洁明了**：避免冗余，突出重点
|
||||
@@ -0,0 +1,89 @@
|
||||
<!--
|
||||
模块：api（API 文档）
|
||||
用途：详细的接口说明
|
||||
位置：库项目的核心章节
|
||||
-->
|
||||
|
||||
## API 文档
|
||||
|
||||
### 概览
|
||||
|
||||
{{API_OVERVIEW}}
|
||||
|
||||
### 核心 API
|
||||
|
||||
#### `{{FUNCTION_1_NAME}}`
|
||||
|
||||
{{FUNCTION_1_DESCRIPTION}}
|
||||
|
||||
**签名**：
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{FUNCTION_1_SIGNATURE}}
|
||||
```
|
||||
|
||||
**参数**：
|
||||
|
||||
| 参数 | 类型 | 必需 | 说明 |
|
||||
|------|------|------|------|
|
||||
{{FUNCTION_1_PARAMS}}
|
||||
|
||||
**返回值**：
|
||||
|
||||
{{FUNCTION_1_RETURN}}
|
||||
|
||||
**示例**：
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{FUNCTION_1_EXAMPLE}}
|
||||
```
|
||||
|
||||
#### `{{FUNCTION_2_NAME}}`
|
||||
|
||||
{{FUNCTION_2_DESCRIPTION}}
|
||||
|
||||
**签名**：
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{FUNCTION_2_SIGNATURE}}
|
||||
```
|
||||
|
||||
**参数**：
|
||||
|
||||
| 参数 | 类型 | 必需 | 说明 |
|
||||
|------|------|------|------|
|
||||
{{FUNCTION_2_PARAMS}}
|
||||
|
||||
**返回值**：
|
||||
|
||||
{{FUNCTION_2_RETURN}}
|
||||
|
||||
### 类型定义
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{TYPE_DEFINITIONS}}
|
||||
```
|
||||
|
||||
### 常量
|
||||
|
||||
| 常量 | 值 | 说明 |
|
||||
|------|-----|------|
|
||||
{{CONSTANTS_TABLE}}
|
||||
|
||||
### 错误处理
|
||||
|
||||
| 错误码 | 说明 | 处理建议 |
|
||||
|--------|------|----------|
|
||||
{{ERRORS_TABLE}}
|
||||
|
||||
### 完整 API 参考
|
||||
|
||||
详细的 API 文档请查看 [API Reference]({{API_REFERENCE_URL}})。
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 每个函数都有签名、参数、返回值、示例
|
||||
- 类型定义要完整
|
||||
- 说明错误处理方式
|
||||
- 保持格式统一
|
||||
-->
|
||||
@@ -0,0 +1,77 @@
|
||||
<!--
|
||||
模块：architecture（架构概述）
|
||||
用途：说明系统架构和设计
|
||||
位置：复杂项目的重要章节
|
||||
-->
|
||||
|
||||
## 架构
|
||||
|
||||
### 系统概览
|
||||
|
||||
{{SYSTEM_OVERVIEW}}
|
||||
|
||||
### 架构图
|
||||
|
||||
```
|
||||
{{ARCHITECTURE_DIAGRAM}}
|
||||
```
|
||||
|
||||
### 核心组件
|
||||
|
||||
| 组件 | 职责 | 技术 |
|
||||
|------|------|------|
|
||||
{{COMPONENTS_TABLE}}
|
||||
|
||||
### 数据流
|
||||
|
||||
```
|
||||
{{DATA_FLOW_DIAGRAM}}
|
||||
```
|
||||
|
||||
### 目录结构
|
||||
|
||||
```
|
||||
{{DIRECTORY_STRUCTURE}}
|
||||
```
|
||||
|
||||
### 模块说明
|
||||
|
||||
#### {{MODULE_1_NAME}}
|
||||
|
||||
- **职责**：{{MODULE_1_RESPONSIBILITY}}
|
||||
- **位置**：`{{MODULE_1_PATH}}`
|
||||
- **依赖**：{{MODULE_1_DEPENDENCIES}}
|
||||
|
||||
#### {{MODULE_2_NAME}}
|
||||
|
||||
- **职责**：{{MODULE_2_RESPONSIBILITY}}
|
||||
- **位置**：`{{MODULE_2_PATH}}`
|
||||
- **依赖**：{{MODULE_2_DEPENDENCIES}}
|
||||
|
||||
### 技术选型
|
||||
|
||||
| 领域 | 选择 | 原因 |
|
||||
|------|------|------|
|
||||
{{TECH_CHOICES_TABLE}}
|
||||
|
||||
### 设计决策
|
||||
|
||||
#### {{DECISION_1_TITLE}}
|
||||
|
||||
**背景**：{{DECISION_1_CONTEXT}}
|
||||
|
||||
**方案**：{{DECISION_1_SOLUTION}}
|
||||
|
||||
**权衡**：{{DECISION_1_TRADEOFFS}}
|
||||
|
||||
### 扩展点
|
||||
|
||||
{{EXTENSION_POINTS}}
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 图文结合说明架构
|
||||
- 清晰说明各组件职责
|
||||
- 记录重要设计决策
|
||||
- 说明扩展方式
|
||||
-->
|
||||
@@ -0,0 +1,71 @@
|
||||
<!--
|
||||
模块：changelog（变更日志）
|
||||
用途：版本历史和变更记录
|
||||
位置：通常作为独立文件或 README 章节
|
||||
-->
|
||||
|
||||
## 变更日志
|
||||
|
||||
所有重要的变更都会记录在此文件中。
|
||||
|
||||
格式基于 [Keep a Changelog](https://keepachangelog.com/)，
|
||||
版本号遵循 [语义化版本](https://semver.org/)。
|
||||
|
||||
### [Unreleased]
|
||||
|
||||
#### 新增
|
||||
- {{UNRELEASED_ADDED}}
|
||||
|
||||
#### 变更
|
||||
- {{UNRELEASED_CHANGED}}
|
||||
|
||||
#### 修复
|
||||
- {{UNRELEASED_FIXED}}
|
||||
|
||||
---
|
||||
|
||||
### [{{VERSION_1}}] - {{DATE_1}}
|
||||
|
||||
#### 新增
|
||||
- {{V1_ADDED_1}}
|
||||
- {{V1_ADDED_2}}
|
||||
|
||||
#### 变更
|
||||
- {{V1_CHANGED_1}}
|
||||
|
||||
#### 修复
|
||||
- {{V1_FIXED_1}}
|
||||
|
||||
#### 移除
|
||||
- {{V1_REMOVED_1}}
|
||||
|
||||
---
|
||||
|
||||
### [{{VERSION_2}}] - {{DATE_2}}
|
||||
|
||||
#### 新增
|
||||
- {{V2_ADDED_1}}
|
||||
|
||||
#### 修复
|
||||
- {{V2_FIXED_1}}
|
||||
|
||||
---
|
||||
|
||||
### [{{VERSION_INITIAL}}] - {{DATE_INITIAL}}
|
||||
|
||||
- 首次发布
|
||||
|
||||
---
|
||||
|
||||
[Unreleased]: {{COMPARE_UNRELEASED_URL}}
|
||||
[{{VERSION_1}}]: {{COMPARE_V1_URL}}
|
||||
[{{VERSION_2}}]: {{COMPARE_V2_URL}}
|
||||
[{{VERSION_INITIAL}}]: {{TAG_INITIAL_URL}}
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 按版本倒序排列
|
||||
- 每个版本包含：新增、变更、修复、移除
|
||||
- 提供版本对比链接
|
||||
- 保持格式一致
|
||||
-->
|
||||
@@ -0,0 +1,85 @@
|
||||
<!--
|
||||
模块：configuration（配置说明）
|
||||
用途：详细的配置项说明
|
||||
位置：安装/使用之后
|
||||
-->
|
||||
|
||||
## 配置
|
||||
|
||||
### 配置文件
|
||||
|
||||
配置文件位置：`{{CONFIG_PATH}}`
|
||||
|
||||
首次运行会自动生成默认配置。
|
||||
|
||||
### 配置方式
|
||||
|
||||
#### 1. 配置文件
|
||||
|
||||
编辑 `{{CONFIG_FILE}}`：
|
||||
|
||||
```{{CONFIG_FORMAT}}
|
||||
{{CONFIG_EXAMPLE}}
|
||||
```
|
||||
|
||||
#### 2. 环境变量
|
||||
|
||||
```bash
|
||||
{{ENV_VARS_EXAMPLE}}
|
||||
```
|
||||
|
||||
#### 3. 命令行参数
|
||||
|
||||
```bash
|
||||
{{CLI_ARGS_EXAMPLE}}
|
||||
```
|
||||
|
||||
**优先级**：命令行参数 > 环境变量 > 配置文件
|
||||
|
||||
### 配置项详解
|
||||
|
||||
#### `{{CONFIG_SECTION_1}}`
|
||||
|
||||
| 配置项 | 类型 | 默认值 | 说明 |
|
||||
|--------|------|--------|------|
|
||||
{{CONFIG_SECTION_1_TABLE}}
|
||||
|
||||
#### `{{CONFIG_SECTION_2}}`
|
||||
|
||||
| 配置项 | 类型 | 默认值 | 说明 |
|
||||
|--------|------|--------|------|
|
||||
{{CONFIG_SECTION_2_TABLE}}
|
||||
|
||||
### 完整配置示例
|
||||
|
||||
```{{CONFIG_FORMAT}}
|
||||
{{FULL_CONFIG_EXAMPLE}}
|
||||
```
|
||||
|
||||
### 配置验证
|
||||
|
||||
```bash
|
||||
{{VALIDATE_CONFIG_COMMAND}}
|
||||
```
|
||||
|
||||
### 常见配置场景
|
||||
|
||||
#### 场景 1：{{SCENARIO_1_NAME}}
|
||||
|
||||
```{{CONFIG_FORMAT}}
|
||||
{{SCENARIO_1_CONFIG}}
|
||||
```
|
||||
|
||||
#### 场景 2：{{SCENARIO_2_NAME}}
|
||||
|
||||
```{{CONFIG_FORMAT}}
|
||||
{{SCENARIO_2_CONFIG}}
|
||||
```
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 说明所有配置方式
|
||||
- 每个配置项有类型、默认值、说明
|
||||
- 提供实际场景配置示例
|
||||
- 说明优先级和验证方法
|
||||
-->
|
||||
@@ -0,0 +1,95 @@
|
||||
<!--
|
||||
模块：contributing（贡献指南）
|
||||
用途：指导如何为项目做贡献
|
||||
位置：开源项目必备
|
||||
-->
|
||||
|
||||
## 贡献指南
|
||||
|
||||
感谢你考虑为 {{PROJECT_NAME}} 做贡献！
|
||||
|
||||
### 贡献方式
|
||||
|
||||
- 报告 Bug
|
||||
- 提交功能建议
|
||||
- 改进文档
|
||||
- 提交代码 PR
|
||||
|
||||
### 开发环境
|
||||
|
||||
#### 环境要求
|
||||
|
||||
{{DEV_REQUIREMENTS}}
|
||||
|
||||
#### 环境搭建
|
||||
|
||||
```bash
|
||||
# 克隆仓库
|
||||
git clone {{REPO_URL}}
|
||||
cd {{PROJECT_DIR}}
|
||||
|
||||
# 安装依赖
|
||||
{{INSTALL_DEPS}}
|
||||
|
||||
# 运行测试
|
||||
{{RUN_TESTS}}
|
||||
```
|
||||
|
||||
### 代码规范
|
||||
|
||||
{{CODE_STYLE}}
|
||||
|
||||
#### 提交信息格式
|
||||
|
||||
```
|
||||
<type>(<scope>): <subject>
|
||||
|
||||
<body>
|
||||
|
||||
<footer>
|
||||
```
|
||||
|
||||
**type 类型**：
|
||||
- `feat`: 新功能
|
||||
- `fix`: 修复 Bug
|
||||
- `docs`: 文档更新
|
||||
- `style`: 代码格式
|
||||
- `refactor`: 重构
|
||||
- `test`: 测试相关
|
||||
- `chore`: 构建/工具
|
||||
|
||||
### 提交 PR
|
||||
|
||||
1. Fork 本仓库
|
||||
2. 创建特性分支：`git checkout -b feature/your-feature`
|
||||
3. 提交更改：`git commit -m 'feat: add some feature'`
|
||||
4. 推送分支：`git push origin feature/your-feature`
|
||||
5. 创建 Pull Request
|
||||
|
||||
### PR 检查清单
|
||||
|
||||
- [ ] 代码通过所有测试
|
||||
- [ ] 新功能有对应测试
|
||||
- [ ] 更新了相关文档
|
||||
- [ ] 提交信息格式正确
|
||||
|
||||
### 代码审查
|
||||
|
||||
所有 PR 都需要至少一位维护者审查后才能合并。
|
||||
|
||||
### 行为准则
|
||||
|
||||
请阅读并遵守我们的 [行为准则](CODE_OF_CONDUCT.md)。
|
||||
|
||||
### 联系方式
|
||||
|
||||
- 问题讨论：[GitHub Discussions]({{DISCUSSIONS_URL}})
|
||||
- Bug 报告：[GitHub Issues]({{ISSUES_URL}})
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 清晰说明贡献流程
|
||||
- 提供开发环境搭建指南
|
||||
- 说明代码规范
|
||||
- 包含 PR 检查清单
|
||||
-->
|
||||
@@ -0,0 +1,71 @@
|
||||
<!--
|
||||
模块：examples（使用示例）
|
||||
用途：展示典型用例和代码示例
|
||||
位置：通常放在基本用法之后
|
||||
-->
|
||||
|
||||
## 示例
|
||||
|
||||
### 基础示例
|
||||
|
||||
#### {{EXAMPLE_1_NAME}}
|
||||
|
||||
{{EXAMPLE_1_DESCRIPTION}}
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{EXAMPLE_1_CODE}}
|
||||
```
|
||||
|
||||
输出：
|
||||
|
||||
```
|
||||
{{EXAMPLE_1_OUTPUT}}
|
||||
```
|
||||
|
||||
#### {{EXAMPLE_2_NAME}}
|
||||
|
||||
{{EXAMPLE_2_DESCRIPTION}}
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{EXAMPLE_2_CODE}}
|
||||
```
|
||||
|
||||
### 进阶示例
|
||||
|
||||
#### {{ADVANCED_EXAMPLE_NAME}}
|
||||
|
||||
{{ADVANCED_EXAMPLE_DESCRIPTION}}
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{ADVANCED_EXAMPLE_CODE}}
|
||||
```
|
||||
|
||||
### 实际场景
|
||||
|
||||
#### 场景：{{SCENARIO_NAME}}
|
||||
|
||||
**需求**：{{SCENARIO_REQUIREMENT}}
|
||||
|
||||
**解决方案**：
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{SCENARIO_CODE}}
|
||||
```
|
||||
|
||||
**说明**：{{SCENARIO_EXPLANATION}}
|
||||
|
||||
### 完整示例项目
|
||||
|
||||
查看 [examples/](examples/) 目录获取完整的示例项目：
|
||||
|
||||
| 示例 | 说明 | 难度 |
|
||||
|------|------|------|
|
||||
{{EXAMPLES_TABLE}}
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 从简单到复杂递进
|
||||
- 示例代码可直接运行
|
||||
- 包含输出帮助理解
|
||||
- 解释关键代码逻辑
|
||||
-->
|
||||
@@ -0,0 +1,85 @@
|
||||
<!--
|
||||
模块：faq（常见问题）
|
||||
用途：解答用户常见问题
|
||||
位置：文档末尾或独立页面
|
||||
-->
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 一般问题
|
||||
|
||||
#### Q: {{GENERAL_Q1}}
|
||||
|
||||
**A**: {{GENERAL_A1}}
|
||||
|
||||
#### Q: {{GENERAL_Q2}}
|
||||
|
||||
**A**: {{GENERAL_A2}}
|
||||
|
||||
### 安装问题
|
||||
|
||||
#### Q: {{INSTALL_Q1}}
|
||||
|
||||
**A**: {{INSTALL_A1}}
|
||||
|
||||
```bash
|
||||
{{INSTALL_SOLUTION_1}}
|
||||
```
|
||||
|
||||
#### Q: {{INSTALL_Q2}}
|
||||
|
||||
**A**: {{INSTALL_A2}}
|
||||
|
||||
### 使用问题
|
||||
|
||||
#### Q: {{USAGE_Q1}}
|
||||
|
||||
**A**: {{USAGE_A1}}
|
||||
|
||||
示例：
|
||||
|
||||
```{{LANGUAGE}}
|
||||
{{USAGE_EXAMPLE_1}}
|
||||
```
|
||||
|
||||
#### Q: {{USAGE_Q2}}
|
||||
|
||||
**A**: {{USAGE_A2}}
|
||||
|
||||
### 故障排除
|
||||
|
||||
#### Q: {{TROUBLE_Q1}}
|
||||
|
||||
**A**: {{TROUBLE_A1}}
|
||||
|
||||
排查步骤：
|
||||
|
||||
1. {{TROUBLE_STEP_1}}
|
||||
2. {{TROUBLE_STEP_2}}
|
||||
3. {{TROUBLE_STEP_3}}
|
||||
|
||||
#### Q: {{TROUBLE_Q2}}
|
||||
|
||||
**A**: {{TROUBLE_A2}}
|
||||
|
||||
### 性能问题
|
||||
|
||||
#### Q: {{PERF_Q1}}
|
||||
|
||||
**A**: {{PERF_A1}}
|
||||
|
||||
### 其他问题
|
||||
|
||||
没有找到你的问题？
|
||||
|
||||
- 搜索 [Issues]({{ISSUES_URL}}) 看是否有人遇到过类似问题
|
||||
- 在 [Discussions]({{DISCUSSIONS_URL}}) 中提问
|
||||
- 提交新的 [Issue]({{NEW_ISSUE_URL}})
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 按类别组织问题
|
||||
- 问题简洁，答案详细
|
||||
- 包含代码示例和排查步骤
|
||||
- 提供进一步帮助的链接
|
||||
-->
|
||||
@@ -0,0 +1,88 @@
|
||||
<!--
|
||||
模块：installation（安装指南）
|
||||
用途：详细的多平台安装说明
|
||||
位置：通常放在功能特性之后
|
||||
-->
|
||||
|
||||
## 安装
|
||||
|
||||
### 系统要求
|
||||
|
||||
{{SYSTEM_REQUIREMENTS}}
|
||||
|
||||
### 方式一：包管理器（推荐）
|
||||
|
||||
#### macOS
|
||||
|
||||
```bash
|
||||
{{INSTALL_MACOS}}
|
||||
```
|
||||
|
||||
#### Linux
|
||||
|
||||
```bash
|
||||
{{INSTALL_LINUX}}
|
||||
```
|
||||
|
||||
#### Windows
|
||||
|
||||
```powershell
|
||||
{{INSTALL_WINDOWS}}
|
||||
```
|
||||
|
||||
### 方式二：预编译二进制
|
||||
|
||||
从 [Releases]({{RELEASES_URL}}) 下载对应平台的版本：
|
||||
|
||||
| 平台 | 架构 | 下载 |
|
||||
|------|------|------|
|
||||
| macOS | Intel/ARM | {{DOWNLOAD_MACOS}} |
|
||||
| Linux | x64/ARM | {{DOWNLOAD_LINUX}} |
|
||||
| Windows | x64 | {{DOWNLOAD_WINDOWS}} |
|
||||
|
||||
### 方式三：从源码构建
|
||||
|
||||
```bash
|
||||
# 克隆仓库
|
||||
git clone {{REPO_URL}}
|
||||
cd {{PROJECT_DIR}}
|
||||
|
||||
# 安装依赖
|
||||
{{INSTALL_DEPS}}
|
||||
|
||||
# 构建
|
||||
{{BUILD_COMMAND}}
|
||||
|
||||
# 安装到系统
|
||||
{{INSTALL_LOCAL}}
|
||||
```
|
||||
|
||||
### 验证安装
|
||||
|
||||
```bash
|
||||
{{VERIFY_COMMAND}}
|
||||
```
|
||||
|
||||
预期输出：
|
||||
|
||||
```
|
||||
{{VERIFY_OUTPUT}}
|
||||
```
|
||||
|
||||
### 常见问题
|
||||
|
||||
#### 问题 1：{{ISSUE_1}}
|
||||
|
||||
{{SOLUTION_1}}
|
||||
|
||||
#### 问题 2：{{ISSUE_2}}
|
||||
|
||||
{{SOLUTION_2}}
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 覆盖主流平台
|
||||
- 提供多种安装方式
|
||||
- 包含验证步骤
|
||||
- 列出常见安装问题
|
||||
-->
|
||||
@@ -0,0 +1,88 @@
|
||||
<!--
|
||||
模块：license（许可证）
|
||||
用途：说明项目许可证
|
||||
位置：README 末尾
|
||||
-->
|
||||
|
||||
## 许可证
|
||||
|
||||
本项目采用 {{LICENSE_NAME}} 许可证。
|
||||
|
||||
### 简要说明
|
||||
|
||||
{{LICENSE_SUMMARY}}
|
||||
|
||||
### 你可以
|
||||
|
||||
- {{CAN_1}}
|
||||
- {{CAN_2}}
|
||||
- {{CAN_3}}
|
||||
|
||||
### 你不可以
|
||||
|
||||
- {{CANNOT_1}}
|
||||
- {{CANNOT_2}}
|
||||
|
||||
### 你必须
|
||||
|
||||
- {{MUST_1}}
|
||||
- {{MUST_2}}
|
||||
|
||||
### 完整许可证
|
||||
|
||||
查看 [LICENSE](LICENSE) 文件获取完整许可证文本。
|
||||
|
||||
---
|
||||
|
||||
**常用许可证模板**：
|
||||
|
||||
#### MIT
|
||||
|
||||
```
|
||||
MIT License
|
||||
|
||||
Copyright (c) {{YEAR}} {{AUTHOR}}
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
```
|
||||
|
||||
#### Apache 2.0
|
||||
|
||||
```
|
||||
Copyright {{YEAR}} {{AUTHOR}}
|
||||
|
||||
Licensed under the Apache License, Version 2.0 (the "License");
|
||||
you may not use this file except in compliance with the License.
|
||||
You may obtain a copy of the License at
|
||||
|
||||
http://www.apache.org/licenses/LICENSE-2.0
|
||||
|
||||
Unless required by applicable law or agreed to in writing, software
|
||||
distributed under the License is distributed on an "AS IS" BASIS,
|
||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
See the License for the specific language governing permissions and
|
||||
limitations under the License.
|
||||
```
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 选择合适的许可证
|
||||
- 简要说明权限和限制
|
||||
- 提供完整许可证链接
|
||||
-->
|
||||
@@ -0,0 +1,47 @@
|
||||
<!--
|
||||
模块：quickstart（快速开始）
|
||||
用途：让用户在 5 分钟内体验核心功能
|
||||
位置：通常放在安装之后
|
||||
-->
|
||||
|
||||
## 快速开始
|
||||
|
||||
只需 3 步，即可体验 {{PROJECT_NAME}} 的核心功能：
|
||||
|
||||
### 1. 安装
|
||||
|
||||
```bash
|
||||
{{INSTALL_COMMAND}}
|
||||
```
|
||||
|
||||
### 2. 初始化
|
||||
|
||||
```bash
|
||||
{{INIT_COMMAND}}
|
||||
```
|
||||
|
||||
### 3. 运行
|
||||
|
||||
```bash
|
||||
{{RUN_COMMAND}}
|
||||
```
|
||||
|
||||
**预期输出**：
|
||||
|
||||
```
|
||||
{{EXPECTED_OUTPUT}}
|
||||
```
|
||||
|
||||
### 下一步
|
||||
|
||||
- [完整使用指南](#使用说明)
|
||||
- [配置选项](#配置)
|
||||
- [更多示例](#示例)
|
||||
|
||||
<!--
|
||||
编写提示：
|
||||
- 保持步骤简洁，最多 3-5 步
|
||||
- 每步都应有可执行的命令
|
||||
- 包含预期输出帮助用户验证
|
||||
- 链接到更详细的文档
|
||||
-->
|
||||
@@ -0,0 +1,97 @@
|
||||
<!--
|
||||
模板：application（应用程序）
|
||||
适用：CLI 工具、GUI 应用、Web 应用、后端服务
|
||||
特点：安装部署清晰、功能完整、配置详细
|
||||
-->
|
||||
|
||||
# {{PROJECT_NAME}}
|
||||
|
||||
{{BADGE_SECTION}}
|
||||
|
||||
{{PROJECT_DESCRIPTION}}
|
||||
|
||||
## 功能特性
|
||||
|
||||
{{FEATURES}}
|
||||
|
||||
## 截图/演示
|
||||
|
||||
{{SCREENSHOTS}}
|
||||
|
||||
## 系统要求
|
||||
|
||||
{{REQUIREMENTS}}
|
||||
|
||||
## 安装
|
||||
|
||||
### 方式一：预编译版本
|
||||
|
||||
{{INSTALL_BINARY}}
|
||||
|
||||
### 方式二：从源码构建
|
||||
|
||||
{{INSTALL_SOURCE}}
|
||||
|
||||
## 快速开始
|
||||
|
||||
{{QUICKSTART}}
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 基本命令
|
||||
|
||||
{{BASIC_COMMANDS}}
|
||||
|
||||
### 常用操作
|
||||
|
||||
{{COMMON_OPERATIONS}}
|
||||
|
||||
## 配置
|
||||
|
||||
### 配置文件位置
|
||||
|
||||
{{CONFIG_LOCATION}}
|
||||
|
||||
### 配置项说明
|
||||
|
||||
{{CONFIG_OPTIONS}}
|
||||
|
||||
### 配置示例
|
||||
|
||||
```
|
||||
{{CONFIG_EXAMPLE}}
|
||||
```
|
||||
|
||||
## 开发
|
||||
|
||||
### 环境搭建
|
||||
|
||||
{{DEV_SETUP}}
|
||||
|
||||
### 构建
|
||||
|
||||
{{BUILD}}
|
||||
|
||||
### 测试
|
||||
|
||||
{{TEST}}
|
||||
|
||||
## 常见问题
|
||||
|
||||
{{FAQ}}
|
||||
|
||||
## 更新日志
|
||||
|
||||
查看 [CHANGELOG.md](CHANGELOG.md) 了解版本历史。
|
||||
|
||||
## 贡献
|
||||
|
||||
欢迎贡献！请查看 [贡献指南](CONTRIBUTING.md)。
|
||||
|
||||
## 许可证
|
||||
|
||||
{{LICENSE}}
|
||||
|
||||
## 致谢
|
||||
|
||||
{{ACKNOWLEDGEMENTS}}
|
||||
@@ -0,0 +1,64 @@
|
||||
<!--
|
||||
模板：documentation（纯文档）
|
||||
适用：教程、指南、规范文档、知识库、材料集
|
||||
特点：结构清晰、导航便捷、内容为主
|
||||
-->
|
||||
|
||||
# {{PROJECT_NAME}}
|
||||
|
||||
{{PROJECT_DESCRIPTION}}
|
||||
|
||||
## 目录
|
||||
|
||||
{{TOC}}
|
||||
|
||||
## 概述
|
||||
|
||||
{{OVERVIEW}}
|
||||
|
||||
## 目标读者
|
||||
|
||||
{{AUDIENCE}}
|
||||
|
||||
## 如何阅读
|
||||
|
||||
{{READING_GUIDE}}
|
||||
|
||||
## 文档结构
|
||||
|
||||
```
|
||||
{{STRUCTURE}}
|
||||
```
|
||||
|
||||
## 快速导航
|
||||
|
||||
| 主题 | 文档 | 说明 |
|
||||
|------|------|------|
|
||||
{{NAV_TABLE}}
|
||||
|
||||
## 入门指南
|
||||
|
||||
{{GETTING_STARTED}}
|
||||
|
||||
## 核心概念
|
||||
|
||||
{{CORE_CONCEPTS}}
|
||||
|
||||
## 参考资料
|
||||
|
||||
{{REFERENCES}}
|
||||
|
||||
## 贡献
|
||||
|
||||
欢迎改进文档！
|
||||
|
||||
- 发现错误：提交 Issue
|
||||
- 内容建议：提交 PR
|
||||
|
||||
## 版本历史
|
||||
|
||||
{{VERSION_HISTORY}}
|
||||
|
||||
## 许可证
|
||||
|
||||
{{LICENSE}}
|
||||
@@ -0,0 +1,69 @@
|
||||
<!--
|
||||
模板：library（库/工具）
|
||||
适用：npm/cargo/pip/gem 等包管理器发布的库、SDK、工具包
|
||||
特点：安装优先、API 清晰、示例丰富
|
||||
-->
|
||||
|
||||
# {{PROJECT_NAME}}
|
||||
|
||||
{{BADGE_SECTION}}
|
||||
|
||||
{{PROJECT_DESCRIPTION}}
|
||||
|
||||
## 功能特性
|
||||
|
||||
{{FEATURES}}
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
{{INSTALLATION}}
|
||||
```
|
||||
|
||||
## 快速开始
|
||||
|
||||
```
|
||||
{{QUICKSTART_CODE}}
|
||||
```
|
||||
|
||||
## API 文档
|
||||
|
||||
{{API_DOCS}}
|
||||
|
||||
### 核心方法
|
||||
|
||||
{{CORE_METHODS}}
|
||||
|
||||
### 配置选项
|
||||
|
||||
{{OPTIONS}}
|
||||
|
||||
## 示例
|
||||
|
||||
### 基础用法
|
||||
|
||||
```
|
||||
{{EXAMPLE_BASIC}}
|
||||
```
|
||||
|
||||
### 进阶用法
|
||||
|
||||
```
|
||||
{{EXAMPLE_ADVANCED}}
|
||||
```
|
||||
|
||||
## 兼容性
|
||||
|
||||
{{COMPATIBILITY}}
|
||||
|
||||
## 贡献
|
||||
|
||||
欢迎贡献代码！请查看 [贡献指南](CONTRIBUTING.md)。
|
||||
|
||||
## 许可证
|
||||
|
||||
{{LICENSE}}
|
||||
|
||||
## 作者
|
||||
|
||||
{{AUTHOR}}
|
||||
@@ -0,0 +1,36 @@
|
||||
<!--
|
||||
模板：minimal（微型项目）
|
||||
适用：< 500 行代码的小工具、脚本、单文件项目
|
||||
特点：精简、聚焦核心功能、快速理解
|
||||
-->
|
||||
|
||||
# {{PROJECT_NAME}}
|
||||
|
||||
{{PROJECT_DESCRIPTION}}
|
||||
|
||||
## 用法
|
||||
|
||||
```bash
|
||||
{{USAGE}}
|
||||
```
|
||||
|
||||
## 示例
|
||||
|
||||
```
|
||||
{{EXAMPLES}}
|
||||
```
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
{{INSTALLATION}}
|
||||
```
|
||||
|
||||
<!-- 可选：如有配置项 -->
|
||||
## 配置
|
||||
|
||||
{{CONFIGURATION}}
|
||||
|
||||
## 许可证
|
||||
|
||||
{{LICENSE}}
|
||||
@@ -0,0 +1,101 @@
|
||||
<!--
|
||||
模板：monorepo（多项目仓库）
|
||||
适用：包含多个子项目的仓库、工作区项目
|
||||
特点：子项目索引、统一说明、各项目独立介绍
|
||||
-->
|
||||
|
||||
# {{PROJECT_NAME}}
|
||||
|
||||
{{BADGE_SECTION}}
|
||||
|
||||
{{PROJECT_DESCRIPTION}}
|
||||
|
||||
## 项目结构
|
||||
|
||||
```
|
||||
{{STRUCTURE}}
|
||||
```
|
||||
|
||||
## 子项目
|
||||
|
||||
| 项目 | 路径 | 说明 | 状态 |
|
||||
|------|------|------|------|
|
||||
{{SUBPROJECTS_TABLE}}
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 环境要求
|
||||
|
||||
{{REQUIREMENTS}}
|
||||
|
||||
### 克隆仓库
|
||||
|
||||
```bash
|
||||
{{CLONE_COMMAND}}
|
||||
```
|
||||
|
||||
### 初始化
|
||||
|
||||
```bash
|
||||
{{INIT_COMMAND}}
|
||||
```
|
||||
|
||||
## 各子项目介绍
|
||||
|
||||
### {{SUBPROJECT_1_NAME}}
|
||||
|
||||
{{SUBPROJECT_1_DESCRIPTION}}
|
||||
|
||||
**快速开始**：
|
||||
|
||||
```bash
|
||||
{{SUBPROJECT_1_QUICKSTART}}
|
||||
```
|
||||
|
||||
[详细文档]({{SUBPROJECT_1_README}})
|
||||
|
||||
### {{SUBPROJECT_2_NAME}}
|
||||
|
||||
{{SUBPROJECT_2_DESCRIPTION}}
|
||||
|
||||
**快速开始**：
|
||||
|
||||
```bash
|
||||
{{SUBPROJECT_2_QUICKSTART}}
|
||||
```
|
||||
|
||||
[详细文档]({{SUBPROJECT_2_README}})
|
||||
|
||||
<!-- 根据实际子项目数量添加更多 -->
|
||||
|
||||
## 开发指南
|
||||
|
||||
### 依赖管理
|
||||
|
||||
{{DEPENDENCY_MANAGEMENT}}
|
||||
|
||||
### 构建所有项目
|
||||
|
||||
```bash
|
||||
{{BUILD_ALL}}
|
||||
```
|
||||
|
||||
### 测试所有项目
|
||||
|
||||
```bash
|
||||
{{TEST_ALL}}
|
||||
```
|
||||
|
||||
### 发布流程
|
||||
|
||||
{{RELEASE_PROCESS}}
|
||||
|
||||
## 贡献
|
||||
|
||||
请查看 [贡献指南](CONTRIBUTING.md)。
|
||||
|
||||
## 许可证
|
||||
|
||||
{{LICENSE}}
|
||||
|
||||
各子项目可能有独立的许可证，详见各项目目录。
|
||||
165
aide-marketplace/aide-plugin/skills/rework/SKILL.md
Normal file
165
aide-marketplace/aide-plugin/skills/rework/SKILL.md
Normal file
@@ -0,0 +1,165 @@
|
||||
# 返工流程指南
|
||||
|
||||
本指南帮助你在 Aide 工作流中处理返工（rework）场景。返工是指用户在 confirm 阶段发现问题或有新需求，需要回退到之前的阶段重新处理。
|
||||
|
||||
## 返工类型判断
|
||||
|
||||
根据问题类型选择返工目标阶段：
|
||||
|
||||
| 返工目标 | 触发条件 | 处理方式 |
|
||||
|----------|----------|----------|
|
||||
| task-optimize | 新需求、需求理解偏差 | 更新 task.source |
|
||||
| flow-design | 架构/流程设计问题 | 更新细则 + new-requirements.md |
|
||||
| impl | 实现问题 | 更新细则 + new-requirements.md |
|
||||
| verify | 验证未通过 | 更新细则 + new-requirements.md |
|
||||
|
||||
---
|
||||
|
||||
## 返工到 task-optimize 阶段
|
||||
|
||||
当需要重新理解需求或有重大新需求时使用。
|
||||
|
||||
### 流程
|
||||
|
||||
1. 记录问题：
|
||||
```bash
|
||||
aide flow issue "准备返工: [原因简述]"
|
||||
```
|
||||
|
||||
2. 更新 task.source 文档（见下方格式）
|
||||
|
||||
3. 向用户发出提醒（见下方模板）
|
||||
|
||||
4. 执行返工命令：
|
||||
```bash
|
||||
aide flow back-part task-optimize "[原因]"
|
||||
```
|
||||
|
||||
5. 执行确认命令：
|
||||
```bash
|
||||
aide flow back-confirm --key [key]
|
||||
```
|
||||
> 注：key 由 `aide flow back-part` 生成
|
||||
|
||||
### task.source 更新格式
|
||||
|
||||
在文档末尾添加：
|
||||
|
||||
```markdown
|
||||
---
|
||||
|
||||
## 返工记录 [时间戳]
|
||||
|
||||
### 用户反馈
|
||||
[用户原文]
|
||||
|
||||
### 提出时机
|
||||
[在哪个阶段/步骤提出]
|
||||
|
||||
### LLM 建议
|
||||
[如有]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 返工到其他阶段
|
||||
|
||||
返工到 flow-design、impl、verify 阶段时使用。
|
||||
|
||||
### 流程
|
||||
|
||||
1. 记录问题：
|
||||
```bash
|
||||
aide flow issue "准备返工前处理需求整合: [原因简述]"
|
||||
```
|
||||
|
||||
2. 创建/更新 new-requirements.md（见下方格式）
|
||||
|
||||
3. 更新细则文档：
|
||||
- 在导览部分添加返工声明
|
||||
- 梳理：已完成项、未完成项、需重新处理项
|
||||
- 处理需求冲突
|
||||
- 融入新需求
|
||||
- 删除返工声明
|
||||
|
||||
4. 向用户发出提醒（见下方模板）
|
||||
|
||||
5. 执行返工命令：
|
||||
```bash
|
||||
aide flow back-part [阶段] "[原因]"
|
||||
```
|
||||
|
||||
6. 执行确认命令：
|
||||
```bash
|
||||
aide flow back-confirm --key [key]
|
||||
```
|
||||
|
||||
### new-requirements.md 格式
|
||||
|
||||
位置：`.aide/new-requirements.md`
|
||||
|
||||
```markdown
|
||||
# 新需求记录
|
||||
|
||||
## 返工 [时间戳]
|
||||
|
||||
### 用户反馈
|
||||
[原文]
|
||||
|
||||
### 提出时机
|
||||
[阶段/步骤]
|
||||
|
||||
### 影响分析
|
||||
- 已完成项：[列表]
|
||||
- 未完成项：[列表]
|
||||
- 需重新处理：[列表]
|
||||
|
||||
### 冲突处理
|
||||
[如何处理与原细则的冲突]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 提醒用户模板
|
||||
|
||||
### 返工到 task-optimize
|
||||
|
||||
> 我将会对 task-now.md 进行更新，加入您的新需求和我的建议，然后更新流程状态返工到 task-optimize 阶段。建议您在流程状态返工后使用 `/exit` 结束本次对话，重新启动一个新的对话执行 load+run，我将会自动接续任务的处理。
|
||||
|
||||
### 返工到其他阶段
|
||||
|
||||
> 我将会对 new-requirements.md 进行更新，加入您的新需求和我的建议，然后处理好您的新需求和原细则的需求冲突整合，然后更新流程状态返工到 [阶段] 阶段。建议您在流程状态返工后使用 `/exit` 结束本次对话，重新启动一个新的对话执行 load+run，我将会自动接续任务的处理。
|
||||
|
||||
---
|
||||
|
||||
## 确认机制
|
||||
|
||||
返工前必须完成确认流程：
|
||||
|
||||
1. 当执行 `aide flow back-part` 时，系统会检测是否已确认
|
||||
2. 如未确认，系统会生成一个随机 key 并输出提示
|
||||
3. 完成准备工作后，执行 `aide flow back-confirm --key <key>` 确认
|
||||
4. 确认成功后，系统会自动执行返工操作并创建清洁提交
|
||||
|
||||
### 命令说明
|
||||
|
||||
```bash
|
||||
# 首次调用：生成 key，记录目标阶段
|
||||
aide flow back-part flow-design "设计遗漏"
|
||||
# 输出: ⚠ 返工需要确认。请先完成准备工作，然后执行:
|
||||
# aide flow back-confirm --key abc123
|
||||
|
||||
# 完成准备后：确认并执行
|
||||
aide flow back-confirm --key abc123
|
||||
# 输出: ✓ 返工确认成功，回退到环节: flow-design
|
||||
# ⚠ 建议执行 /exit 重新开始对话
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **文档优先**：返工前必须更新相关文档，确保上下文不丢失
|
||||
2. **清洁提交**：确认后系统会自动创建 git 提交，保留当前状态
|
||||
3. **重启对话**：建议返工后重启对话，避免上下文混乱
|
||||
4. **状态文件**：确认状态存储在 `.aide/back-confirm-state.json`
|
||||
Reference in New Issue
Block a user