sillyspec 3.8.5 → 3.8.7

package/src/stages/quick.js

@@ -1,64 +0,0 @@
-export const definition = {
-  name: 'quick',
-  title: '快速任务',
-  description: '跳过完整流程，直接做',
-  auxiliary: true,
-  steps: [
-    {
-      name: '理解任务',
-      prompt: `解析任务参数，加载项目上下文。
-
-### 操作
-1. 检查是否携带 \`--change <变更名>\`，确定记录方式
-2. 理解任务：模糊则问一个问题确认
-3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
-4. 加载上下文：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
-5. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
-6. 如有 \`--change\`，加载设计文档：\`cat .sillyspec/changes/<变更名>/design.md 2>/dev/null\`（理解设计意图）
-7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
-
-### 输出
-任务理解 + 上下文摘要`,
-      outputHint: '任务理解',
-      optional: false
-    },
-    {
-      name: '实现并验证',
-      prompt: `实现任务。
-
-### 操作
-1. 先读后写：调用已有方法前 \`cat\` 源文件确认签名，\`grep\` 确认方法存在
-2. 写代码完成任务
-3. 如涉及逻辑变更，建议写单元测试验证（不强制，纯配置/文档/小改动可跳过）
-4. **不要编译！** 除非用户明确要求或改动量很大
-
-### 输出
-实现摘要 + 修改文件列表
-
-### 铁律
-- 不要修改无关文件
-- 不要编造不存在的 CLI 子命令
-- **Reverse Sync**：如果发现 Bug 是 design.md 遗漏导致的，先修 design.md 再修代码`,
-      outputHint: '实现摘要',
-      optional: false
-    },
-    {
-      name: '暂存和记录',
-      prompt: `Git 暂存并记录任务。
-
-### 操作
-1. \`git add -A\` — **不要 commit**，由用户通过统一提交
-2. 记录：
-   - 有 \`--change\`：在 \`.sillyspec/changes/<变更名>/tasks.md\` 追加 task 并勾选，记录精确到秒的时间戳
-   - 无 \`--change\`：记录到 \`.sillyspec/quicklog/QUICKLOG-<git用户名>.md\`（按 git 用户名隔离）
-3. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`
-4. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
-5. 任务比预期复杂 → 建议用完整流程
-
-### 输出
-暂存确认 + 记录路径`,
-      outputHint: '暂存和记录确认',
-      optional: false
-    }
-  ]
-}

package/src/stages/scan.js

@@ -1,141 +0,0 @@
-export const definition = {
-  name: 'scan',
-  title: '代码扫描',
-  description: '分析项目结构、约定和架构',
-  auxiliary: true,
-  steps: [
-    {
-      name: '检查已有扫描文档和子项目列表',
-      prompt: `检查已有扫描文档和子项目列表。
-
-### 操作
-1. \`ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .\` — 检查已有文档
-1. \`ls docs/*/scan/ 2>/dev/null\` — 检查已有文档
-2. \`wc -l docs/*/scan/*.md 2>/dev/null\` — 文档行数
-3. 已有 3 份 → 建议升级深度扫描；已有 7 份 → 建议刷新或跳过
-5. 显示子项目列表供选择扫描范围
-
-### 输出
-已有文档状态 + 扫描建议`,
-      outputHint: '工作区和文档状态',
-      optional: false
-    },
-    {
-      name: '构建环境探测',
-      prompt: `探测项目的构建环境和依赖。
-
-### 操作
-1. \`cat package.json pom.xml build.gradle go.mod Cargo.toml requirements.txt pyproject.toml Gemfile composer.json 2>/dev/null\`
-2. \`find . -maxdepth 2 -name "*.config.*" -not -path "*/node_modules/*" -not -path "*/.git/*" | head -20 | xargs cat 2>/dev/null\`
-3. 结果保存到 \`docs/<project>/scan/_env-detect.md\`（临时文件，扫描完删除）
-
-### 输出
-环境探测结果摘要`,
-      outputHint: '环境探测摘要',
-      optional: false
-    },
-    {
-      name: '断点续扫检测',
-      prompt: `检测已有扫描文档，只生成缺失的。
-
-### 操作
-1. \`PROJECT=$(python3 -c "import sys,json; print(json.load(open('.sillyspec/.runtime/progress.json')).get('project',''))" 2>/dev/null || basename "$(pwd)")\`
-2. 检查 7 份文档是否存在：ARCHITECTURE、STRUCTURE、CONVENTIONS、INTEGRATIONS、TESTING、CONCERNS、PROJECT
-3. 列出已有 ✅ 和缺失 ⬜
-4. 只生成缺失的文档
-
-### 输出
-已有/缺失文档列表`,
-      outputHint: '断点续扫状态',
-      optional: false
-    },
-    {
-      name: '深度扫描 — 技术架构',
-      prompt: `扫描技术栈 + 数据库 Schema + 架构模式。参考 _env-detect.md。
-
-### 操作
-1. 用 grep/rg 搜索（\`@Entity\`、\`schema.prisma\`、\`models.py\` 等），**禁止读源码全文**
-2. Schema 只记表名+说明+字段数
-3. 写入 \`docs/<project>/scan/ARCHITECTURE.md\`
-4. 包含 \`## 技术栈\` \`## 架构概览\` \`## 数据模型（摘要）\`
-
-### 输出
-ARCHITECTURE.md 路径
-
-### 注意
-- 路径用反引号，不编造`,
-      outputHint: 'ARCHITECTURE.md 路径',
-      optional: false
-    },
-    {
-      name: '深度扫描 — 代码约定',
-      prompt: `扫描框架隐形规则 + 实体继承 + 代码风格。参考 _env-detect.md。
-
-### 操作
-1. 用 grep 搜索拦截器/插件/逻辑删除/基类/审计字段，**禁止读源码全文**
-2. 根据检测到的语言/框架自行决定搜索什么模式
-3. 提取 3-5 个典型示例
-4. 写入 \`docs/<project>/scan/CONVENTIONS.md\`
-5. 包含 \`## 框架隐形规则\` \`## 实体继承规范\` \`## 代码风格\`
-
-### 输出
-CONVENTIONS.md 路径
-
-### 注意
-- 路径用反引号，不编造`,
-      outputHint: 'CONVENTIONS.md 路径',
-      optional: false
-    },
-    {
-      name: '深度扫描 — 目录结构和集成',
-      prompt: `扫描目录结构 + 外部集成。参考 _env-detect.md。
-
-### 操作
-1. 用 find/ls/tree 和 grep，**禁止读源码全文**
-2. 搜索 API 调用、MQ 配置、缓存、第三方 SDK
-3. 写入 \`docs/<project>/scan/STRUCTURE.md\`（目录树+模块说明）
-4. 写入 \`docs/<project>/scan/INTEGRATIONS.md\`（按类型分组）
-
-### 输出
-STRUCTURE.md 和 INTEGRATIONS.md 路径
-
-### 注意
-- 路径用反引号，不编造`,
-      outputHint: 'STRUCTURE.md + INTEGRATIONS.md 路径',
-      optional: false
-    },
-    {
-      name: '深度扫描 — 测试和债务',
-      prompt: `扫描测试现状 + 技术债务 + 项目概览。参考 _env-detect.md。
-
-### 操作
-1. 用 grep 搜索测试文件、TODO/FIXME、过时依赖，**禁止读源码全文**
-2. 写入 \`docs/<project>/scan/TESTING.md\`（测试结构）
-3. 写入 \`docs/<project>/scan/CONCERNS.md\`（按严重程度分组）
-4. 写入 \`docs/<project>/scan/PROJECT.md\`（项目信息）
-
-### 输出
-TESTING.md、CONCERNS.md、PROJECT.md 路径`,
-      outputHint: '三份文档路径',
-      optional: false
-    },
-    {
-      name: '自检和提交',
-      prompt: `验证扫描完整性，清理并提交。
-
-### 操作
-1. 检查 7 份文档是否全部生成
-2. 自检门控：ARCHITECTURE（技术栈+Schema摘要）、CONVENTIONS（隐形规则+代码风格）、STRUCTURE（目录结构）、INTEGRATIONS（外部依赖）、TESTING（测试现状）、CONCERNS（技术债务）、PROJECT（项目概览）
-3. 清理：\`rm -f docs/<project>/scan/_env-detect.md\`
-4. \`git add .\` — **不要 commit**，由用户通过统一提交工具处理
-
-### 输出
-扫描完整性报告
-
-### 注意
-- ❌ 修改代码 / 编造路径 / 读源码全文`,
-      outputHint: '自检报告',
-      optional: false
-    }
-  ]
-}

