-
Notifications
You must be signed in to change notification settings - Fork 2
FAQ
ai-coding-ok 常见问题，按主题分组。
不需要。Skill 是 Claude Code 的原生能力，免费版也支持。Copilot 用户只需 Copilot 订阅。ai-coding-ok 完全免费（MIT 许可证）。
| 工具 | 方式 | PDCA 强度 |
|---|---|---|
| Cursor |
.cursor/rules/ai-coding-ok.mdc（alwaysApply） |
🛡️🛡️🛡️ |
| Continue | 在 rules 配置中引用 AGENTS.md
|
🛡️🛡️ |
| Cline | 在 rules 配置中引用 AGENTS.md
|
🛡️🛡️ |
记忆文件是纯 Markdown，任何 AI 工具都能读取。
python install.py --copilot --target C:\your-project或使用 Git Bash 运行 install.sh。
不会。安装程序检测冲突并提供三个选项：
- 覆盖（有风险）
- 只复制缺失的文件（安全，推荐）
- 取消
绝不静默覆盖已有文件。
三个记忆文件加起来通常 <10KB，在 AI 上下文窗口中可以忽略。不读记忆的代价（错误决策、破坏已有功能）远高于读记忆的成本。
不会。约定保留最近 30 条。旧条目归档到 docs/task-history-archive-YYYY-QN.md。AI 的系统提示中有自动归档指令。
通常不用。AI 在每次任务的 Act 阶段自动更新 task-history.md。你应该：
- 偶尔审查 AI 写的条目是否准确
- 重大架构决策时手动写 ADR
- 每月扫描
project-memory.md清理过时信息
Claude Code 中 Stop hook（v4.1.0+）阻断未更新记忆的会话结束。Copilot/Cursor 中强制 ## 记忆更新 输出章节（v3.0.1+）确保 AI 无法跳过。
如果仍然发生，手动提醒：
执行 Act 阶段：将本次任务摘要写入 task-history.md。
Claude Code： 在项目中输入 upgrade ai-coding-ok。
Copilot/Cursor： 将 scripts/upgrade-prompt.md 粘贴到 AI 工具的聊天中。
升级保留所有项目定制。详见升级 ai-coding-ok。
不会。升级系统按章节级别 diff，只应用框架变更。你的项目名、技术栈、架构图、自定义 ADR 和约束全部保留。
head -1 AGENTS.md
# → <!-- ai-coding-ok: v4.1.0 -->v3.0.0 引入插件打包和双语模板。v4.1.0 新增五层防御体系和 Claude Code hooks——自 v2.0 以来最重大的可靠性提升。
详见版本管理。
不会。它们解决不同问题：
- superpowers = 会话内深度思考（头脑风暴、调研、多 agent）
- ai-coding-ok = 跨会话记忆（记住上下文、决策、任务历史）
它们完美组合。详见与 superpowers 组合。
可以。推荐两个都装，但如果只能学一个，先装 ai-coding-ok（记忆问题更紧迫）。
- Fork ai-coding-ok 仓库
- 编辑
templates/en/和templates/zh/中的文件（两者必须同步） - 如果行为变化，也编辑
skills/ai-coding-ok/SKILL.md - 提交 PR，描述改了什么和为什么
在 GitHub 上开 Issue。包含：
- ai-coding-ok 版本（
head -1 AGENTS.md） - AI 工具（Claude Code / Copilot / Cursor）
- 预期 vs 实际行为
- 错误信息
rm AGENTS.md CLAUDE.md
rm -rf .github/copilot-instructions.md .github/project-metadata.yml \
.github/PULL_REQUEST_TEMPLATE.md .github/ISSUE_TEMPLATE \
.github/workflows/ci.yml .github/workflows/memory-check.yml \
.github/agent
rm -rf .cursor/rules/ai-coding-ok.mdc或 git reset --hard HEAD~1（如果你 commit 了安装且没有其他改动）。
删除 .github/agent/memory/ 目录。其余规则（编码规范、工作流）仍然生效，但 PDCA 记忆循环不会触发。
恢复：重新安装或从 git 恢复目录。
不会。完全本地——项目中的 Markdown 文件和本地运行的 shell 脚本。无遥测、无 API 调用、无外部服务。
可以。MIT 许可证允许商业使用、私有仓库和修改。无需署名（尽管欢迎）。
- 故障排查 — 常见问题与修复
- GitHub Issues — 向社区提问
- 日常开发流程 — 实用使用指南
🧠 ai-coding-ok — AI 编程的 PDCA 记忆闭环。
GitHub · Issues · MIT License