Borrowing it
Nothing to install: this file belongs to xiaojilele-glitch/WhyBuddy. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/xiaojilele-glitch/WhyBuddy/main/.kiro/steering/implementation-guide.mdgit clone --depth 1 https://github.com/xiaojilele-glitch/WhyBuddyWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/xiaojilele-glitch/whybuddy/implementation-guide)<a href="https://agentmods.dev/instructions/xiaojilele-glitch/whybuddy/implementation-guide"><img src="https://agentmods.dev/badge/instructions/xiaojilele-glitch/whybuddy/implementation-guide/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/xiaojilele-glitch/whybuddy/implementation-guide"><img src="https://agentmods.dev/badge/instructions/xiaojilele-glitch/whybuddy/implementation-guide.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01774 | $0.01774 |
| Opus 5.5 | $0.00710 | $0.00710 |
| Sonnet 5.5 | $0.00355 | $0.00355 |
| Haiku 4.5 | $0.00177 | $0.00177 |
Grade A, and why
WhyBuddy implementation-guide.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 148 lines — stays where its author put it; the contents beside it link to each section on GitHub.
2026-04-15 Runtime Addendum
保留以下旧指南不变,新增当前实现约束:
- 不得再默认假设 Docker 必然存在。
- 涉及执行链路的功能要同时考虑
real、native、mock。 - 涉及 GitHub Pages 的功能不得写成 executor-backed 模式。
- 如果改动了运行时边界,必须同步检查 README、ROADMAP 和 steering 补充文档。
补充文档:
.kiro/steering/2026-04-15-runtime-current-state.md
模块实现指南
从 rbac-system-pc 的 90 个 AIGC 模块批量实现经验中提炼的方法论,适配 sliderule 当前“主线已落地、以增量补完 spec 为主”的实现阶段。
一、实现前检查清单(每个模块必须执行)
实现任何模块的第一步,对照下表检查该模块需要复用哪些已有能力。 禁止跳过此步骤,禁止重复实现已有能力。
共享契约检查表
| 检查项 | 条件 | 必须使用的契约 | 路径 |
|---|---|---|---|
| 是否涉及演示数据? | 模块需要预录数据 | DemoDataBundle schema |
shared/demo/contracts.ts |
| 是否涉及遥测/成本/恢复? | 模块读写系统状态 | 事件总线格式 + IDB store key | shared/telemetry/contracts.ts |
| 是否涉及记忆读写? | 模块访问记忆系统 | MemoryReader / MemoryWriter / MemoryIndex |
shared/memory/contracts.ts |
| 是否涉及 Mission 丰富化? | 模块扩展 MissionRecord | MissionEnrichmentFields |
shared/mission/enrichment.ts |
| 是否涉及跨框架导出? | 模块输出其他框架格式 | ExportRequest / ExportResult |
shared/export/contracts.ts |
已有核心模块复用检查表
| 检查项 | 条件 | 必须复用的模块 | 关键文件 |
|---|---|---|---|
| 是否需要工作流执行? | 模块触发十阶段管道 | WorkflowEngine | server/core/workflow-engine.ts |
| 是否需要动态组织? | 模块生成智能体团队 | DynamicOrganization | server/core/dynamic-organization.ts |
| 是否需要 Mission 状态机? | 模块管理任务生命周期 | MissionStore | server/tasks/mission-store.ts |
| 是否需要 LLM 调用? | 模块调用大模型 | LLMClient | server/core/llm-client.ts |
| 是否需要智能体调用? | 模块通过智能体执行 | AgentDirectory | server/core/registry.ts |
| 是否需要消息传递? | 模块涉及智能体间通信 | MessageBus | server/core/message-bus.ts |
| 是否需要工作空间访问? | 模块读写智能体文件 | AccessGuard | server/core/access-guard.ts |
| 是否需要浏览器端运行? | 模块支持 Frontend Mode | BrowserRuntime | client/src/runtime/browser-runtime.ts |
| 是否需要 Socket 推送? | 模块实时通知前端 | Socket.IO | server/core/socket.ts |
二、Autopilot 批量执行策略
在 autopilot 模式下批量推进实现时,遵循以下规则:
- 所有 tasks.md 中标记
*的可选任务(属性测试、集成测试)跳过不执行 - 所有 Checkpoint 任务(如 "Checkpoint - 确保所有测试通过")跳过不执行,直接标记为完成并继续下一个任务
- 仅执行代码实现任务(类型定义、核心逻辑、API 路由、前端组件等)
- 测试环节留待用户手动触发时再执行
- 每个模块完成后必须运行
npm run check;若仓库存在历史 TypeScript 存量错误,至少保证不新增错误,并在 steering/提交说明中记录差异
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 148 lines · 1,774 tokens per session scan A 73acb228b4aa
WhyBuddy implementation-guide.md is an instructions file published in the GitHub repository xiaojilele-glitch/WhyBuddy (380 stars, last pushed 1mo ago), licensed MIT. It adds 1,774 tokens to every session, about $0.0071 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-23.
WhyBuddy implementation-guide.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| WhyBuddy implementation-guide.mdxiaojilele-glitch/WhyBuddy | Instructions file | 380 | 1mo ago | MIT | A | 1,774 | Kiro |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 5,516 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | today | MIT | A | 4,680 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | today | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |