Skip to content

Commit 3b8a921

Browse files
committed
feat:devcodex
1 parent 3f6aad4 commit 3b8a921

87 files changed

Lines changed: 757 additions & 682 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/ISSUE_TEMPLATE/bug-report.md‎

Lines changed: 0 additions & 29 deletions
This file was deleted.

‎.github/ISSUE_TEMPLATE/feature-request.md‎

Lines changed: 0 additions & 29 deletions
This file was deleted.

‎.npmignore‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
# Dev tools (not needed by plugin users)
2-
assets/README.md
2+
assets/ASSETS-INFO.md
33
data/
44
node_modules/
55
*.tgz
6+
7+
# Internal migration / codegen scripts (dev-only)
8+
tools/migrate-to-official-format.js
9+
tools/v4-to-v5-migration.js
10+
tools/gen-assets.js

‎CHANGELOG.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,24 @@
22

33
All notable changes to DevCodex will be documented in this file.
44

5+
## [1.0.1] — 2026-04-03
6+
7+
### Added
8+
- **`npx devcodex init`**:一行命令将所有文件安装到项目 `.github/` 目录
9+
- **`npx devcodex update`**:升级覆盖已有文件(同 `init --force`)
10+
- **`npx devcodex status`**:查看当前项目的 DevCodex 安装状态
11+
- **`--dry-run` 选项**:预览将要安装的文件,不实际写入
12+
- `bin.devcodex` 字段:`npx devcodex` 可直接执行
13+
14+
### Changed
15+
- 文件结构迁移至 **GitHub Copilot 官方标准格式**:
16+
- Skills 重组为 `skills/<category>/<name>/SKILL.md` 独立子目录结构
17+
- Agent frontmatter 精简为官方字段(`name/description/tools`)
18+
- Instructions frontmatter 精简为 `applyTo`
19+
- Hooks 新增 `devcodex-hooks.json`(官方 JSON 格式)
20+
- Audit 工具(`tools/v5-full-audit.js`)更新以匹配官方标准
21+
- README 安装说明更新为 `npx devcodex init`
22+
523
## [1.0.0] — 2026-04-03
624

725
### Added

‎README.md‎