package/src/stages/status.js

@@ -1,65 +0,0 @@
-export const definition = {
-  name: 'status',
-  title: '状态查看',
-  description: '查看项目进度和状态',
-  auxiliary: true,
-  steps: [
-    {
-      name: '项目基础信息',
-      prompt: `收集项目基础信息。
-
-### 操作
-1. \`cat .sillyspec/PROJECT.md 2>/dev/null || echo "未初始化"\`
-2. 获取 project 名
-3. \`ls docs/<project>/scan/ 2>/dev/null | head -10\`
-4. \`cat .sillyspec/REQUIREMENTS.md 2>/dev/null | head -20\`
-5. \`cat .sillyspec/ROADMAP.md 2>/dev/null\`
-
-### 输出
-项目基础信息摘要`,
-      outputHint: '项目基础信息',
-      optional: false
-    },
-    {
-      name: '变更状态',
-      prompt: `检查进行中的变更和归档历史。
-
-### 操作
-1. \`ls .sillyspec/changes/ 2>/dev/null | grep -v archive\`
-2. 对每个进行中的变更：检查 proposal.md ✅/❌、design.md ✅/❌、requirements.md ✅/❌、tasks.md — X/Y 完成
-3. \`ls .sillyspec/changes/archive/ 2>/dev/null | wc -l\`
-4. \`cat .sillyspec/HANDOFF.json 2>/dev/null\`
-
-### 输出
-变更状态列表`,
-      outputHint: '变更状态',
-      optional: false
-    },
-    {
-      name: '输出状态报告',
-      prompt: `生成完整状态报告。
-
-### 输出格式：
-\`\`\`
-📊 SillySpec 状态
-
-📋 项目：xxx（已初始化 / 未初始化）
-📂 代码库：已扫描（7 份文档）/ 未扫描
-
-🔄 进行中：N 个变更
-  - [change-1] Phase 3 (Execute) — tasks 5/8
-
-✅ 已归档：N 个变更
-📝 设计文档：N 份
-📝 实现计划：N 份
-
-💡 下一步：/sillyspec:continue
-\`\`\`
-
-### 注意
-- 不修改任何文件`,
-      outputHint: '状态报告',
-      optional: false
-    }
-  ]
-}

