sillyspec 3.8.4 → 3.8.6

package/docs/.vitepress/dist/assets/sillyspec_commands.md.CXFFsj08.js

@@ -0,0 +1,15 @@
+import{_ as i,o as a,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const c=JSON.parse('{"title":"命令参考","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/commands.md","filePath":"sillyspec/commands.md"}'),h={name:"sillyspec/commands.md"};function l(n,s,p,k,r,d){return a(),t("div",null,[...s[0]||(s[0]=[e(`<h1 id="命令参考" tabindex="-1">命令参考 <a class="header-anchor" href="#命令参考" aria-label="Permalink to &quot;命令参考&quot;">​</a></h1><h2 id="核心流程" tabindex="-1">核心流程 <a class="header-anchor" href="#核心流程" aria-label="Permalink to &quot;核心流程&quot;">​</a></h2><h3 id="init-—-绿地项目初始化" tabindex="-1">init — 绿地项目初始化 <a class="header-anchor" href="#init-—-绿地项目初始化" aria-label="Permalink to &quot;init — 绿地项目初始化&quot;">​</a></h3><p><strong>用途：</strong> 深度提问、调研、生成需求文档和路线图。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div><p>适用于空目录或新项目。会通过一系列问题挖掘需求，生成项目路线图。</p><hr><h3 id="scan-—-代码库扫描" tabindex="-1">scan — 代码库扫描 <a class="header-anchor" href="#scan-—-代码库扫描" aria-label="Permalink to &quot;scan — 代码库扫描&quot;">​</a></h3><p><strong>用途：</strong> 交互式引导扫描已有代码库，生成代码库文档。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> scan</span></span></code></pre></div><p>支持快速扫描和深度扫描两阶段。深度扫描会提取代码风格、注解、返回值等信息。</p><hr><h3 id="brainstorm-—-需求探索" tabindex="-1">brainstorm — 需求探索 <a class="header-anchor" href="#brainstorm-—-需求探索" aria-label="Permalink to &quot;brainstorm — 需求探索&quot;">​</a></h3><p><strong>用途：</strong> 结构化头脑风暴，直接产出 design.md + proposal.md + requirements.md + tasks.md。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> brainstorm</span></span></code></pre></div><p>创建性工作前的必用命令。合并了 propose 功能，一次性生成所有规范文件。包含批量/半批量模式检测。</p><hr><h3 id="plan-—-实现计划" tabindex="-1">plan — 实现计划 <a class="header-anchor" href="#plan-—-实现计划" aria-label="Permalink to &quot;plan — 实现计划&quot;">​</a></h3><p><strong>用途：</strong> 编写实现计划，plan.md 总览 + tasks/task-N.md 独立蓝图。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> plan</span></span></code></pre></div><p>按 Wave 分组任务，每个任务产出独立的 task-N.md 蓝图（接口定义、数据结构、边界处理、TDD 步骤、验收标准）。plan.md 只放总览，不写实现细节。</p><hr><h3 id="execute-—-执行实现" tabindex="-1">execute — 执行实现 <a class="header-anchor" href="#execute-—-执行实现" aria-label="Permalink to &quot;execute — 执行实现&quot;">​</a></h3><p><strong>用途：</strong> 波次执行，按 task 蓝图搬砖，禁止发散思维。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> execute</span></span></code></pre></div><p>CLI 自动注入 task-N.md 内容到 prompt。上下文分层加载（热/温/冷）。不频繁编译，只在必要时运行。</p><p><strong>铁律：</strong></p><ul><li>task-N.md 是唯一执行蓝图，只做蓝图里写的事，不增不减不改</li><li>发现问题停下来反馈，不要自己改方案</li><li>Reverse Sync：发现 Bug 先检查文档是否有遗漏</li></ul><hr><h3 id="verify-—-验证-可选" tabindex="-1">verify — 验证（可选） <a class="header-anchor" href="#verify-—-验证-可选" aria-label="Permalink to &quot;verify — 验证（可选）&quot;">​</a></h3><p><strong>用途：</strong> 对照文档检查 + 测试套件 + 代码审查 + 任务蓝图验收。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> verify</span></span></code></pre></div><p>分层验证：逐项检查任务 → 对照 design.md → 任务蓝图验收 → 运行测试 → 代码质量扫描。支持批量模式分层验证（L1 自动化 / L2 AI 抽查 / L3 模式性 bug 检测）。</p><hr><h3 id="archive-—-归档" tabindex="-1">archive — 归档 <a class="header-anchor" href="#archive-—-归档" aria-label="Permalink to &quot;archive — 归档&quot;">​</a></h3><p><strong>用途：</strong> 规范沉淀到 knowledge/，可追溯。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> archive</span></span></code></pre></div><p>五道门禁：文件完整性、任务完成度、spec 沉淀、防覆盖。</p><hr><h3 id="doctor-—-项目自检" tabindex="-1">doctor — 项目自检 <a class="header-anchor" href="#doctor-—-项目自检" aria-label="Permalink to &quot;doctor — 项目自检&quot;">​</a></h3><p><strong>用途：</strong> 4 步自检，检查配置、构建环境和外部依赖。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> doctor</span></span></code></pre></div><p>步骤：SillySpec 内部检查 → 构建与测试检查 → 外部依赖检查 → 生成诊断报告。包含 deriveState 全量扫描。</p><hr><h3 id="auto-—-全流程自动推进" tabindex="-1">auto — 全流程自动推进 <a class="header-anchor" href="#auto-—-全流程自动推进" aria-label="Permalink to &quot;auto — 全流程自动推进&quot;">​</a></h3><p><strong>用途：</strong> 自动执行 brainstorm → plan → execute → verify。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> auto</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;需求描述&quot;</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> auto</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --input</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;需求&quot;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --done</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --output</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;摘要&quot;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 推进下一步</span></span></code></pre></div><p>自动模式，AI 按步骤自动推进。支持阶段审核门控——brainstorm/plan 完成后可选多角度子代理审查。</p><hr><h2 id="辅助工具" tabindex="-1">辅助工具 <a class="header-anchor" href="#辅助工具" aria-label="Permalink to &quot;辅助工具&quot;">​</a></h2><h3 id="quick-—-快速模式" tabindex="-1">quick — 快速模式 <a class="header-anchor" href="#quick-—-快速模式" aria-label="Permalink to &quot;quick — 快速模式&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> quick</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;任务描述&quot;</span></span></code></pre></div><p>跳过完整流程，直接做。3 步完成：理解任务 → 实现并验证 → 暂存和记录。支持 <code>--change xxx</code> 追加到变更 tasks.md。</p><hr><h3 id="explore-—-自由思考" tabindex="-1">explore — 自由思考 <a class="header-anchor" href="#explore-—-自由思考" aria-label="Permalink to &quot;explore — 自由思考&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> explore</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;想法&quot;</span></span></code></pre></div><p>讨论、画图、调研，不写代码。</p><hr><h3 id="commit-—-智能提交" tabindex="-1">commit — 智能提交 <a class="header-anchor" href="#commit-—-智能提交" aria-label="Permalink to &quot;commit — 智能提交&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:commit</span></span></code></pre></div><p>自动收集变更信息（QUICKLOG/tasks.md/阶段产出），生成 commit message。</p><hr><h3 id="status-state-—-查看进度" tabindex="-1">status / state — 查看进度 <a class="header-anchor" href="#status-state-—-查看进度" aria-label="Permalink to &quot;status / state — 查看进度&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    # 查看进度（含批量进度条）</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:state</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">           # 显示 progress.json 内容</span></span></code></pre></div><hr><h3 id="resume-continue-—-恢复工作" tabindex="-1">resume / continue — 恢复工作 <a class="header-anchor" href="#resume-continue-—-恢复工作" aria-label="Permalink to &quot;resume / continue — 恢复工作&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:resume</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">          # 从中断处继续</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:continue</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">        # 自动判断下一步</span></span></code></pre></div><hr><h3 id="export-—-导出模板" tabindex="-1">export — 导出模板 <a class="header-anchor" href="#export-—-导出模板" aria-label="Permalink to &quot;export — 导出模板&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:export</span></span></code></pre></div><p>导出成功方案为可复用模板。</p><hr><h3 id="progress-—-进度管理" tabindex="-1">progress — 进度管理 <a class="header-anchor" href="#progress-—-进度管理" aria-label="Permalink to &quot;progress — 进度管理&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> show</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">      # 查看进度</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> reset</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">     # 重置进度</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> validate</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 校验修复</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> batch</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --total</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 100</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --completed</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 73</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 更新批量进度</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> batch</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">                   # 查看批量进度</span></span></code></pre></div><h3 id="run-—-步骤驱动流程引擎" tabindex="-1">run — 步骤驱动流程引擎 <a class="header-anchor" href="#run-—-步骤驱动流程引擎" aria-label="Permalink to &quot;run — 步骤驱动流程引擎&quot;">​</a></h3><p><strong>用途：</strong> CLI 控制的阶段流程，AI 通过此命令驱动每个阶段。</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">           # 进入指定阶段</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 查看阶段进度</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --done</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    # 标记当前步骤完成</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --done</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --output</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> &quot;摘要&quot;</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 标记完成 + 记录输出</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --skip</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    # 跳过可选步骤</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> run</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> &lt;</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">stag</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">e</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">&gt;</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --reset</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">   # 重置阶段</span></span></code></pre></div><p>支持的阶段：<code>scan</code>、<code>brainstorm</code>、<code>plan</code>、<code>execute</code>、<code>verify</code>、<code>doctor</code>。</p><h2 id="其他-cli-命令" tabindex="-1">其他 CLI 命令 <a class="header-anchor" href="#其他-cli-命令" aria-label="Permalink to &quot;其他 CLI 命令&quot;">​</a></h2><h3 id="dashboard-—-启动面板" tabindex="-1">dashboard — 启动面板 <a class="header-anchor" href="#dashboard-—-启动面板" aria-label="Permalink to &quot;dashboard — 启动面板&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dashboard</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">              # 默认端口 3456</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dashboard</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --port</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 8080</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 指定端口</span></span></code></pre></div><h3 id="setup-—-mcp-工具安装" tabindex="-1">setup — MCP 工具安装 <a class="header-anchor" href="#setup-—-mcp-工具安装" aria-label="Permalink to &quot;setup — MCP 工具安装&quot;">​</a></h3><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">          # 安装推荐 MCP 工具</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --list</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">   # 查看状态</span></span></code></pre></div>`,83)])])}const g=i(h,[["render",l]]);export{c as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_commands.md.CXFFsj08.lean.js

@@ -0,0 +1 @@
+import{_ as i,o as a,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const c=JSON.parse('{"title":"命令参考","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/commands.md","filePath":"sillyspec/commands.md"}'),h={name:"sillyspec/commands.md"};function l(n,s,p,k,r,d){return a(),t("div",null,[...s[0]||(s[0]=[e("",83)])])}const g=i(h,[["render",l]]);export{c as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_dashboard.md.BuPXHqjX.js

@@ -0,0 +1,4 @@
+import{_ as s,o as i,c as e,ae as t}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"Dashboard","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/dashboard.md","filePath":"sillyspec/dashboard.md"}'),l={name:"sillyspec/dashboard.md"};function n(h,a,o,r,p,d){return i(),e("div",null,[...a[0]||(a[0]=[t(`<h1 id="dashboard" tabindex="-1">Dashboard <a class="header-anchor" href="#dashboard" aria-label="Permalink to &quot;Dashboard&quot;">​</a></h1><h2 id="启动" tabindex="-1">启动 <a class="header-anchor" href="#启动" aria-label="Permalink to &quot;启动&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dashboard</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">              # 默认端口 3456</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dashboard</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --port</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 8080</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">  # 指定端口</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> dashboard</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --no-open</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    # 不自动打开浏览器</span></span></code></pre></div><h2 id="功能" tabindex="-1">功能 <a class="header-anchor" href="#功能" aria-label="Permalink to &quot;功能&quot;">​</a></h2><h3 id="📂-项目发现" tabindex="-1">📂 项目发现 <a class="header-anchor" href="#📂-项目发现" aria-label="Permalink to &quot;📂 项目发现&quot;">​</a></h3><p>自动扫描当前目录及子目录中的 <code>.sillyspec/</code> 项目，显示项目列表和状态。</p><h3 id="🔄-流水线视图" tabindex="-1">🔄 流水线视图 <a class="header-anchor" href="#🔄-流水线视图" aria-label="Permalink to &quot;🔄 流水线视图&quot;">​</a></h3><p>可视化展示项目的工作流阶段：</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>scan → brainstorm → plan → execute → verify → archive</span></span>
+<span class="line"><span>  ✅       ✅        ✅      🔄       ⏳</span></span></code></pre></div><p>每个阶段的完成状态一目了然。</p><h3 id="📄-文档浏览" tabindex="-1">📄 文档浏览 <a class="header-anchor" href="#📄-文档浏览" aria-label="Permalink to &quot;📄 文档浏览&quot;">​</a></h3><p>浏览项目中 <code>.sillyspec/docs/</code> 下的所有文档，按类型分组：</p><ul><li><strong>scan/</strong> — 代码库扫描文档</li><li><strong>brainstorm/</strong> — 头脑风暴和设计文档</li><li><strong>plan/</strong> — 实现计划</li><li><strong>changes/</strong> — 变更记录</li><li><strong>archive/</strong> — 归档文档</li><li><strong>quicklog/</strong> — 快速任务日志</li></ul><h2 id="统一文档管理" tabindex="-1">统一文档管理 <a class="header-anchor" href="#统一文档管理" aria-label="Permalink to &quot;统一文档管理&quot;">​</a></h2><p>Dashboard 支持新的统一文档结构，所有项目文档集中管理在 <code>.sillyspec/docs/&lt;project&gt;/</code> 下。</p><h3 id="迁移旧结构" tabindex="-1">迁移旧结构 <a class="header-anchor" href="#迁移旧结构" aria-label="Permalink to &quot;迁移旧结构&quot;">​</a></h3><p>如果你有旧版的 <code>.sillyspec/</code> 目录（codebase/、specs/、changes/ 等），可以迁移：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> docs</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> migrate</span></span></code></pre></div><p>会自动将旧路径的文档迁移到新的统一结构。</p>`,19)])])}const b=s(l,[["render",n]]);export{k as __pageData,b as default};

package/docs/.vitepress/dist/assets/sillyspec_dashboard.md.BuPXHqjX.lean.js

@@ -0,0 +1 @@
+import{_ as s,o as i,c as e,ae as t}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"Dashboard","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/dashboard.md","filePath":"sillyspec/dashboard.md"}'),l={name:"sillyspec/dashboard.md"};function n(h,a,o,r,p,d){return i(),e("div",null,[...a[0]||(a[0]=[t("",19)])])}const b=s(l,[["render",n]]);export{k as __pageData,b as default};

package/docs/.vitepress/dist/assets/sillyspec_file-io.md.Cz3x7llx.js

@@ -0,0 +1 @@
+import{_ as r,o as d,c as e,ae as a}from"./chunks/framework.Czhw_PXq.js";const h=JSON.parse('{"title":"各阶段文件读写一览","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/file-io.md","filePath":"sillyspec/file-io.md"}'),s={name:"sillyspec/file-io.md"};function o(l,t,m,n,b,i){return d(),e("div",null,[...t[0]||(t[0]=[a('<h1 id="各阶段文件读写一览" tabindex="-1">各阶段文件读写一览 <a class="header-anchor" href="#各阶段文件读写一览" aria-label="Permalink to &quot;各阶段文件读写一览&quot;">​</a></h1><table tabindex="0"><thead><tr><th>阶段</th><th>📥 读取</th><th>📤 产出</th></tr></thead><tbody><tr><td><strong>brainstorm</strong></td><td>CODEBASE-OVERVIEW.md<br>projects/*.yaml<br>local.yaml<br>STRUCTURE.md（棕地）<br>CONVENTIONS.md（棕地）<br>ARCHITECTURE.md（棕地）<br>changes/（进行中）<br>~/.sillyspec/templates/</td><td>design.md<br>proposal.md<br>requirements.md<br>tasks.md</td></tr><tr><td><strong>plan</strong></td><td>CODEBASE-OVERVIEW.md<br>proposal.md<br>design.md<br>requirements.md<br>tasks.md<br>CONVENTIONS.md<br>ARCHITECTURE.md<br>STACK.md<br>local.yaml</td><td>plan.md（总览）<br>tasks/task-NN.md（蓝图）</td></tr><tr><td><strong>execute</strong></td><td>design.md<br>plan.md<br>tasks/task-NN.md（CLI 自动注入）<br>CONVENTIONS.md（按需）<br>ARCHITECTURE.md（按需）<br>local.yaml<br>CODEBASE-OVERVIEW.md<br>knowledge/INDEX.md</td><td>代码文件<br>勾选 task-N.md + plan.md checkbox</td></tr><tr><td><strong>verify</strong></td><td>proposal.md<br>design.md<br>tasks.md<br>requirements.md<br>projects/*.yaml<br>local.yaml<br>CONVENTIONS.md<br>tasks/task-NN.md</td><td>验证报告<br>可能更新 design.md（Reverse Sync）</td></tr><tr><td><strong>quick</strong></td><td>projects/*.yaml<br>CONVENTIONS.md<br>local.yaml<br>knowledge/INDEX.md<br>design.md（有 --change）</td><td>代码文件<br>tasks.md（有 --change）<br>QUICKLOG</td></tr><tr><td><strong>scan</strong></td><td>projects/<em>.yaml<br>已有 scan/</em>.md<br>package.json / pom.xml 等<br>源文件（grep 搜索）</td><td>ARCHITECTURE.md<br>CONVENTIONS.md<br>STRUCTURE.md<br>INTEGRATIONS.md<br>TESTING.md<br>CONCERNS.md<br>PROJECT.md</td></tr><tr><td><strong>archive</strong></td><td>tasks.md<br>changes/&lt;变更名&gt;/ 目录下文件</td><td>archive/YYYY-MM-DD-&lt;变更名&gt;/（移动）<br>更新 progress.json</td></tr><tr><td><strong>doctor</strong></td><td>progress.json<br>projects/*.yaml<br>local.yaml<br>MCP 配置<br>构建文件</td><td>无（只检查报告）</td></tr></tbody></table><h2 id="全局注入-每个-step" tabindex="-1">全局注入（每个 step） <a class="header-anchor" href="#全局注入-每个-step" aria-label="Permalink to &quot;全局注入（每个 step）&quot;">​</a></h2><h3 id="persona" tabindex="-1">Persona <a class="header-anchor" href="#persona" aria-label="Permalink to &quot;Persona&quot;">​</a></h3><table tabindex="0"><thead><tr><th>阶段</th><th>角色</th></tr></thead><tbody><tr><td>brainstorm</td><td>🎯 资深架构师</td></tr><tr><td>plan</td><td>📋 技术项目经理</td></tr><tr><td>execute</td><td>💻 高级工程师</td></tr><tr><td>verify</td><td>🔍 QA 专家</td></tr><tr><td>quick</td><td>💻 全栈老兵</td></tr></tbody></table><h3 id="铁律" tabindex="-1">铁律 <a class="header-anchor" href="#铁律" aria-label="Permalink to &quot;铁律&quot;">​</a></h3><ol><li>文档是核心资产，代码是文档的产物</li><li>只做本步骤描述的操作，不得自行扩展或跳过</li><li>不要回头修改已完成的步骤</li><li>不要编造不存在的 CLI 子命令</li><li>完成后立即执行 <code>--done</code> 命令</li><li>文档类型文件头部必须包含 author 和 created_at</li><li>执行构建/测试前必须先读 local.yaml</li></ol>',7)])])}const p=r(s,[["render",o]]);export{h as __pageData,p as default};

package/docs/.vitepress/dist/assets/sillyspec_file-io.md.Cz3x7llx.lean.js

@@ -0,0 +1 @@
+import{_ as r,o as d,c as e,ae as a}from"./chunks/framework.Czhw_PXq.js";const h=JSON.parse('{"title":"各阶段文件读写一览","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/file-io.md","filePath":"sillyspec/file-io.md"}'),s={name:"sillyspec/file-io.md"};function o(l,t,m,n,b,i){return d(),e("div",null,[...t[0]||(t[0]=[a("",7)])])}const p=r(s,[["render",o]]);export{h as __pageData,p as default};

package/docs/.vitepress/dist/assets/sillyspec_getting-started.md.ClcvV8k3.js

@@ -0,0 +1,4 @@
+import{_ as t,o as a,c as i,ae as e}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"快速上手","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/getting-started.md","filePath":"sillyspec/getting-started.md"}'),l={name:"sillyspec/getting-started.md"};function n(d,s,p,o,h,c){return a(),i("div",null,[...s[0]||(s[0]=[e(`<h1 id="快速上手" tabindex="-1">快速上手 <a class="header-anchor" href="#快速上手" aria-label="Permalink to &quot;快速上手&quot;">​</a></h1><h2 id="安装" tabindex="-1">安装 <a class="header-anchor" href="#安装" aria-label="Permalink to &quot;安装&quot;">​</a></h2><p><strong>推荐全局安装</strong>，直接使用 <code>sillyspec</code> 命令：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> i</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -g</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sillyspec@latest</span></span></code></pre></div><blockquote><p>⚠️ 需要 Node.js &gt;= 18。</p></blockquote><h2 id="初始化项目" tabindex="-1">初始化项目 <a class="header-anchor" href="#初始化项目" aria-label="Permalink to &quot;初始化项目&quot;">​</a></h2><p>进入你的项目目录，运行：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span></span></code></pre></div><p>零交互，自动检测你用的 AI 工具并安装对应模板。</p><p><strong>指定工具：</strong></p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --tool</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> claude</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --tool</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> cursor</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --tool</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> openclaw</span></span></code></pre></div><h2 id="选择入口" tabindex="-1">选择入口 <a class="header-anchor" href="#选择入口" aria-label="Permalink to &quot;选择入口&quot;">​</a></h2><p>根据你的情况，选一个开始：</p><table tabindex="0"><thead><tr><th>场景</th><th>命令</th><th>说明</th></tr></thead><tbody><tr><td>🟢 绿地项目（空目录）</td><td><code>/sillyspec:init</code></td><td>深度提问 → 需求文档 → 路线图</td></tr><tr><td>🟤 棕地项目（有代码）</td><td><code>/sillyspec:scan</code></td><td>交互式扫描代码库</td></tr><tr><td>💡 自由思考</td><td><code>/sillyspec:explore &quot;想法&quot;</code></td><td>讨论、画图、调研，不写代码</td></tr><tr><td>🧩 大模块</td><td><code>/sillyspec:brainstorm</code></td><td>直接贴原型图</td></tr><tr><td>🩺 项目自检</td><td><code>sillyspec run doctor</code></td><td>4 步自检环境</td></tr></tbody></table><h2 id="基本工作流" tabindex="-1">基本工作流 <a class="header-anchor" href="#基本工作流" aria-label="Permalink to &quot;基本工作流&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>绿地：init → brainstorm → plan → execute → [verify] → archive</span></span>
+<span class="line"><span>棕地：scan → brainstorm → plan → execute → [verify] → archive</span></span></code></pre></div><p>AI 通过 <code>sillyspec run &lt;stage&gt;</code> 命令驱动流程，每个阶段的进度由 progress.json 自动追踪。</p><p>也可以跳过流程：</p><ul><li>小 bug：<code>/sillyspec:quick &quot;修复 xxx&quot;</code></li><li>不确定要做什么：<code>/sillyspec:explore &quot;想法&quot;</code></li><li>中断恢复：<code>/sillyspec:resume</code></li><li>不知道下一步：<code>/sillyspec:continue</code></li></ul><h2 id="skills-说明" tabindex="-1">Skills 说明 <a class="header-anchor" href="#skills-说明" aria-label="Permalink to &quot;Skills 说明&quot;">​</a></h2><p>SillySpec 的 skills 已精简为核心流程，每个 skill 对应一个明确阶段，不再有多余的中间层。</p>`,21)])])}const g=t(l,[["render",n]]);export{k as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_getting-started.md.ClcvV8k3.lean.js

@@ -0,0 +1 @@
+import{_ as t,o as a,c as i,ae as e}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"快速上手","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/getting-started.md","filePath":"sillyspec/getting-started.md"}'),l={name:"sillyspec/getting-started.md"};function n(d,s,p,o,h,c){return a(),i("div",null,[...s[0]||(s[0]=[e("",21)])])}const g=t(l,[["render",n]]);export{k as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_install.md.CKuR2tiT.js

@@ -0,0 +1,5 @@
+import{_ as i,o as a,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const r=JSON.parse('{"title":"安装指南","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/install.md","filePath":"sillyspec/install.md"}'),l={name:"sillyspec/install.md"};function d(n,s,h,p,o,c){return a(),t("div",null,[...s[0]||(s[0]=[e(`<h1 id="安装指南" tabindex="-1">安装指南 <a class="header-anchor" href="#安装指南" aria-label="Permalink to &quot;安装指南&quot;">​</a></h1><h2 id="系统要求" tabindex="-1">系统要求 <a class="header-anchor" href="#系统要求" aria-label="Permalink to &quot;系统要求&quot;">​</a></h2><ul><li><strong>Node.js</strong> &gt;= 18</li><li>支持 macOS / Linux / Windows</li></ul><h2 id="安装" tabindex="-1">安装 <a class="header-anchor" href="#安装" aria-label="Permalink to &quot;安装&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> i</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -g</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sillyspec@latest</span></span></code></pre></div><blockquote><p>💡 <strong>推荐全局安装</strong>，安装后直接使用 <code>sillyspec</code> 命令。</p></blockquote><h2 id="升级" tabindex="-1">升级 <a class="header-anchor" href="#升级" aria-label="Permalink to &quot;升级&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> i</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -g</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> sillyspec@latest</span></span></code></pre></div><p>就这么简单，覆盖安装即可。</p><h2 id="支持的-ai-工具" tabindex="-1">支持的 AI 工具 <a class="header-anchor" href="#支持的-ai-工具" aria-label="Permalink to &quot;支持的 AI 工具&quot;">​</a></h2><table tabindex="0"><thead><tr><th>工具</th><th><code>--tool</code> 参数</th><th>输出目录</th><th>格式</th></tr></thead><tbody><tr><td>Claude Code (commands)</td><td><code>claude</code></td><td><code>.claude/commands/sillyspec/</code></td><td>slash commands</td></tr><tr><td>Claude Code (skills)</td><td><code>claude_skills</code></td><td><code>.claude/skills/sillyspec-&lt;name&gt;/</code></td><td>SKILL.md</td></tr><tr><td>Cursor</td><td><code>cursor</code></td><td><code>.cursor/commands/</code></td><td>custom commands</td></tr><tr><td>Codex</td><td><code>codex</code></td><td><code>~/.agents/skills/sillyspec-&lt;name&gt;/</code></td><td>SKILL.md</td></tr><tr><td>OpenCode</td><td><code>opencode</code></td><td><code>.opencode/skills/sillyspec-&lt;name&gt;/</code></td><td>SKILL.md</td></tr><tr><td>OpenClaw</td><td><code>openclaw</code></td><td><code>.openclaw/skills/sillyspec-&lt;name&gt;/</code></td><td>SKILL.md</td></tr></tbody></table><h2 id="init-选项" tabindex="-1">init 选项 <a class="header-anchor" href="#init-选项" aria-label="Permalink to &quot;init 选项&quot;">​</a></h2><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">                    # 自动检测工具</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --tool</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> claude</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">      # 指定工具</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --interactive</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">      # 交互式引导</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> init</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --dir</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> /path/to</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">    # 指定目录</span></span></code></pre></div><h2 id="mcp-增强" tabindex="-1">MCP 增强 <a class="header-anchor" href="#mcp-增强" aria-label="Permalink to &quot;MCP 增强&quot;">​</a></h2><p>安装推荐的 MCP 工具（如 Playwright、文件搜索等）：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">          # 安装</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> setup</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --list</span><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">   # 查看已安装状态</span></span></code></pre></div>`,16)])])}const g=i(l,[["render",d]]);export{r as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_install.md.CKuR2tiT.lean.js

@@ -0,0 +1 @@
+import{_ as i,o as a,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const r=JSON.parse('{"title":"安装指南","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/install.md","filePath":"sillyspec/install.md"}'),l={name:"sillyspec/install.md"};function d(n,s,h,p,o,c){return a(),t("div",null,[...s[0]||(s[0]=[e("",16)])])}const g=i(l,[["render",d]]);export{r as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_lifecycle.md.DY293cR1.js

@@ -0,0 +1,28 @@
+import{_ as a,o as i,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"生命周期","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/lifecycle.md","filePath":"sillyspec/lifecycle.md"}'),n={name:"sillyspec/lifecycle.md"};function l(p,s,h,o,d,r){return i(),t("div",null,[...s[0]||(s[0]=[e(`<h1 id="生命周期" tabindex="-1">生命周期 <a class="header-anchor" href="#生命周期" aria-label="Permalink to &quot;生命周期&quot;">​</a></h1><h2 id="核心理念" tabindex="-1">核心理念 <a class="header-anchor" href="#核心理念" aria-label="Permalink to &quot;核心理念&quot;">​</a></h2><blockquote><p><strong>Code is Cheap, Context is Expensive.</strong> 文档是核心资产，代码是文档的产物。没有文档就没有代码——文档是 AI 的记忆，是团队协作的基础，是后续维护的唯一依据。</p></blockquote><h2 id="工作流" tabindex="-1">工作流 <a class="header-anchor" href="#工作流" aria-label="Permalink to &quot;工作流&quot;">​</a></h2><h3 id="🟢-绿地项目-空目录" tabindex="-1">🟢 绿地项目（空目录） <a class="header-anchor" href="#🟢-绿地项目-空目录" aria-label="Permalink to &quot;🟢 绿地项目（空目录）&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>init → brainstorm → plan → execute → [verify] → archive</span></span></code></pre></div><h3 id="🟤-棕地项目-有代码" tabindex="-1">🟤 棕地项目（有代码） <a class="header-anchor" href="#🟤-棕地项目-有代码" aria-label="Permalink to &quot;🟤 棕地项目（有代码）&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>scan → brainstorm → plan → execute → [verify] → archive</span></span></code></pre></div><h3 id="🩺-项目自检" tabindex="-1">🩺 项目自检 <a class="header-anchor" href="#🩺-项目自检" aria-label="Permalink to &quot;🩺 项目自检&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>sillyspec run doctor</span></span></code></pre></div><p>4 步自检：SillySpec 内部检查 → 构建与测试检查 → 外部依赖检查 → 生成诊断报告。</p><h3 id="🤖-自动模式" tabindex="-1">🤖 自动模式 <a class="header-anchor" href="#🤖-自动模式" aria-label="Permalink to &quot;🤖 自动模式&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>sillyspec run auto &quot;需求描述&quot;</span></span></code></pre></div><p>全流程自动推进，支持阶段审核门控（复杂需求可选多角度子代理审查）。</p><h3 id="⚡-快速通道" tabindex="-1">⚡ 快速通道 <a class="header-anchor" href="#⚡-快速通道" aria-label="Permalink to &quot;⚡ 快速通道&quot;">​</a></h3><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>quick &quot;描述&quot; → 直接执行（3 步：理解任务 → 实现并验证 → 暂存和记录）</span></span>
+<span class="line"><span>explore &quot;想法&quot; → 讨论不写码</span></span></code></pre></div><h2 id="角色分工" tabindex="-1">角色分工 <a class="header-anchor" href="#角色分工" aria-label="Permalink to &quot;角色分工&quot;">​</a></h2><p>每个阶段有专属 persona，由 CLI 自动注入：</p><table tabindex="0"><thead><tr><th>阶段</th><th>角色</th><th>职责</th></tr></thead><tbody><tr><td>brainstorm</td><td>🎯 资深架构师</td><td>理解业务本质，设计技术方案，决策附理由</td></tr><tr><td>plan</td><td>📋 技术项目经理</td><td>任务拆解，Wave 分组，依赖关系</td></tr><tr><td>execute</td><td>💻 高级工程师</td><td>按 task 蓝图搬砖，禁止发散思维</td></tr><tr><td>verify</td><td>🔍 QA 专家</td><td>对照文档检查，假设所有代码都有 bug</td></tr><tr><td>quick</td><td>💻 全栈老兵</td><td>快速理解需求，直接干，不确定就问</td></tr></tbody></table><p><strong>铁律：每个角色只做自己的事，不要越界。</strong> 发现问题反馈而不是自己偷偷改。</p><h2 id="文档体系" tabindex="-1">文档体系 <a class="header-anchor" href="#文档体系" aria-label="Permalink to &quot;文档体系&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>.sillyspec/</span></span>
+<span class="line"><span>├── changes/&lt;变更名&gt;/</span></span>
+<span class="line"><span>│   ├── design.md          # 设计文档（brainstorm 产出）</span></span>
+<span class="line"><span>│   ├── requirements.md    # 需求文档</span></span>
+<span class="line"><span>│   ├── proposal.md        # 提案</span></span>
+<span class="line"><span>│   ├── plan.md            # 实现计划总览（PM 视角）</span></span>
+<span class="line"><span>│   ├── tasks/task-01.md   # 任务蓝图（工程师视角，详细到可直接执行）</span></span>
+<span class="line"><span>│   ├── tasks/task-02.md</span></span>
+<span class="line"><span>│   └── ...</span></span>
+<span class="line"><span>├── docs/&lt;project&gt;/scan/</span></span>
+<span class="line"><span>│   ├── CONVENTIONS.md     # 代码规范</span></span>
+<span class="line"><span>│   └── ARCHITECTURE.md    # 架构文档</span></span>
+<span class="line"><span>├── projects/*.yaml        # 项目配置</span></span>
+<span class="line"><span>├── local.yaml             # 本地配置（构建/测试命令）</span></span>
+<span class="line"><span>└── knowledge/             # 项目知识库</span></span></code></pre></div><h3 id="reverse-sync" tabindex="-1">Reverse Sync <a class="header-anchor" href="#reverse-sync" aria-label="Permalink to &quot;Reverse Sync&quot;">​</a></h3><p>发现 Bug 时的处理流程：</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>发现 Bug → 是代码错了还是文档有遗漏？</span></span>
+<span class="line"><span>├── 文档遗漏 → 先修文档 → 再修代码</span></span>
+<span class="line"><span>└── 代码错误 → 直接修代码</span></span></code></pre></div><h2 id="上下文分层加载" tabindex="-1">上下文分层加载 <a class="header-anchor" href="#上下文分层加载" aria-label="Permalink to &quot;上下文分层加载&quot;">​</a></h2><p>execute 阶段按优先级管理上下文：</p><ul><li>🔥 <strong>热上下文</strong>：design.md 编码铁律 + 当前 Wave 任务（必须加载）</li><li>🌡️ <strong>温上下文</strong>：CONVENTIONS.md + ARCHITECTURE.md（需要时加载）</li><li>❄️ <strong>冷上下文</strong>：其他变更的 design.md、历史 plan.md（不主动加载）</li></ul><h2 id="进度管理" tabindex="-1">进度管理 <a class="header-anchor" href="#进度管理" aria-label="Permalink to &quot;进度管理&quot;">​</a></h2><h3 id="progress-json-唯一进度数据源" tabindex="-1">progress.json（唯一进度数据源） <a class="header-anchor" href="#progress-json-唯一进度数据源" aria-label="Permalink to &quot;progress.json（唯一进度数据源）&quot;">​</a></h3><p>位于 <code>.sillyspec/.runtime/progress.json</code>，由 <code>sillyspec run</code> CLI 自动管理：</p><div class="language-json vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">json</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">{</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;project&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;my-app&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;currentStage&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;execute&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">  &quot;stages&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: {</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    &quot;scan&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">&quot;status&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;completed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    &quot;brainstorm&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">&quot;status&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;completed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    &quot;plan&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">&quot;status&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;completed&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
+<span class="line"><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">    &quot;execute&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: { </span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">&quot;status&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;in_progress&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">  }</span></span>
+<span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">}</span></span></code></pre></div><h3 id="批量进度" tabindex="-1">批量进度 <a class="header-anchor" href="#批量进度" aria-label="Permalink to &quot;批量进度&quot;">​</a></h3><p>批量任务时，额外展示批量进度条：</p><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>📊 批量进度: ████████████████░░░░ 73/100 (2 失败, 1 跳过)</span></span></code></pre></div><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> batch</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --total</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 100</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --completed</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> 73</span></span>
+<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">sillyspec</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> progress</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> batch</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --status</span></span></code></pre></div><h2 id="git-规范" tabindex="-1">Git 规范 <a class="header-anchor" href="#git-规范" aria-label="Permalink to &quot;Git 规范&quot;">​</a></h2><ul><li>所有阶段只执行 <code>git add</code>，<strong>不自动 commit</strong></li><li>提交由用户通过 <code>/sillyspec:commit</code> 或手动完成</li><li>commit message 语言与用户对话语言一致</li></ul><h2 id="中断恢复" tabindex="-1">中断恢复 <a class="header-anchor" href="#中断恢复" aria-label="Permalink to &quot;中断恢复&quot;">​</a></h2><p>工作中断时，使用 resume 恢复：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:resume</span></span></code></pre></div><p>也可以用 continue 自动判断下一步：</p><div class="language-bash vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">/sillyspec:continue</span></span></code></pre></div>`,43)])])}const u=a(n,[["render",l]]);export{k as __pageData,u as default};

package/docs/.vitepress/dist/assets/sillyspec_lifecycle.md.DY293cR1.lean.js

@@ -0,0 +1 @@
+import{_ as a,o as i,c as t,ae as e}from"./chunks/framework.Czhw_PXq.js";const k=JSON.parse('{"title":"生命周期","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/lifecycle.md","filePath":"sillyspec/lifecycle.md"}'),n={name:"sillyspec/lifecycle.md"};function l(p,s,h,o,d,r){return i(),t("div",null,[...s[0]||(s[0]=[e("",43)])])}const u=a(n,[["render",l]]);export{k as __pageData,u as default};

package/docs/.vitepress/dist/assets/sillyspec_structure.md.sVYS4zPs.js

@@ -0,0 +1,30 @@
+import{_ as a,o as n,c as t,ae as p}from"./chunks/framework.Czhw_PXq.js";const m=JSON.parse('{"title":"目录结构","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/structure.md","filePath":"sillyspec/structure.md"}'),e={name:"sillyspec/structure.md"};function l(i,s,d,r,c,o){return n(),t("div",null,[...s[0]||(s[0]=[p(`<h1 id="目录结构" tabindex="-1">目录结构 <a class="header-anchor" href="#目录结构" aria-label="Permalink to &quot;目录结构&quot;">​</a></h1><h2 id="sillyspec-完整结构" tabindex="-1">.sillyspec/ 完整结构 <a class="header-anchor" href="#sillyspec-完整结构" aria-label="Permalink to &quot;.sillyspec/ 完整结构&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>.sillyspec/</span></span>
+<span class="line"><span>├── changes/              ← 所有变更（design/proposal/tasks/requirements）</span></span>
+<span class="line"><span>│   └── &lt;change-name&gt;/</span></span>
+<span class="line"><span>│       ├── design.md          # 设计文档（架构决策、文件变更清单）</span></span>
+<span class="line"><span>│       ├── proposal.md        # 变更提案（动机、范围、成功标准）</span></span>
+<span class="line"><span>│       ├── requirements.md    # 需求文档（功能需求、用户场景）</span></span>
+<span class="line"><span>│       ├── plan.md            # 实现计划总览（PM 视角，任务列表 + Wave 划分）</span></span>
+<span class="line"><span>│       └── tasks/             # 任务蓝图目录</span></span>
+<span class="line"><span>│           ├── task-01.md     # 独立任务蓝图（接口定义、边界处理、TDD 步骤、验收标准）</span></span>
+<span class="line"><span>│           ├── task-02.md</span></span>
+<span class="line"><span>│           └── ...</span></span>
+<span class="line"><span>├── docs/                 ← 统一文档中心</span></span>
+<span class="line"><span>│   └── &lt;project&gt;/</span></span>
+<span class="line"><span>│       └── scan/         ← 代码扫描结果</span></span>
+<span class="line"><span>│           ├── CONVENTIONS.md   # 代码规范</span></span>
+<span class="line"><span>│           └── ARCHITECTURE.md  # 架构文档</span></span>
+<span class="line"><span>├── knowledge/            ← 知识库（归档沉淀）</span></span>
+<span class="line"><span>│   ├── INDEX.md          # 知识索引</span></span>
+<span class="line"><span>│   └── uncategorized.md  # 未分类知识</span></span>
+<span class="line"><span>├── projects/             ← 子项目注册（*.yaml）</span></span>
+<span class="line"><span>├── local.yaml            ← 本地配置（构建命令、测试命令、环境变量）</span></span>
+<span class="line"><span>└── .runtime/             ← 运行时数据</span></span>
+<span class="line"><span>    ├── progress.json     ← 唯一进度数据源</span></span>
+<span class="line"><span>    ├── artifacts/        ← 步骤输出完整内容</span></span>
+<span class="line"><span>    ├── logs/             ← 日志</span></span>
+<span class="line"><span>    └── history/          ← 历史快照</span></span></code></pre></div><h2 id="文档层级" tabindex="-1">文档层级 <a class="header-anchor" href="#文档层级" aria-label="Permalink to &quot;文档层级&quot;">​</a></h2><table tabindex="0"><thead><tr><th>文档</th><th>谁写</th><th>回答什么</th><th>详细程度</th></tr></thead><tbody><tr><td>design.md</td><td>brainstorm（架构师）</td><td>为什么这么设计？架构长什么样？</td><td>中</td></tr><tr><td>plan.md</td><td>plan（项目经理）</td><td>做哪些任务？什么顺序？</td><td>低（总览）</td></tr><tr><td>task-N.md</td><td>plan（项目经理）</td><td>这个任务具体怎么做？</td><td>高（蓝图级）</td></tr><tr><td>CONVENTIONS.md</td><td>scan</td><td>代码怎么写？风格、命名、模式？</td><td>高</td></tr><tr><td>local.yaml</td><td>用户</td><td>构建命令、测试命令、环境变量</td><td>配置</td></tr></tbody></table><h2 id="产出时机" tabindex="-1">产出时机 <a class="header-anchor" href="#产出时机" aria-label="Permalink to &quot;产出时机&quot;">​</a></h2><div class="language- vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang"></span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span>brainstorm → design.md + proposal.md + requirements.md + tasks.md</span></span>
+<span class="line"><span>plan       → plan.md + tasks/task-NN.md</span></span>
+<span class="line"><span>execute    → 代码 + 勾选 task-N.md 验收标准</span></span>
+<span class="line"><span>verify     → 对照 design.md + 检查 task-N.md 验收 + 测试</span></span>
+<span class="line"><span>archive    → 沉淀到 knowledge/</span></span></code></pre></div><h2 id="说明" tabindex="-1">说明 <a class="header-anchor" href="#说明" aria-label="Permalink to &quot;说明&quot;">​</a></h2><ul><li><strong>changes/</strong> — 所有变更规范统一存放</li><li><strong>tasks/</strong> — 每个任务独立蓝图，execute 子代理只读自己的蓝图就能干活</li><li><strong>projects/</strong> — 管理多个子项目</li><li><strong>docs/</strong> — 文档中心，主要存放代码扫描结果</li><li><strong>knowledge/</strong> — 归档沉淀的可复用知识</li><li><strong>local.yaml</strong> — 项目特有的构建/测试命令，所有阶段都会读取</li><li><strong>.runtime/</strong> — 运行时数据，progress.json 是唯一进度数据源</li></ul>`,9)])])}const g=a(e,[["render",l]]);export{m as __pageData,g as default};

package/docs/.vitepress/dist/assets/sillyspec_structure.md.sVYS4zPs.lean.js

@@ -0,0 +1 @@
+import{_ as a,o as n,c as t,ae as p}from"./chunks/framework.Czhw_PXq.js";const m=JSON.parse('{"title":"目录结构","description":"","frontmatter":{},"headers":[],"relativePath":"sillyspec/structure.md","filePath":"sillyspec/structure.md"}'),e={name:"sillyspec/structure.md"};function l(i,s,d,r,c,o){return n(),t("div",null,[...s[0]||(s[0]=[p("",9)])])}const g=a(e,[["render",l]]);export{m as __pageData,g as default};