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.
@@ -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
- │ └── progress_{timestamp}.md
20
+ │ └── {内容提炼3-8字}_{timestamp}.md
21
21
  ├── solutions/ # 最终方案
22
- │ ├── solution_mvp.md
23
- │ ├── solution_standard.md
24
- │ └── solution_pro.md
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. 4 轮自动执行上下文压缩
91
- 5. 每路搜索输出 ≤1000 token,专家发言 ≤800 token
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. **中途落地文档**:每轮研讨后在议题文件夹下自动输出 `progress_{timestamp}.md`,包含当前讨论进度、阶段性结论、待确定问题,便于随时查看和追溯。
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. **方案必须输出为 **`solution_mvp.md`、`solution_standard.md`、`solution_pro.md` 三个独立的 Markdown 文件,均放在议题文件夹下
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
@@ -6,7 +6,7 @@ const fs = require('fs');
6
6
  const path = require('path');
7
7
 
8
8
  const SDD = {
9
- version: '5.1.4',
9
+ version: '5.1.6',
10
10
  name: 'sdd-full',
11
11
  description: '完整的软件设计开发技能包'
12
12
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "sdd-full",
3
- "version": "5.1.4",
3
+ "version": "5.1.6",
4
4
  "description": "SDD Full - 完整的软件设计开发技能包",
5
5
  "main": "index.js",
6
6
  "bin": "./bin.js",
@@ -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/ 目录的原始文件