Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion .Knowledge/topics/flow2spec-dsh-adapter.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
id: flow2spec-dsh-adapter
revision: 0
revision: 1
summary: "DeepSeek Harness 项目级技能初始化与目录适配"
primary: feature
confidence: inferred
Expand All @@ -25,3 +25,8 @@ tags: [module]
- 初始化适配:`lib/init.js`、`lib/dshAgentsAdapter.js`
- 诊断与回归:`lib/doctor.js`、`scripts/test-dsh-init.js`
- 用户文档:`docs/使用说明.md`、`docs/en/usage-guide.md`、`docs/目录与路径约定.md`

## 对外宣传口径

- 宣传文案使用‘AI 开发工具’、‘已支持客户端’等可扩展表述,不写固定客户端数量或名单。
- 命令参数、兼容性矩阵和配置路径说明需要精确指导时,可以列出具体客户端。
2 changes: 1 addition & 1 deletion website/src/layouts/Layout.astro
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ interface Props {
lang?: 'zh-CN' | 'en';
}

const { title = 'Flow2Spec — 给 AI 一份可路由的项目事实', description = 'Flow2Spec 为 Cursor、Claude Code 与 Codex 建立文档驱动、可写回知识库的协作骨架。', lang = 'zh-CN' } = Astro.props;
const { title = 'Flow2Spec — 给 AI 一份可路由的项目事实', description = 'Flow2Spec 为 AI 开发工具建立文档驱动、可写回知识库的协作骨架。', lang = 'zh-CN' } = Astro.props;
const canonical = new URL(Astro.url.pathname, Astro.site ?? 'https://double-coding-lab.github.io');
const base = `${import.meta.env.BASE_URL.replace(/\/$/, '')}/`;
---
Expand Down
6 changes: 3 additions & 3 deletions website/src/pages/en/index.astro
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@ const sections = [
{ href: '#docs', label: 'Documentation' }
];
---
<Layout lang="en" title="Flow2Spec — Give AI the project facts it needs" description="Flow2Spec gives Cursor, Claude Code and Codex a routable, documented knowledge layer for software teams.">
<Layout lang="en" title="Flow2Spec — Give AI the project facts it needs" description="Flow2Spec gives AI development tools a routable, documented knowledge layer for software teams.">
<Header english />
<main class="home-main">
<section class="hero" id="top"><div class="hero-inner"><div class="hero-copy"><p class="eyebrow"><span class="eyebrow-dot"></span>AI coding context, made routable</p><h1>Give AI the<br /><em>project facts</em> it needs.</h1><p class="hero-lead">Flow2Spec gives Cursor, Claude Code and Codex a documented collaboration layer. Route each request to the facts that matter, then start changing code.</p><div class="hero-actions"><a class="button button-primary" href="#quick-start">Get started <span aria-hidden="true">↓</span></a><a class="button button-outline" href="https://github.com/double-coding-lab/Flow2Spec" target="_blank" rel="noreferrer">View on GitHub <span aria-hidden="true">↗</span></a></div><button class="install-command" type="button" data-copy="npx @double-coding/flow2spec@latest init"><code>npx @double-coding/flow2spec@latest init</code><span data-copy-label>Copy</span></button></div><div class="hero-art" aria-label="Flow2Spec knowledge routing illustration"><div class="art-sun"></div><div class="art-window"><div class="window-bar"><span></span><span></span><span></span><b>project facts</b></div><div class="window-body"><div class="code-line wide"></div><div class="code-line short"></div><div class="code-line medium"></div><div class="code-line accent"></div><div class="code-line wide"></div><div class="code-line short"></div></div></div><div class="art-card card-route"><span class="card-icon">↗</span><b>route hit</b><small>4 topics · 300 lines</small></div><div class="art-card card-fact"><span class="card-icon">✓</span><b>verified fact</b><small>Redis lock · TTL 10 min</small></div><div class="art-sticker">less rediscovery<br />more building</div></div></div></section>
<section class="hero" id="top"><div class="hero-inner"><div class="hero-copy"><p class="eyebrow"><span class="eyebrow-dot"></span>AI coding context, made routable</p><h1>Give AI the<br /><em>project facts</em> it needs.</h1><p class="hero-lead">Flow2Spec gives AI development tools a documented collaboration layer. Route each request to the facts that matter, then start changing code.</p><div class="hero-actions"><a class="button button-primary" href="#quick-start">Get started <span aria-hidden="true">↓</span></a><a class="button button-outline" href="https://github.com/double-coding-lab/Flow2Spec" target="_blank" rel="noreferrer">View on GitHub <span aria-hidden="true">↗</span></a></div><button class="install-command" type="button" data-copy="npx @double-coding/flow2spec@latest init"><code>npx @double-coding/flow2spec@latest init</code><span data-copy-label>Copy</span></button></div><div class="hero-art" aria-label="Flow2Spec knowledge routing illustration"><div class="art-sun"></div><div class="art-window"><div class="window-bar"><span></span><span></span><span></span><b>project facts</b></div><div class="window-body"><div class="code-line wide"></div><div class="code-line short"></div><div class="code-line medium"></div><div class="code-line accent"></div><div class="code-line wide"></div><div class="code-line short"></div></div></div><div class="art-card card-route"><span class="card-icon">↗</span><b>route hit</b><small>4 topics · 300 lines</small></div><div class="art-card card-fact"><span class="card-icon">✓</span><b>verified fact</b><small>Redis lock · TTL 10 min</small></div><div class="art-sticker">less rediscovery<br />more building</div></div></div></section>
<div class="site-shell home-content-shell">
<SectionNav items={sections} label="Page sections" />
<div class="home-content">
Expand All @@ -27,7 +27,7 @@ const sections = [
<section class="routing-section section-pad" id="workflow"><div class="section-intro"><p class="eyebrow">Progressive routing</p><h2>From one sentence to<br /><em>the context you can verify.</em></h2><p>Don't pour the repository into the model. Match, expand dependencies, and read only the facts relevant to this request.</p></div><FlowDiagram english /><div class="routing-callout"><span class="callout-mark">✦</span><p><strong>More context isn't always better.</strong><br />It should be just enough, and useful again tomorrow.</p></div></section>
<section class="loop-section section-pad" id="development-loop"><div class="loop-copy"><p class="eyebrow">A living development loop</p><h2>Every delivery makes<br /><em>the next one faster.</em></h2><p>The knowledge base grows through real development: verified, revised, and accurately routed into the next request.</p><ol class="loop-list"><li><span>01</span><div><b>Describe the request</b><small>Say what needs to change in natural language.</small></div></li><li><span>02</span><div><b>Read relevant facts</b><small>Route topics, expand dependencies, fill gaps.</small></div></li><li><span>03</span><div><b>Build and write back</b><small>Code and knowledge close in the same workflow.</small></div></li></ol></div><div class="loop-visual"><img src={`${base}images/knowledge-loop.jpg`} alt="Flow2Spec development knowledge loop" /></div></section>
<section class="team-section section-pad" id="collaboration"><div class="team-art"><div class="team-person person-one">LC</div><div class="team-person person-two">Q7</div><div class="team-thread"><span>shared knowledge</span><b>topic revision +1</b><small>reviewed and merged</small></div></div><div class="team-copy"><p class="eyebrow">Built for shared repositories</p><h2>Two people.<br /><em>One knowledge base.</em></h2><p>Progress stays local to each developer. Confirmed project facts live in shared `.Knowledge/`, so personal todos never become product knowledge.</p><a class="text-link" href={`${base}en/docs/collaboration/`}>Explore team collaboration <span aria-hidden="true">→</span></a></div></section>
<section class="quick-section section-pad" id="quick-start"><div class="quick-heading"><div><p class="eyebrow">A calmer first run</p><h2>Three minutes to<br /><em>give your project a clear path.</em></h2></div><p class="quick-summary">You do not need a complete knowledge base first. Initialize, route one real request, and leave behind the first verified fact.</p></div><div class="quick-steps"><article class="quick-step"><div class="quick-step-top"><span>01</span><small>Write the collaboration skeleton</small></div><h3>Initialize</h3><code class="quick-command">npx @double-coding/flow2spec@latest init</code><p>Write the knowledge base, rules and Cursor, Claude Code and Codex entrypoints into the project.</p><div class="quick-output"><span>You get</span><b>.Knowledge/ · AGENTS.md</b></div></article><article class="quick-step"><div class="quick-step-top"><span>02</span><small>Put a request on the route</small></div><h3>Describe your first request</h3><div class="quick-example">“Add pagination to order search; route me to the relevant facts first.”</div><p>Start with a real module or change. Build topic facts as they become relevant instead of writing everything up front.</p><div class="quick-output"><span>You get</span><b>Matched topics · filled context</b></div></article><article class="quick-step"><div class="quick-step-top"><span>03</span><small>Leave the result behind</small></div><h3>Verify and keep delivering</h3><div class="quick-status"><span class="quick-status-mark" aria-hidden="true">✓</span><div><b>Facts verified</b><small>Ready for the next request</small></div></div><p>Confirm the routes, topics and revisions are healthy, then turn this verified fact into a shortcut for the next request.</p><div class="quick-output"><span>You get</span><b>Reusable project memory</b></div></article></div></section>
<section class="quick-section section-pad" id="quick-start"><div class="quick-heading"><div><p class="eyebrow">A calmer first run</p><h2>Three minutes to<br /><em>give your project a clear path.</em></h2></div><p class="quick-summary">You do not need a complete knowledge base first. Initialize, route one real request, and leave behind the first verified fact.</p></div><div class="quick-steps"><article class="quick-step"><div class="quick-step-top"><span>01</span><small>Write the collaboration skeleton</small></div><h3>Initialize</h3><code class="quick-command">npx @double-coding/flow2spec@latest init</code><p>Write the knowledge base, rules and supported tool entrypoints into the project.</p><div class="quick-output"><span>You get</span><b>.Knowledge/ · AGENTS.md</b></div></article><article class="quick-step"><div class="quick-step-top"><span>02</span><small>Put a request on the route</small></div><h3>Describe your first request</h3><div class="quick-example">“Add pagination to order search; route me to the relevant facts first.”</div><p>Start with a real module or change. Build topic facts as they become relevant instead of writing everything up front.</p><div class="quick-output"><span>You get</span><b>Matched topics · filled context</b></div></article><article class="quick-step"><div class="quick-step-top"><span>03</span><small>Leave the result behind</small></div><h3>Verify and keep delivering</h3><div class="quick-status"><span class="quick-status-mark" aria-hidden="true">✓</span><div><b>Facts verified</b><small>Ready for the next request</small></div></div><p>Confirm the routes, topics and revisions are healthy, then turn this verified fact into a shortcut for the next request.</p><div class="quick-output"><span>You get</span><b>Reusable project memory</b></div></article></div></section>
<section class="docs-section section-pad" id="docs"><div class="docs-heading"><p class="eyebrow">Keep exploring</p><h2>Start here, then<br /><em>go at your own pace.</em></h2><p>From installation to collaboration, choose what to explore next.</p></div><div class="docs-grid"><a href={`${base}en/docs/usage/`}><b>Usage guide</b><span>From install to daily development</span><i>→</i></a><a href={`${base}en/docs/commands/`}><b>Commands</b><span>CLI and skill entrypoints</span><i>→</i></a><a href={`${base}en/docs/architecture/`}><b>Architecture</b><span>Routing and knowledge model</span><i>→</i></a><a href="https://www.npmjs.com/package/@double-coding/flow2spec" target="_blank" rel="noreferrer"><b>npm package</b><span>Install the latest version</span><i>↗</i></a></div></section>
<footer class="site-footer"><div class="footer-brand"><img class="brand-mark" src={`${base}favicon.svg`} alt="" aria-hidden="true" /><strong>Flow2Spec</strong><p>Project facts, routed before code.</p></div><div class="footer-links"><a href="https://github.com/double-coding-lab/Flow2Spec" target="_blank" rel="noreferrer">GitHub ↗</a><a href="https://www.npmjs.com/package/@double-coding/flow2spec" target="_blank" rel="noreferrer">npm ↗</a></div><small>© 2026 Double Coding Lab</small></footer>
</div>
Expand Down
2 changes: 1 addition & 1 deletion website/src/pages/index.astro
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ const sections = [
<div class="hero-copy">
<p class="eyebrow"><span class="eyebrow-dot"></span>AI coding context, made routable</p>
<h1>给 AI 一份<br /><em>真正有用的</em>项目事实。</h1>
<p class="hero-lead">Flow2Spec 为 Cursor、Claude Code 与 Codex 建立文档驱动的协作骨架。每次动手写代码前,先把请求路由到最相关的知识,再开始改变。</p>
<p class="hero-lead">Flow2Spec 为 AI 开发工具建立文档驱动的协作骨架。每次动手写代码前,先把请求路由到最相关的知识,再开始改变。</p>
<div class="hero-actions">
<a class="button button-primary" href="#quick-start">开始使用 <span aria-hidden="true">↓</span></a>
<a class="button button-outline" href="https://github.com/double-coding-lab/Flow2Spec" target="_blank" rel="noreferrer">查看 GitHub <span aria-hidden="true">↗</span></a>
Expand Down
Loading