@chongyan/autospec 1.0.1 → 1.0.2

package/plugins/skills/waterfall-iteration/SKILL.md

@@ -0,0 +1,115 @@
+---
+name: waterfall-iteration
+description: "瀑布模式下的完整流程执行。从需求分析到交付的完整阶段循环。"
+triggers:
+  - workflow: waterfall
+parameters:
+  currentStage: requirement
+  stages: [requirement, design, implement, test, deliver]
+---
+
+# Iteration Waterfall - 瀑布迭代执行
+
+## 概述
+
+瀑布模式的核心是**阶段驱动**的完整流程。与敏捷模式的故事驱动不同，瀑布模式按顺序执行需求→设计→实现→测试→交付的完整阶段循环。
+
+## 输入
+
+- `specs/{feature}/requirement.md`: 需求文档
+- `currentStage`: 当前执行阶段
+- `stages`: 完整阶段列表
+
+## 执行流程
+
+### Step 1: 需求阶段 (Requirement)
+
+```
+1. 读取 specs/{feature}/requirement.md
+2. 需求分析：
+   - 功能需求
+   - 非功能需求
+   - 验收标准
+3. 产出: 需求规格说明书
+4. 验证: 需求完整性检查
+```
+
+### Step 2: 设计阶段 (Design)
+
+```
+1. 架构设计：
+   - 系统架构
+   - 模块划分
+   - 接口定义
+2. 详细设计：
+   - 数据结构
+   - 算法逻辑
+   - 业务流程
+3. 产出: 设计文档
+4. 验证: 设计评审
+```
+
+### Step 3: 实现阶段 (Implement)
+
+```
+1. 编码实现：
+   - 按设计文档编码
+   - 遵循编码规范
+2. 单元测试：
+   - 编写单元测试
+   - 本地快速验证
+3. 产出: 代码实现 + 单元测试
+4. 验证: 编译 + 单元测试通过
+```
+
+### Step 4: 测试阶段 (Test)
+
+```
+1. 集成测试：
+   - 模块集成验证
+   - 接口测试
+2. 系统测试：
+   - 功能测试
+   - 性能测试
+3. 产出: 测试报告
+4. 验证: 所有测试通过
+```
+
+### Step 5: 交付阶段 (Deliver)
+
+```
+1. 部署准备：
+   - 配置整理
+   - 部署文档
+2. 交付验证：
+   - 上线检查
+   - 回滚预案
+3. 产出: 交付物 + 发布说明
+4. 验证: 部署成功
+```
+
+## 阶段验证
+
+| 阶段 | 验证项 | 通过标准 |
+|------|--------|---------|
+| Requirement | 需求完整性 | 需求描述清晰、验收标准完整 |
+| Design | 设计合理性 | 架构设计合理、接口定义完整 |
+| Implement | 代码质量 | 编译通过、单元测试通过 |
+| Test | 测试覆盖 | 功能测试通过、性能达标 |
+| Deliver | 交付完整性 | 部署成功、文档齐全 |
+
+## 与其他迭代模式的区别
+
+| 模式 | 驱动方式 | 适用场景 |
+|------|---------|---------|
+| waterfall-iteration | 阶段驱动 | 需求稳定、项目明确 |
+| agile-iteration | 故事驱动 | 需求变化、增量交付 |
+| hotfix-iteration | 问题驱动 | 紧急修复、快速响应 |
+| experiment-iteration | 假设驱动 | 探索性验证、A/B测试 |
+
+## 注意事项
+
+1. **阶段门禁**：每个阶段必须通过验证才能进入下一阶段
+2. **回退机制**：阶段失败可回退到上一阶段重新处理
+3. **文档驱动**：每个阶段产出明确的文档作为下一阶段输入
+4. **完整流程**：必须走完所有阶段才算完成

package/scripts/cli/index.js

@@ -11,7 +11,7 @@ import { updateCommand } from './update.js';
 import { listCommand } from './list.js';
 import { setVerbose, setLogLevel, LOG_LEVELS } from '../install/hook-logger.js';
 
-const VERSION = '0.1.0';
+const VERSION = '1.0.2';
 
 const program = new Command();
 

package/scripts/cli/init.js

@@ -136,6 +136,32 @@ export function initProject(targetDir, options = {}) {
     }, null, 2), 'utf-8');
   }
 
