| name | intent-story |
| description | Share your IDD adoption story. Through structured interviewing, create blog posts about Intent-Driven Development experiences, lessons learned, and best practices. Supports multiple languages and formats. |
Intent Story
通过采访式对话，帮助用户分享 IDD (Intent Driven Development) 的采用经验，生成传播 IDD 方法论的博客文章。
核心理念
- 采访式创作：AI 分析 + 提问 + 用户回答 + AI 按风格整合
- 真实故事：基于用户真实经验，不编造案例
- 传播 IDD：每篇文章都自然介绍 IDD 理念和工具
Workflow
/intent-story
↓
┌───────────────────────────────────┐
│ Phase 1: 背景分析 │
│ - 检测输入语言 │
│ - 加载写作风格（如有） │
│ - 了解用户 IDD 使用背景 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 2: 结构化采访 │
│ - 采用经历 │
│ - 关键转折/教训 │
│ - 具体收益/数据 │
│ - 建议和反思 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 3: 确认输出需求 │
│ - 文章格式/风格/长度 │
│ - 目标语言版本 │
└─────────────┬─────────────────────┘
↓
┌───────────────────────────────────┐
│ Phase 4: 生成文章 │
│ - 完整博客 + 社交媒体版 │
│ - 多语言版本（按需） │
│ - 自然融入 IDD 介绍 │
└───────────────────────────────────┘
Phase 1: 背景分析
语言检测
- 根据用户输入的主要语言确定初始写作语言
- 后续可询问是否需要其他语言版本
写作风格加载
按优先级加载（如存在）：
~/.claude/content-profile/writing-style.md（用户自定义）- 使用本技能默认风格
初始问题
使用 AskUserQuestion 了解背景：
question: "你是在什么类型的项目中使用 IDD 的？"
header: "项目类型"
options:
- label: "系统软件/框架"
description: "框架、库、基础设施等"
- label: "Web 应用"
description: "前端或全栈 Web 项目"
- label: "移动应用"
description: "iOS、Android 或跨平台"
- label: "其他"
description: "其他类型项目"
Phase 2: 结构化采访
采访维度
每轮 2-3 个问题，通常 3-5 轮完成。
1. 采用动机
"是什么让你开始尝试 IDD？"
- A) 文档总是过时，想找更好的方法
- B) AI 辅助开发需要更好的上下文管理
- C) 团队协作需要更清晰的设计契约
- D) 其他原因
2. 转折时刻
"使用 IDD 过程中，有没有一个'啊哈'时刻让你觉得值得？"
[开放式，收集故事]
3. 具体收益
"你观察到的最明显的改变是什么？"
- A) AI 代码质量提升（更少需要修改）
- B) 架构边界更清晰
- C) 文档不再过时
- D) 新人上手更快
- E) 其他
"能否量化一下收益？（可选）"
[开放式，如："AI 一次生成可用代码的比例从 30% 提升到 70%"]
4. 教训和挑战
"遇到过什么挑战或走过的弯路？"
[开放式]
"如果重新开始，你会有什么不同的做法？"
[开放式]
5. 给其他人的建议
"对考虑采用 IDD 的人，你有什么建议？"
[开放式]
采访原则
- 少问多推：能从上文推断的不重复问
- 故事优先：鼓励用户分享具体经历
- 真实性：不编造案例，用户没有的就不加
- 深度追问：对有价值的回答继续挖掘
Phase 3: 确认输出需求
采访完成后，确认输出格式：
文章风格
question: "这篇文章的风格？"
header: "风格"
options:
- label: "技术分享"
description: "peer-to-peer，工程师视角"
- label: "经验总结"
description: "回顾反思，Founder/Lead 视角"
- label: "入门指南"
description: "帮助新人理解和上手"
- label: "案例研究"
description: "详细的项目案例分析"
文章长度
question: "目标长度？"
header: "长度"
options:
- label: "短文 (800-1200字)"
description: "快速阅读，重点突出"
- label: "中等 (1500-2500字)"
description: "有深度的分享"
- label: "长文 (3000+字)"
description: "完整详细的案例分析"
语言版本
question: "需要生成哪些语言版本？"
header: "语言"
multiSelect: true
options:
- label: "中文"
description: "简体中文版本"
- label: "English"
description: "English version"
- label: "两者都要"
description: "中英双语"
Phase 4: 生成文章
文章结构
# [标题：吸引人的 IDD 经验标题]
[开头：核心洞察/结论，吸引读者]
## 背景/起因
[为什么开始使用 IDD]
## 关键发现/转折
[使用过程中的洞察和故事]
## 实际收益
[具体的改变和量化数据]
## 教训和建议
[给其他人的建议]
## 结语
[总结 + IDD 介绍]
---
## 关于 IDD
[IDD 简介和工具链，见下文模板]
IDD 介绍模板（必须包含）
每篇文章结尾自然融入：
---
## About IDD (Intent Driven Development)
IDD 是一种以 Intent（意图）为核心的开发方法论：
Intent → Test → Code → Sync
**核心理念**：Intent 是新的源代码。Code review 由 AI 完成，Intent review 由 Human 完成。
**工具链**：
- `/intent-assess` - 评估项目是否适合 IDD
- `/intent-init` - 初始化 IDD 结构
- `/intent-interview` - 从想法创建 Intent
- `/intent-check` - 验证代码与 Intent 一致性
**开始使用**：
```bash
npx add-skill arcblock/idd
了解更多：github.com/ArcBlock/idd
### 社交媒体版本
同时生成 Twitter/X 版本：
[核心洞察，1-2句]
[关键数据/收益]
[一句话 CTA]
🔗 [文章链接]
#IntentDrivenDevelopment #IDD #AIEngineering
### 写作风格指南
遵循以下原则（来自用户写作风格）：
| 原则 | 说明 |
|------|------|
| 观点鲜明 | 不做骑墙派，有明确立场 |
| 真实案例 | 故事来自用户，不编造 |
| 段落充实 | 每段 4-8 句，有完整论述 |
| 小标题精简 | 2-4 个小标题，内容丰富 |
| 内省式表达 | "我觉得..."而非"你应该..." |
| 避免套话 | 每个观点要有具体洞察支撑 |
| 禁用 em dash | 用 "-" 或 "," 替代 "—" |
## 输出示例
```markdown
# 从「文档总是过时」到「Intent 就是代码」- 我的 IDD 实践
半年前，我们团队面临一个经典困境：文档写得再好，三周后就过时...
[正文...]
---
## About IDD
IDD (Intent Driven Development) 是一种以意图为核心的开发方法论...
[工具链介绍...]
**开始使用**：
\`\`\`bash
git clone https://github.com/ArcBlock/idd
claude mcp add-plugin ~/path/to/idd
\`\`\`
与其他命令配合
[用户使用 IDD 一段时间]
↓
/intent-story # 分享经验，生成博客
↓
发布博客 / 社交媒体
↓
传播 IDD 方法论
注意事项
- 真实性：所有案例和数据必须来自用户，不能编造
- 自然融入：IDD 介绍要自然融入结尾，不是生硬广告
- 用户语言：主要语言跟随用户输入
- 风格一致：如有用户写作风格配置，优先使用