package/src/stages/verify.js

@@ -1,135 +0,0 @@
-export const definition = {
-  name: 'verify',
-  title: '验证确认',
-  description: '对照规范检查 + 测试套件',
-  steps: [
-    {
-      name: '状态检查',
-      prompt: `检查当前状态，确认可以执行 verify。
-
-### 操作
-1. 运行 \`sillyspec progress show\`
-2. 确认 currentStage 为 "verify"
-
-### 输出
-当前状态摘要`,
-      outputHint: '状态摘要',
-      optional: false
-    },
-    {
-      name: '加载规范并锚定',
-      prompt: `加载规范文件并确认。
-
-### 操作
-1. 读取 proposal.md、design.md、tasks.md、requirements.md
-2. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
-3. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、lint 命令等）
-4. 加载代码规范：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
-5. 标注每个文件的存在/不存在状态
-
-### 输出
-文件加载确认清单`,
-      outputHint: '文件确认清单',
-      optional: false
-    },
-    {
-      name: '逐项检查任务',
-      prompt: `对照 tasks.md 检查每个任务完成状态。
-
-### 操作
-对每个 checkbox：
-1. 检查相关文件是否存在
-2. 检查代码是否实现了描述的功能
-3. 标记：✅ 已完成 / ❌ 未完成 / ⚠️ 部分完成
-
-### 批量模式验证指引
-如果 tasks.md 中有批量特征（引擎/模板/配置/批量生成），采用分层验证：
-- **L1 自动化（100%）**：运行验证脚本（如有），检查所有实例的文件存在、格式正确、Schema 校验通过
-- **L2 AI 抽查（5-10 个）**：选择最复杂的 3 个 + 最简单的 2 个 + 有特殊逻辑的，检查业务逻辑正确性
-- **L3 模式性 bug 检测**：L2 发现 bug → 判断是否为系统性问题 → 系统性 bug 则回退修复引擎并重新生成所有实例
-
-### 输出
-任务完成度列表 + 完成率
-
-### 注意
-- 不修改任何代码，只做检查和报告`,
-      outputHint: '任务完成度报告',
-      optional: false
-    },
-    {
-      name: '对照设计检查',
-      prompt: `对照 design.md 检查实现一致性。**design.md 是唯一 truth source，不符合 design.md 的实现 = Bug。**
-
-### 操作
-1. 架构决策是否遵循
-2. 文件变更清单是否一致
-3. 数据模型是否符合
-4. API 设计是否符合
-5. **Reverse Sync 检查**：如果发现实现合理但 design.md 未覆盖，先更新 design.md 补充遗漏
-
-### 输出
-一致性检查结果`,
-      outputHint: '设计一致性报告',
-      optional: false
-    },
-    {
-      name: '任务蓝图验收',
-      prompt: `检查每个 task-N.md 的验收标准是否全部满足。
-
-### 操作
-1. 检查变更目录下 tasks/ 是否存在
-2. 如果存在：
-   - 逐个读取 tasks/task-NN.md
-   - 检查每个文件的「验收标准」checkbox 是否全部勾选
-   - 未勾选的项列为不通过
-3. 如果不存在：跳过此步骤
-
-### 输出
-验收结果：通过/不通过 + 未通过的项`,
-      outputHint: '验收结果',
-      optional: false
-    },
-    {
-      name: '运行测试和质量扫描',
-      prompt: `运行测试和代码质量扫描。
-
-### 操作
-1. 读取 \`.sillyspec/local.yaml\` 获取构建和测试命令
-2. 如果 local.yaml 有 test 命令，使用它（仅测试变更涉及的模块，非全量）
-3. 如果 local.yaml 无 test 命令，根据项目类型选择：
-   - Maven：\`mvn test -pl <变更模块> -am\`（仅编译变更模块及其依赖）
-   - Gradle：\`./gradlew :<模块>:test\`
-   - npm/pnpm：\`pnpm test --filter=<包名>\` 或 \`npm test -- --testPathPattern=<相关文件>\`
-   - Python：\`pytest <变更模块路径>/\`
-4. 记录通过/失败数量，分析失败原因
-5. 搜索技术债务：grep TODO/FIXME/HACK/XXX（仅限变更文件）
-6. 如果 local.yaml 有 lint 命令，运行 lint 检查
-
-### 注意
-- 不要全量编译/测试整个项目，只测变更涉及的模块
-- 如果变更模块不确定，优先使用 local.yaml 中的命令
-
-### 输出
-测试结果 + 技术债务标记`,
-      outputHint: '测试结果 + 技术债务',
-      optional: false
-    },
-    {
-      name: '输出验证报告',
-      prompt: `生成完整验证报告。
-
-### 操作
-1. 汇总以上所有检查结果
-2. 给出结论：PASS / PASS WITH NOTES / FAIL
-
-### 输出
-验证报告 markdown + 下一步命令
-
-### 注意
-- PASS → 下一步 archive
-- FAIL → 修复后重新 verify`,
-      outputHint: '验证报告',
-      optional: false
-    }
-  ]
-}