Lines changed: 21 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,31 @@ DevCodex 将 [ai-dev-guidelines v4](https://github.com/vextjs/ai-dev-guidelines)
1414

1515
## 安装
1616

17-
在 VS Code 命令面板(`Ctrl+Shift+P`)执行:
17+
### 方式一:npx(推荐,一行命令)
1818

19+
在你的项目根目录执行:
20+
21+
```bash
22+
npx devcodex init
1923
```
20-
GitHub Copilot: Install Plugin
24+
25+
这会将所有 agents / skills / instructions / prompts / hooks 复制到项目的 `.github/` 目录,**重启 VS Code 后即可使用**。
26+
27+
```bash
28+
# 查看已安装状态
29+
npx devcodex status
30+
31+
# 升级到最新版本(覆盖已有文件)
32+
npx devcodex update
33+
```
34+
35+
### 方式二:手动安装
36+
37+
```bash
38+
npm install --save-dev devcodex
2139
```
2240

23-
搜索 **DevCodex** 安装。安装后在 Copilot Chat 中使用 `@dev`、`@audit` 等触发工作流。
41+
然后运行 `npx devcodex init`。
2442

2543
## 快速开始
2644

‎agents/analyze.agent.md‎

Lines changed: 1 addition & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,10 @@
11
---
2-
id: analyze
32
name: DevCodex – 分析工作流
43
description: 单轮分析,输出结论/报告即完成。支持常规分析和技术调研两类子类型。Free 层可用。
5-
version: "1.0.0"
6-
tier: free
74
tools:
85
- filesystem
9-
skills:
10-
- compliance
11-
- memory
12-
- report
13-
- summary
14-
- intent
15-
- analyze-research
16-
instructions:
17-
- "13-analyze"
18-
source: "v4:specs/analyze/README.md"
196
---
20-
7+
<!-- DevCodex Skills: compliance, memory, report, summary, intent, analyze-research -->
218
## 子类型路由
229

2310
| 关键词 / 意图 | 子类型 | 对应 Skill |

‎agents/audit.agent.md‎

Lines changed: 1 addition & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,10 @@
11
---
2-
id: audit
32
name: DevCodex – 审计工作流
43
description: 多轮深度审查,直至收敛。支持规范文件、技术方案、需求文档、项目工程、报告、通用文档 6 类审查目标
5-
version: "1.0.0"
6-
tier: pro
74
tools:
85
- filesystem
9-
skills:
10-
- compliance
11-
- memory
12-
- report
13-
- summary
14-
- audit-common
15-
- audit-dimensions
16-
- audit-tech-design
17-
- audit-requirements
18-
- audit-project
19-
- audit-report
20-
- audit-document
21-
- audit-execution-guide
22-
instructions:
23-
- "12-audit"
24-
source: "v4:specs/audit/README.md"
256
---
26-
7+
<!-- DevCodex Skills: compliance, memory, report, summary, audit-common, audit-dimensions, audit-tech-design, audit-requirements, audit-project, audit-report, audit-document, audit-execution-guide -->
278
## 审查目标类型路由
289

2910
| 用户意图 | 目标类型 | 对应 Skill |

‎agents/chat.agent.md‎

Lines changed: 3 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,10 @@
11
---
2-
id: chat
32
name: DevCodex – 问答工作流
43
description: 纯问答,无需工作流开销。无文件变更意图时直接回复。Free 层可用。
5-
version: "1.0.0"
6-
tier: free
7-
tools: []
8-
skills:
9-
- intent
10-
- memory
11-
- summary
12-
instructions: []
13-
source: "v4:RULES.md N04/N05(chat 直接回复分支)"
4+
tools:
5+
- []
146
---
15-
7+
<!-- DevCodex Skills: intent, memory, summary -->
168
## 适用场景
179

1810
| 场景 | 说明 |

‎agents/dev.agent.md‎

Lines changed: 1 addition & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,11 @@
11
---
2-
id: dev
32
name: DevCodex – 开发工作流
43
description: 处理新功能开发、重构、数据库变更、项目初始化、性能优化、场景测试、文档撰写、方案评审 8 类开发任务
5-
version: "1.0.0"
6-
tier: pro
74
tools:
85
- filesystem
96
- terminal
10-
skills:
11-
- compliance
12-
- memory
13-
- report
14-
- cp-gate
15-
- intent
16-
- summary
17-
- plan
18-
- dev-default
19-
- dev-refactor
20-
- dev-database
21-
- dev-init
22-
- dev-optimization
23-
- dev-scenario-test
24-
- dev-docs
25-
- dev-plan-review
26-
- api-verification
27-
- document-sync
28-
- impact-review
29-
- load-profile
30-
instructions:
31-
- "10-dev"
32-
source: "v4:specs/dev/README.md"
337
---
34-
8+
<!-- DevCodex Skills: compliance, memory, report, cp-gate, intent, summary, plan, dev-default, dev-refactor, dev-database, dev-init, dev-optimization, dev-scenario-test, dev-docs, dev-plan-review, api-verification, document-sync, impact-review, load-profile -->
359
## 子类型路由
3610

3711
| 关键词 / 意图 | 子类型 | 对应 Skill |

‎agents/fix.agent.md‎

Lines changed: 1 addition & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,11 @@
11
---
2-
id: fix
32
name: DevCodex – 修复工作流
43
description: 处理常规 Bug 修复、线上事故响应、安全漏洞修复 3 类修复任务
5-
version: "1.0.0"
6-
tier: pro
74
tools:
85
- filesystem
96
- terminal
10-
skills:
11-
- compliance
12-
- memory
13-
- report
14-
- cp-gate
15-
- intent
16-
- summary
17-
- fix-default
18-
- fix-incident
19-
- fix-security
20-
- api-verification
21-
- document-sync
22-
- impact-review
23-
- load-profile
24-
instructions:
25-
- "11-fix"
26-
source: "v4:specs/fix/README.md"
277
---
28-
8+
<!-- DevCodex Skills: compliance, memory, report, cp-gate, intent, summary, fix-default, fix-incident, fix-security, api-verification, document-sync, impact-review, load-profile -->
299
## 子类型路由
3010

3111
| 关键词 / 意图 | 子类型 | 对应 Skill |

0 commit comments

Comments
 (0)