+  // 6.5. Create evolution subdirectories
+  const evolutionDirs = [
+    path.join(autospecDir, 'practice-log'),
+    path.join(autospecDir, 'evolution'),
+    path.join(autospecDir, 'evolution', 'proposals'),
+    path.join(autospecDir, 'evolution', 'distilled-skills'),
+    path.join(autospecDir, 'benchmarks'),
+    path.join(autospecDir, 'runtime'),
+  ];
+
+  for (const dir of evolutionDirs) {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  }
+
+  // 6.6. Create evolution-log.json
+  const evolutionLogPath = path.join(autospecDir, 'evolution', 'evolution-log.json');
+  if (!fs.existsSync(evolutionLogPath)) {
+    fs.writeFileSync(evolutionLogPath, JSON.stringify({
+      version: '1.0',
+      createdAt: new Date().toISOString(),
+      entries: []
+    }, null, 2), 'utf-8');
+  }
+
   // 7. Initialize memory system (global + project)
   try {
     // Initialize global memory if not exists
@@ -168,8 +194,8 @@ function updateClaudeMd(targetDir) {
 ## 启动门禁
 
 收到任何开发类任务时，**必须先执行启动门禁**（startup-guard skill 会自动提醒）：
-1. 读取 \`.autospec/knowledge/process/overview.md\`
-2. 读取 \`.autospec/knowledge/principles/constitution.md\`
+1. 读取 \`.autospec/knowledge/02-process/00-overview.md\`
+2. 读取 \`.autospec/knowledge/01-principles/09-constitution.md\`
 3. 确认执行模式（自主/交互）和工作流类型
 4. 向用户确认任务范围
 
@@ -186,7 +212,7 @@ function updateClaudeMd(targetDir) {
 | \`/autospec:archive\` | 交付归档 |
 | \`/autospec:evolve\` | 自进化触发 |
 | \`/autospec:status\` | 查看状态 |
-| \`/autospec:validate\` | Layer 1 验证 |
+| \`/autospec:test\` | 统一测试命令（验证+修复+评测） |
 
 **迭代模式选择**（通过 /autospec:run）：
 - \`--workflow=waterfall\` Waterfall (default)
@@ -217,7 +243,7 @@ function updateClaudeMd(targetDir) {
 | implementation-stage | 编码实现场景 → 加载实现流程 |
 | testing-stage | 测试场景 → 加载测试流程 |
 | delivery-stage | 交付部署场景 → 加载交付流程 + 自动记录 practice-log + 进化扫描 |
-| evolution-process | 框架进化场景 → 加载进化流程（强制执行 meta skills） |
+| field-evolve-* | 领域进化场景 → 加载进化流程（扫描/执行/分析/修复/验证/学习/蒸馏） |
 | pending-dashboard | 新会话启动 → 扫描待处理提案/practice-log/中断流程 |
 
 ## 审查 Agent（做审分离）

package/scripts/cli/list.js

@@ -22,7 +22,7 @@ export function listCommand() {
   // 状态与验证命令
   console.log(chalk.cyan('  状态与验证'));
   console.log('    /autospec:status       查看流程状态');
-  console.log('    /autospec:validate     Layer 1 确定性验证');
+  console.log('    /autospec:test         统一测试命令（验证+修复+评测）');
   console.log('    /autospec:review       审查交付物');
   console.log('    /autospec:evaluate     生成评测报告');
   console.log('');
@@ -32,8 +32,9 @@ export function listCommand() {
   console.log('    /autospec:env          查看环境配置');
   console.log('    /autospec:env-validate 验证环境配置');
   console.log('    /autospec:env-sync     同步环境知识（含初始化）');
-  console.log('    /autospec:env-import   导入知识库');
   console.log('    /autospec:env-export   导出知识库');
+  console.log('    /autospec:env-update   提交变更到知识源');
+  console.log('    /autospec:env-template 管理环境模板');
   console.log('');
 
   // 组件命令

package/scripts/config/commands.config.js

@@ -48,16 +48,16 @@ export const COMMAND_DEFINITIONS = {
   // 状态与验证命令
   // ============================================================
   status: {
-    description: '查看当前AutoSpec流程状态，AI提供下一步建议',
+    description: '查看当前 AutoSpec 流程的执行状态（支持多系统开发盯盘）',
     templateFile: 'status.md'
   },
   review: {
     description: '审查各阶段交付物（需求/设计/代码/测试），评估产出质量',
     templateFile: 'review.md'
   },
-  validate: {
-    description: '运行Layer1确定性验证，AI分析结果并提供修复建议',
-    templateFile: 'validate.md'
+  test: {
+    description: '统一测试命令：执行测试 → 问题分析 → 自动修复 → 效果评测',
+    templateFile: 'test.md'
   },
 
   // ============================================================
@@ -72,7 +72,7 @@ export const COMMAND_DEFINITIONS = {
     templateFile: 'env-validate.md'
   },
   'env-sync': {
-    description: '同步环境知识 - 本地扫描或从 Git/在线文档/npm 导入',
+    description: '初始化环境目录并同步环境知识，AI 提炼最佳实践和配置模板',
     templateFile: 'env-sync.md'
   },
   'env-export': {
@@ -84,7 +84,7 @@ export const COMMAND_DEFINITIONS = {
     templateFile: 'env-template.md'
   },
   'env-update': {
-    description: '将本地环境知识变更提交到知识源（Git/在线文档/本地文件）',
+    description: '将本地环境知识变更提交到知识源（Git/在线文档平台/本地文件）',
     templateFile: 'env-update.md'
   },
 
@@ -100,11 +100,11 @@ export const COMMAND_DEFINITIONS = {
   // 自进化命令
   // ============================================================
   'project-evolve': {
-    description: 'AI Native 项目自我进化：智能感知、自动评测、自适应修复',
+    description: 'AI Native 项目自我进化：智能感知、自动评测、自适应修复，支持单系统/多系统，评测即记忆，记忆即进化',
     templateFile: 'project-evolve.md'
   },
   'field-evolve': {
-    description: '实战项目自进化：执行 benchmarks、评估分析、自动修复和技能蒸馏',
+    description: '触发 AutoSpec 领域进化：从多个实战项目中提炼经验，回流到框架层，支持 quick/deep/full/report/distill/generate 模式',
     templateFile: 'field-evolve.md'
   }
 

package/scripts/config/hooks.config.js

@@ -16,7 +16,7 @@
  * - 35: execution-tracker (执行追踪)
  *
  * 注意：evolution-trigger 和 practice-log-reminder 已合并到 skill：
- * - knowledge/guides/support/practice-logger.md
+ * - knowledge/03-guides/18-log-practice.md
  *
  * 缓存键规范：
  * - ai-project:{projectRoot} - AI 项目检测结果