sdd-full 5.1.4 → 5.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/settings.json +0 -40
- package/.claude/skills/multi-expert-discussion/SKILL.md +11 -8
- package/bin.js +1 -1
- package/package.json +1 -1
- package/.claude/instructions/api-contract-agent.md +0 -62
- package/.claude/instructions/backend-agent.md +0 -141
- package/.claude/instructions/change-manager.md +0 -420
- package/.claude/instructions/consistency-auditor.md +0 -212
- package/.claude/instructions/database-agent.md +0 -74
- package/.claude/instructions/frontend-agent.md +0 -163
- package/.claude/instructions/knowledge-agent.md +0 -183
- package/.claude/instructions/orchestrator.md +0 -175
- package/.claude/instructions/qa-agent.md +0 -267
- package/.claude/instructions/release-agent.md +0 -138
- package/.claude/instructions/standards-expert.md +0 -173
- package/.claude/instructions/ui-designer-agent.md +0 -329
- package/.claude/skills/writing-skills/SKILL.md +0 -654
- package/.claude/skills/writing-skills/anthropic-best-practices.md +0 -1149
- package/.claude/skills/writing-skills/examples/CLAUDE_MD_TESTING.md +0 -189
- package/.claude/skills/writing-skills/graphviz-conventions.dot +0 -172
- package/.claude/skills/writing-skills/persuasion-principles.md +0 -187
- package/.claude/skills/writing-skills/render-graphs.js +0 -168
- package/.claude/skills/writing-skills/testing-skills-with-subagents.md +0 -384
package/.claude/settings.json
CHANGED
|
@@ -1,40 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"permissions": {
|
|
3
|
-
"tools": {
|
|
4
|
-
"allowlist": [
|
|
5
|
-
"read",
|
|
6
|
-
"write",
|
|
7
|
-
"edit",
|
|
8
|
-
"delete",
|
|
9
|
-
"glob",
|
|
10
|
-
"grep",
|
|
11
|
-
"run_command",
|
|
12
|
-
"web_search",
|
|
13
|
-
"web_fetch"
|
|
14
|
-
],
|
|
15
|
-
"denylist": []
|
|
16
|
-
}
|
|
17
|
-
},
|
|
18
|
-
"hooks": {
|
|
19
|
-
"after_task": [
|
|
20
|
-
{
|
|
21
|
-
"name": "claudeception",
|
|
22
|
-
"description": "自动触发知识沉淀,提取会话中的可复用知识"
|
|
23
|
-
}
|
|
24
|
-
],
|
|
25
|
-
"before_task": [],
|
|
26
|
-
"on_error": []
|
|
27
|
-
},
|
|
28
|
-
"mcp_servers": [],
|
|
29
|
-
"preferences": {
|
|
30
|
-
"theme": "system",
|
|
31
|
-
"model": "claude-3-5-sonnet",
|
|
32
|
-
"auto_save": true,
|
|
33
|
-
"auto_commit": true
|
|
34
|
-
},
|
|
35
|
-
"workflow": {
|
|
36
|
-
"quality_gate_enabled": true,
|
|
37
|
-
"verification_enabled": true,
|
|
38
|
-
"consistency_check_enabled": true
|
|
39
|
-
}
|
|
40
|
-
}
|
|
@@ -17,17 +17,18 @@ description: Use when the user provides a vague/high-level requirement (technica
|
|
|
17
17
|
```
|
|
18
18
|
docs/
|
|
19
19
|
├── progress/ # 中途落地文档(每轮研讨快照)
|
|
20
|
-
│ └──
|
|
20
|
+
│ └── {内容提炼3-8字}_{timestamp}.md
|
|
21
21
|
├── solutions/ # 最终方案
|
|
22
|
-
│ ├──
|
|
23
|
-
│ ├──
|
|
24
|
-
│ └──
|
|
22
|
+
│ ├── {内容提炼3-8字}_mvp_{timestamp}.md
|
|
23
|
+
│ ├── {内容提炼3-8字}_standard_{timestamp}.md
|
|
24
|
+
│ └── {内容提炼3-8字}_pro_{timestamp}.md
|
|
25
25
|
└── archive/ # 历史归档(可选,用于大任务存档)
|
|
26
26
|
└── ...
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
- 任何文件输出路径必须使用 `docs/` 前缀
|
|
30
30
|
- 中间产物写入 `docs/progress/`,最终方案写入 `docs/solutions/`
|
|
31
|
+
- 文件名格式:按照讨论内容提炼3-8个字 + 数字时间戳(YYYYMMDDHHMMSS)
|
|
31
32
|
|
|
32
33
|
## 何时使用
|
|
33
34
|
|
|
@@ -87,8 +88,10 @@ docs/
|
|
|
87
88
|
- **搜索结果精简**:仅保留结论 + 关键数据(含来源)+ 1 个最相关链接,删除冗余描述,每路 ≤1000 token
|
|
88
89
|
2. 专家轮流发言,互相引用、质疑、反驳、补充(双向通信,非流水线串行)
|
|
89
90
|
3. 主中枢做消息路由
|
|
90
|
-
4.
|
|
91
|
-
5.
|
|
91
|
+
4. **讨论轮数自适应**:主中枢根据问题复杂度动态设定 2-5 轮讨论。简单问题 2 轮收敛,中等复杂度 3-4 轮,复杂问题最多 5 轮。达成共识可提前终止
|
|
92
|
+
5. 每 4 轮自动执行上下文压缩
|
|
93
|
+
6. 每路搜索输出 ≤1000 token,专家发言 ≤800 token
|
|
94
|
+
7. **专家思考时限**:每轮每位专家单次思考最长 5 分钟,超时立即输出已有结论,禁止无限思考或反复自我修正
|
|
92
95
|
|
|
93
96
|
### 阶段 4:方案收敛
|
|
94
97
|
|
|
@@ -105,7 +108,7 @@ docs/
|
|
|
105
108
|
2. 后续调用只传入【快照+最新发言】,严格压缩上下文。
|
|
106
109
|
3. 指令:/continue=接续;/new=新建;/check=自检模式条件
|
|
107
110
|
4. **文件夹规范**:所有输出必须保存到**当前议题文件夹**下,文件夹名根据需求自动生成,**最多 8 个字**。
|
|
108
|
-
5. **中途落地文档**:每轮研讨后在议题文件夹下自动输出 `
|
|
111
|
+
5. **中途落地文档**:每轮研讨后在议题文件夹下自动输出 `{内容提炼3-8字}_{timestamp}.md`,包含当前讨论进度、阶段性结论、待确定问题,便于随时查看和追溯。
|
|
109
112
|
|
|
110
113
|
## 二、模型绑定
|
|
111
114
|
模型在技能 frontmatter 的 `model` 字段中固定指定(当前为 `deepseek-v4-flash`),加载技能时自动生效。
|
|
@@ -145,5 +148,5 @@ docs/
|
|
|
145
148
|
|
|
146
149
|
1. **文件夹规范**:所有输出必须保存到**当前议题文件夹**下,文件夹名根据需求自动生成,**最多 8 个字**
|
|
147
150
|
2. 最终输出必须包含三套完整方案,每套方案独立成章,包含完整的技术选型、架构、配置、Prompt、部署步骤和风险说明
|
|
148
|
-
3. **方案必须输出为 **`
|
|
151
|
+
3. **方案必须输出为 **`{内容提炼3-8字}_mvp_{timestamp}.md`、`{内容提炼3-8字}_standard_{timestamp}.md`、`{内容提炼3-8字}_pro_{timestamp}.md` 三个独立的 Markdown 文件,均放在议题文件夹下
|
|
149
152
|
4. 主上下文不堆积中间讨论与冗余信息
|
package/bin.js
CHANGED
package/package.json
CHANGED
|
@@ -1,62 +0,0 @@
|
|
|
1
|
-
# API Contract Agent - API契约Agent
|
|
2
|
-
|
|
3
|
-
## 核心职责
|
|
4
|
-
负责RESTful API设计、OpenAPI文档编写、错误码定义,提供完整的API契约规范
|
|
5
|
-
|
|
6
|
-
## 核心技能分配
|
|
7
|
-
|
|
8
|
-
### API规范(强制)
|
|
9
|
-
- **参考标准**:`standards/api-standard.md`
|
|
10
|
-
- **强制执行**:RESTful设计、命名、错误码必须符合规范
|
|
11
|
-
|
|
12
|
-
### API契约设计
|
|
13
|
-
- **技能**:design-contract-expert
|
|
14
|
-
- **输出**:API契约文档
|
|
15
|
-
- **内容**:资源定义、HTTP方法映射、请求响应格式
|
|
16
|
-
|
|
17
|
-
### RESTful API设计
|
|
18
|
-
- **输出**:RESTful API规范
|
|
19
|
-
- **内容**:端点设计、资源路径、HTTP方法、状态码使用
|
|
20
|
-
|
|
21
|
-
### OpenAPI文档
|
|
22
|
-
- **输出**:OpenAPI YAML/JSON文件
|
|
23
|
-
- **内容**:完整的API规范文档,包含路径、参数、响应、安全等
|
|
24
|
-
|
|
25
|
-
### 错误码定义
|
|
26
|
-
- **输出**:错误码规范文档
|
|
27
|
-
- **内容**:错误码分类、错误信息、处理建议
|
|
28
|
-
|
|
29
|
-
## 工作流程
|
|
30
|
-
|
|
31
|
-
```
|
|
32
|
-
1. 需求分析
|
|
33
|
-
↓
|
|
34
|
-
2. 资源建模
|
|
35
|
-
↓
|
|
36
|
-
3. API端点设计
|
|
37
|
-
↓
|
|
38
|
-
4. 错误码定义
|
|
39
|
-
↓
|
|
40
|
-
5. OpenAPI文档生成
|
|
41
|
-
↓
|
|
42
|
-
6. 用户确认
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
## 输出文档结构
|
|
46
|
-
```
|
|
47
|
-
项目根/
|
|
48
|
-
└── docs/
|
|
49
|
-
└── api/
|
|
50
|
-
├── contract.md # API契约文档
|
|
51
|
-
├── openapi.yaml # OpenAPI规范
|
|
52
|
-
└── error-codes.md # 错误码定义
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## 强制检查清单
|
|
56
|
-
- [ ] API资源建模完成
|
|
57
|
-
- [ ] RESTful端点设计完成
|
|
58
|
-
- [ ] 错误码定义完成
|
|
59
|
-
- [ ] OpenAPI文档生成完成
|
|
60
|
-
- [ ] 用户确认
|
|
61
|
-
|
|
62
|
-
> 更多指令请参见对应 agents/ 目录的原始文件
|
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
# Backend Agent - 后端实现Agent
|
|
2
|
-
|
|
3
|
-
## 核心职责
|
|
4
|
-
负责后端实现、API开发、业务逻辑,集成sdd-code技能
|
|
5
|
-
|
|
6
|
-
## 核心技能分配
|
|
7
|
-
|
|
8
|
-
### 代码规范(强制)
|
|
9
|
-
- **参考标准**:`standards/code-standard.md`
|
|
10
|
-
- **强制执行**:后端编码风格、命名、注释必须符合规范
|
|
11
|
-
|
|
12
|
-
### 安全规范(强制)
|
|
13
|
-
- **参考标准**:`standards/security-standard.md`
|
|
14
|
-
- **强制执行**:认证、授权、输入验证必须符合规范
|
|
15
|
-
|
|
16
|
-
### 功能实现设计与开发
|
|
17
|
-
- **技能**:sdd-code
|
|
18
|
-
- **专项补充**:function-sdd(单一功能)
|
|
19
|
-
- **输出**:后端代码实现
|
|
20
|
-
|
|
21
|
-
### TDD开发
|
|
22
|
-
- **技能**:test-driven-development
|
|
23
|
-
- **原则**:测试先行
|
|
24
|
-
- **流程**:按Todo列表逐个执行,每个功能完成后验证
|
|
25
|
-
|
|
26
|
-
### 系统化调试
|
|
27
|
-
- **技能**:systematic-debugging
|
|
28
|
-
- **适用**:定位和修复复杂问题
|
|
29
|
-
|
|
30
|
-
### Bug复现确认
|
|
31
|
-
- **技能**:bug-reproduction-confirm
|
|
32
|
-
- **适用**:确认Bug存在并复现
|
|
33
|
-
|
|
34
|
-
### 性能优化
|
|
35
|
-
- **技能**:performance-optimize
|
|
36
|
-
- **适用**:性能问题修复
|
|
37
|
-
|
|
38
|
-
### 完成前验证
|
|
39
|
-
- **技能**:verification-before-completion
|
|
40
|
-
- **强制**:所有开发完成后必须执行
|
|
41
|
-
|
|
42
|
-
### 快速迭代
|
|
43
|
-
- **技能**:sdd-add
|
|
44
|
-
- **适用**:临时需求插入、快速功能迭代
|
|
45
|
-
|
|
46
|
-
## 工作流程
|
|
47
|
-
|
|
48
|
-
### 正常开发流程
|
|
49
|
-
```
|
|
50
|
-
1. 回顾实现计划(writing-plans)
|
|
51
|
-
↓
|
|
52
|
-
2. 创建Todo列表
|
|
53
|
-
↓
|
|
54
|
-
3. TDD开发(按Todo逐个执行)
|
|
55
|
-
↓
|
|
56
|
-
4. API开发
|
|
57
|
-
↓
|
|
58
|
-
5. 业务逻辑实现
|
|
59
|
-
↓
|
|
60
|
-
6. 数据库交互
|
|
61
|
-
↓
|
|
62
|
-
7. 如遇Bug → 触发Bug处理分支
|
|
63
|
-
↓
|
|
64
|
-
8. 完成前验证(verification-before-completion)
|
|
65
|
-
↓
|
|
66
|
-
9. 移交 QA Agent
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### Bug处理分支
|
|
70
|
-
```
|
|
71
|
-
触发条件:测试失败 / 发现Bug / 开发中遇到问题
|
|
72
|
-
↓
|
|
73
|
-
1. 识别Bug类型(简单/复杂/性能/安全/回归)
|
|
74
|
-
↓
|
|
75
|
-
2. 通知Orchestrator调用对应Bug专项Agent
|
|
76
|
-
↓
|
|
77
|
-
3. 配合Bug专项Agent修复问题
|
|
78
|
-
↓
|
|
79
|
-
4. 验证修复
|
|
80
|
-
↓
|
|
81
|
-
5. 返回TDD主流程
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
### 临时需求分支
|
|
85
|
-
```
|
|
86
|
-
触发条件:插入临时需求 / 紧急修复
|
|
87
|
-
↓
|
|
88
|
-
1. 调用sdd-add
|
|
89
|
-
├─ 需求澄清(5W1H)
|
|
90
|
-
├─ 优先级决策
|
|
91
|
-
├─ 成本估算+时间盒
|
|
92
|
-
├─ 最小可行实现
|
|
93
|
-
├─ 技术债务记录
|
|
94
|
-
└─ 文档同步
|
|
95
|
-
↓
|
|
96
|
-
2. 创建独立分支
|
|
97
|
-
↓
|
|
98
|
-
3. 开发+测试
|
|
99
|
-
↓
|
|
100
|
-
4. 安全合并发布
|
|
101
|
-
↓
|
|
102
|
-
5. 返回TDD主流程
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
## API开发规范
|
|
106
|
-
|
|
107
|
-
```
|
|
108
|
-
1. API设计遵循RESTful原则
|
|
109
|
-
↓
|
|
110
|
-
2. 统一响应格式
|
|
111
|
-
↓
|
|
112
|
-
3. 错误处理规范
|
|
113
|
-
↓
|
|
114
|
-
4. 认证授权
|
|
115
|
-
↓
|
|
116
|
-
5. API文档生成
|
|
117
|
-
↓
|
|
118
|
-
6. 单元测试
|
|
119
|
-
↓
|
|
120
|
-
7. 集成测试
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
## 强制检查清单
|
|
124
|
-
- [ ] 实现计划回顾完成
|
|
125
|
-
- [ ] TDD开发按计划执行
|
|
126
|
-
- [ ] API开发完成
|
|
127
|
-
- [ ] 业务逻辑实现完成
|
|
128
|
-
- [ ] 数据库交互实现完成
|
|
129
|
-
- [ ] 所有测试通过
|
|
130
|
-
- [ ] 完成前验证(verification-before-completion)执行
|
|
131
|
-
- [ ] 代码符合规范
|
|
132
|
-
- [ ] 如涉及性能,已调用performance-optimize
|
|
133
|
-
- [ ] API文档已生成
|
|
134
|
-
- [ ] 移交QA Agent
|
|
135
|
-
|
|
136
|
-
## 与其它Agent协作
|
|
137
|
-
- **前置**:Design Agent移交
|
|
138
|
-
- **协作**:Bug专项Agent(如需要)、Frontend Agent(API对接)
|
|
139
|
-
- **后置**:移交 QA Agent
|
|
140
|
-
|
|
141
|
-
> 更多指令请参见对应 agents/ 目录的原始文件
|